Node: Creating a repository, Next: , Previous: Basic Use, Up: Basic Use



Creating a repository

Before you can use PRCS at all, you must establish a PRCS repository (a directory). PRCS will create and initialize the repository if it does not exist the first time you attempt to use it. PRCS takes the name of the repository from the environment variable PRCS_REPOSITORY, which must be defined before running PRCS (if undefined, it defaults to $HOME/PRCS).

For example, to have a repository named PRCS_FILES in your home directory, execute

     % setenv PRCS_REPOSITORY ~/PRCS_FILES
     

in the C-shell or

     $ export PRCS_REPOSITORY
     $ PRCS_REPOSITORY=${HOME}/PRCS_FILES
     

in the Bourne shell. You may want to put this command into your .cshrc or .profile initialization file. In the rest of this document, we will assume that PRCS_REPOSITORY is properly defined.

When you first run PRCS after having set this environment variable, it will create directory PRCS_FILES in your home directory, assuming it does not already exist. If you attempt to run PRCS with PRCS_REPOSITORY set to a directory not in the right format, it will report an error.

Once your repository is established, you should generally be careful not to modify it except through PRCS, except that changing the group, protections, or name of the repository is harmless.