Project Source code

Browsing a project's source code repository with ViewCVS

Before beginning work in a project, you should take time to learn how the project files are organized. You will want to become familiar with the directory structures as well as any CVS "modules" that have been defined by project members.

  1. From your Project Home page, click on Source code on the left navigation bar.
  2. Click on "Browse source code" to access the project's source repository through ViewCVS.

Each project's web content files are located in the myproject/www module by default. Each project has two predefined modules: www and look. Other project source modules are created and organized by project owner or project members with CVS write permissions. If browsing deleted and removed project files is permitted, an "Attic/" module is displayed.

Getting your working copy of project source code

To obtain (or "check out") your own working copy of project files, step-by-step instructions are included on the Project Source page for both command line CVS and WinCvs. These instructions also show the exact cvsroot to set for the current project. The cvsroot points to the server location of the project's source code.

A working copy refers to the replicated set of project source code you maintain and modify on your own local machine. If you are new to CVS, this is an important CVS concept to understand. These files reside in your workspace, and the CVS server does not track or know anything about your changes (or other developers' changes) until you commit modified files or add newly created files back into the main project repository.

This may be different from other versioning systems which explicitly track creation of workspaces. With CVS, you can check out working copies as many times as necessary. Keep in mind, however, that files in the project repository continually change over time as to reflect other developer contributions as the project progresses. It's critical to keep your working copies of files up to date with the repository.

CVS client downloads

You can download CVS clients for command line, Windows, or Mac and other developer tools at http://www.collab.net/developers/tools/.