Chapter 6

$ cvs add INSTALL

cvs add: scheduling file  INSTALL  for addition

cvs add: use  cvs commit  to add this file permanently

As the output indicates, a cvs commit is needed to add the new file to the 

repository:

$ cvs commit  m "Added new INSTALL file." INSTALL

RCS file: /home/sam/cvsroot/book/INSTALL,v

done

Checking in INSTALL;

/home/sam/cvsroot/Data Counter/INSTALL,v  <    INSTALL

initial revision: 1.1

done

Similarly, cvs remove removes files from the repository. Simply deleting a file 

from a working copy is not enough to remove a file from CVS the next time you 

update, it will come back again! For example, to remove the newly create INSTALL 

file, three commands are required, rm, cvs remove, and finally cvs commit, to make 

the change in the repository:

$ rm INSTALL

$ cvs remove INSTALL

cvs remove: scheduling  INSTALL  for removal

cvs remove: use  cvs commit  to remove this file permanently

$ cvs commit  m "Removed INSTALL" INSTALL

Removing INSTALL;

/home/sam/cvsroot/book/FOO,v  <    FOO

new revision: delete; previous revision: 1.1

done

However, INSTALL is not gone from the repository. You can still examine its history, 

request diffs, and even call it back into existence by checking out an old version 

and adding it to the project.

NOTE Directories cannot be removed using normal CVS commands. 

The best you can do is make a directory empty and then check out a 

working copy with  P, which omits empty directories. To make matters 

worse, running cvs add on directories takes effect immediately no 

cvs commit command is required. Thus you should very carefully con 

sider your directory structure before running cvs add on a directory.

156