CVS howto's, tips and tricks

Here are some tips for people joining the Nucleus Core team on SourceForge with no knowledge about CVS. It is not difficult to commit improvements to the core.

Here's a small “howto make a commit”. Feel free to improve it.

• Download the current repository. On the command line, type:

cvs -z3 -d:ext:*****@cvs.sourceforge.net:/cvsroot/nucleuscms co -P nucleus

→ Change * by your SourceForge login. You'll be asked your password. Type it and the repository will be downloaded.

• After you've done some work on a file, commit it (“send it to SourceForge”) using the following command:

cvs -z3 -d:ext:rodrigomoraes@cvs.sourceforge.net:/cvsroot/nucleuscms commit nucleus/install.sql

→ In this example I've committed install.sql, and the path (nucleus/) is relative to the directory I was browsing in the command line in that moment.

• You'll be asked to add some comments to the new file version. Write a small description and save (ctrl+w). Then exit with ctrl+o. The file will be committed.

• Go back to step 1 on the next times to grab the updated files.

• Done. You don't need to know anything else to commit files to the core.

1. Install TortoiseCVS
2. Download PuTTY and PuTTYgen
3. Create a SSH key using PuTTYgen (instructions)
4. For developers with CVS access: Configure TortoiseCVS for Developer SSH Authentication (instructions).
5. For users: select pserver as authentication method and type 'anonymoues' as username
   • Some notes:
   1. create a folder for your repository
   2. right click on the folder and select “CVS checkout”
   3. the final setting for the CVSROOT option should be something like:
      • For developers with CVS access: :ext:your_sourceforge_user_name@cvs.sourceforge.net:/cvsroot/nucleuscms
      • For users: :pserver:anonymous@cvs.sourceforge.net:/cvsroot/nucleuscms
6. Type the module name, 'nucleus' (without quotes)
7. Press 'ok' and you'll do the checkout

→ detailed instructions on how to use TortoiseCVS on SourceForge are here: http://sourceforge.net/docs/F04/en/