ViewVC tutorial

Structure of the repository	Structure of the code release
Each code folder in the repository is comprised of three subfolders: trunk, branches, and tags. This is because most of the codes in the repository are under development and updates are being checked in. The trunk is the place where the most recent version of the code is. Typically, the most recent means that it is not fully tested, verified, and/or validated. Take this version on your own risk. Sometimes, there are several versions of the development codes, when several developers are independently developing new features. These "alternative" versions are in the branches folder. Unless you are in touch with the developers, or you want to see in what direction the new development goes, please avoid these folders. Released, tested, and documented codes are in the tags folder (in SVN lingo, codes tagged for a release). Download the codes form this folder. You select and open a folder by clicking on its name.	Each subfolder in the code folder (trunk, all branches in the in the branches folder, and all releases in the tags folder) contain a README.txt file and three folders: doc, examples, and src. README.txt provides a description of the code including the description of the code folder contents. The doc folder is comprised of all available documentation of the code necessary to install and run the code as well as technical reports explaining the code. The examples folder contain a few example datasets that can be used to test the code after the installation. The src folder is the repository of the source code.
Folder contents	File page
The most convenient way to download the complete code is to click on "Download GNU tarball" link, which can be found at the bottom of each page displaying a folder (use gunzip followed by tar -xvf <filename> (the name of the file resulting from gunzip) on linux or other Unix flavors; most of the Windows zip utilities will uncompress the downloaded tarball automatically).	To view or download a single file, click on the filename on the page displaying the folder contents to get to the file page. On this page click on view, download, or annotate link, to view, download or annotate the selected file, respectively. These links are available for each revision of the file, starting with the most recent one (on the top of the page) annotated as the HEAD. You can also examine the revision history of the file (use the revision log link on the top of the page). Finally, you can compare different revisions using the widgets at the bottom of the page.

For more detailed instructions, please refer to the ViewVC help (also available form each code repository page (bottom right). Back to the code repository home