Kapitel 16. CVS and more.groupware development

Inhaltsverzeichnis

Accessing CVS as a developer
CVS/SSH for unix/linux users
CVS/SSH for windows users (using wincvs)
Branching in CVS
more.groupware structure in CVS

more.groupware is developed by many different developers being located at different places. To make the source code available and manageable, we (like many others) use CVS (Concurrent Versions System, http://www.cvshome.org/ ). This chapter should introduce you to the most basic issues on this.

Accessing CVS as a developer

If you want to contribute actively, including direct write access to the CVS repository, you need to have a sourceforge.net account. As soon as we have made you a project member, you can then access the CVS repository. This is described in detail over at sourceforge.net .But here is a short summary for the impatient.

CVS/SSH for unix/linux users

You need to have CVS and SSH installed for this to work. Use your username and password for your sourceforge.net account in the appropriate places.

export CVS_RSH=ssh
      cvs -d:ext:user@cvs.moregroupware.sourceforge.net:/cvsroot/moregroupware co mgw
    

All other actions can later be done inside the created directory, without the need for giving the -d option all the time. Remember to set the CVS_RSH variable all the time (e.g. put it in your startup scripts).

CVS/SSH for windows users (using wincvs)

Use your username and password for your sf.net account in the appropriate places.

  1. Download WinCVS 1.2 Stable from http://www.wincvs.org/ and install it.

  2. Install a command line SSH/Win32 client. Use e. g. Alltheweb ftp to find the SSH/Win32 client. Download it and unpack it into a folder in your path (e.g. c:\windows). You can use this link to do the search directly: http://www.alltheweb.com/search?cat=ftp&cs=utf-8&ftype=4&q=ssh-1.2.14-win32bin.zip .

  3. To check out the sources now start WinCVS and

    1. go to Menu: Admin/Preferences

    2. set CVSROOT to :ext:user@cvs.moregroupware.sourceforge.net:/cvsroot/moregroupware

    3. set Authentication to SSH server

    4. go to menu: Create/Checkout module...

    5. set the module Name to mgw

    6. select folder you want to have the files in locally

Committing changes is as easy:

  1. Do the updates you want to the MGW file.

  2. Start WinCVS and use the inbuilt file browsing possibilities to find the file you will commit.

  3. Mark the file and choose Modify - Commit Selection to commit it. You should enter a log message to tell other people what you have done.

  4. Choose OK and write in your SF.net password followed by enter in the dos ssh window which pops up.

  5. The file will be submitted and you should get code 0 in the status field if everything went well.