In this section, we discuss how you put a new project into the CVS repository. If you just want to work with an existing project which is already in a repository, you may skip this section.
In Figure 1-1 you can see the dialog which helps you to import a project as a module. After you have filled out this form and confirmed by OK, the following CVS command is used:
cvs -d repository import -m "" module vendortag releasetag |
Repository. The name of the CVS repository, also known as $CVSROOT. You must have write access to it and the repository must be properly initialized. If the repository does not yet exist, initialize it with the command %cvs -d repository init. If the repository is remote, make sure that authentication works, see Section 1.1.
Module. The name of the module under which the project will be stored. After the import, the project can be checked out (see Section 1.3) under this name. It is also the name of the corresponding directory in the repository.
Working directory. This is the toplevel directory of the project you want to import. The import starts from this directory and goes down recursively.
Vendor tag. The vendor tag is historically used for tracking third-party sources. Just use your user name if you have no better idea. It does not matter much what you enter here.
Release tag. This tag is also historically used for importing different versions of third-party software. If you are not doing this, use the word start or a string FOO_1_0 where FOO is the name of your project and 1.0 is the version number of the imported release.
Ignore files. If you fill out this field, an additional -I filenames option is given go the cvs import command. This entry is interpreted as a whitespace-separated list of file name patterns which are ignored. In general, a cleaner and less error-prone way to control which files go into the repository is to create a directory with only the files which you want to import and start from that. Nevertheless, this entry may be useful if the project contains files which are by default ignored by CVS, e.g. files with the name core. In such a case, simply enter the character ! in this field. This overrules CVS's scheme of ignored files, see Section 6.1.
Import as binaries. If you check this box, all files are imported in binary mode, i.e. an argument -kb is given to cvs import.
