Chapter 7. Checking out a new tree

Abstract

How to check out a source tree from the CVS repository onto the local hard drive.

Modules in ReactOS' CVS Repository

There are several modules in ReactOS' CVS repository. Each of these modules contains a seperate tree of files. Whenever you check out a tree, you must specify which module you want. The following modules are available in our repository:

Table 7.1. Modules

Module NameDescription
freeldrFreeLoader: boot manager of choice for ReactOS
reactosReactOS: Source code of the ReactOS kernel, subsystems and drivers
rosappsReactOS Applications: Source code of various applications that will be bundled with ReactOS
rosdocsReactOS documentation: at the moment a set of DocBook XML files
wineWINE Port: code ported from the WINE project

Checking out a tree (module)

First go to the directory that you want to check the tree out into. Then issue the command

cvs -z 9 checkout module
(where module is the name of one of the modules mentioned above). The "-z 9" switch is to use maximum compression to shorten download time. You might also notice that each directory checked out by cvs contains a subdirectory names "cvs". These subdirectory should not removed as they contain important CVS user and versioning information. You will not be able to properly update your tree if you remove one of these "cvs" subdirectories.

Examples

To check out the "reactos" module, we will first create a "ros" directory that will contain all modules from the repository and then do the check out:

C:\>md ros
C:\>cd ros
C:\ROS>cvs -z 9 checkout reactos

Updating your tree

The next section "Updating your tree with the latest code" will explain how to use the "update" CVS command to update your tree with the latest changes. You should only have to check out a tree once and perform updates on the tree after that. If you encounter abnormalities with your tree in the future, however, you may wish to delete it and do a checkout again (this should be a rare occurance).