Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
cvs(5)
Edit
PageHistory
Diff
Info
LikePages
cvs !!!cvs NAME SYNOPSIS DESCRIPTION FILES SEE ALSO COPYING ---- !!NAME cvs - Concurrent Versions System support files !!SYNOPSIS __$CVSROOT/CVSROOT/commitinfo,v__ __$CVSROOT/CVSROOT/cvsignore,v__ __$CVSROOT/CVSROOT/cvswrappers,v__ __$CVSROOT/CVSROOT/editinfo,v__ __$CVSROOT/CVSROOT/history__ __$CVSROOT/CVSROOT/loginfo,v__ __$CVSROOT/CVSROOT/modules,v__ __$CVSROOT/CVSROOT/rcsinfo,v__ __$CVSROOT/CVSROOT/taginfo,v__ !!DESCRIPTION __cvs__ is a system for providing source control to hierarchi- cal collections of source directories. Commands and pro- cedures for using __cvs__ are described in __cvs__(__1__). __cvs__ manages ''source repositories'', the directories contain- ing master copies of the revision-controlled files, by copying particular revisions of the files to (and modifi- cations back from) developers' private ''working directo- ries''. In terms of file structure, each individual source repository is an immediate subdirectory of __$CVSROOT__. The files described here are supporting files; they do not have to exist for __cvs__ to operate, but they allow you to make __cvs__ operation more flexible. You can use the `modules' file to define symbolic names for collections of source maintained with __cvs__. If there is no `modules' file, developers must specify complete path names (absolute, or relative to __$CVSROOT__) for the files they wish to manage with __cvs__ commands. You can use the `commitinfo' file to define programs to execute whenever `__cvs commit__' is about to execute. These programs are used for ``pre-commit'' checking to verify that the modified, added, and removed files are really ready to be committed. Some uses for this check might be to turn off a portion (or all) of the source repository from a particular person or group. Or, perhaps, to verify that the changed files conform to the site's standards for coding practice. You can use the `cvswrappers' file to record __cvs__ wrapper commands to be used when checking files into and out of the repository. Wrappers allow the file or directory to be processed on the way in and out of CVS. The intended uses are many, one possible use would be to reformat a C file before the file is checked in, so all of the code in the repository looks the same. You can use the `loginfo' file to define programs to exe- cute after any __commit__, which writes a log entry for changes in the repository. These logging programs might be used to append the log message to a file. Or send the log message through electronic mail to a group of develop- ers. Or, perhaps, post the log message to a particular newsgroup. You can use the `taginfo' file to define programs to exe- cute after any __tag__or__rtag__ operation. These programs might be used to append a message to a file listing the new tag name and the programmer who created it, or send mail to a group of developers, or, perhaps, post a message to a par- ticular newsgroup. You can use the `rcsinfo' file to define forms for log messages. You can use the `editinfo' file to define a program to ex- ecute for editing/validating `__cvs commit__' log entries. This is most useful when used with a `rcsinfo' forms spec- ification, as it can verify that the proper fields of the form have been filled in by the user committing the change. You can use the `cvsignore' file to specify the default list of files to ignore during __update__. You can use the `history' file to record the __cvs__ commands that affect the repository. The creation of this file en- ables history logging. !!FILES __modules__ The `modules' file records your definitions of names for collections of source code. __cvs__ will use these definitions if you use __cvs__ to check in a file with the right format to `__$CVSROOT/CVSROOT/mod- ules,v__'. The `modules' file may contain blank lines and com- ments (lines beginning with `__#__') as well as module definitions. Long lines can be continued on the next line by specifying a backslash (``'') as the last character on the line. A ''module definition'' is a single line of the `mod- ules' file, in either of two formats. In both cas- es, ''mname'' represents the symbolic module name, and the remainder of the line is its definition. ''mname'' __-a__ ''aliases''... This represents the simplest way of defining a mod- ule ''mname''. The `__-a__' flags the definition as a sim- ple alias: __cvs__ will treat any use of ''mname'' (as a command argument) as if the list of names ''aliases'' had been specified instead. ''aliases'' may contain either other module names or paths. When you use paths in ''aliases'', `__cvs checkout__' creates all inter- mediate directories in the working directory, just as if the path had been specified explicitly in the __cvs__ arguments. ''mname'' [[ ''options'' ] ''dir'' [[ ''files''... ] [[ ____''module''... ] In the simplest case, this form of module defini- tion reduces to `''mname dir'''. This defines all the files in directory ''dir'' as module ''mname''. ''dir'' is a relative path (from __$CVSROOT__) to a directory of source in one of the source repositories. In this case, on __checkout__, a single directory called ''mname'' is created as a working directory; no intermediate directory levels are used by default, even if ''dir'' was a path involving several directory levels. By explicitly specifying ''files'' in the module defi- nition after ''dir'', you can select particular files from directory ''dir''. The sample definition for __mod- ules__ is an example of a module defined with a sin- gle file from a particular directory. Here is an- other example: __m4test unsupported/gnu/m4 foreach.m4 forloop.m4 __With this definition, executing `__cvs checkout m4test__' will create a single working directory `m4test' containing the two files listed, which both come from a common directory several levels deep in the __cvs__ source repository. A module definition can refer to other modules by including `____''module''' in its definition. __checkout__ creates a subdirectory for each such ''module'', in your working directory.'' New in'' __cvs__ ''1.3;'' avoid this feature if sharing mod- ule definitions with older versions of __cvs__. Finally, you can use one or more of the following ''options'' in module definitions: `__-d__ ''name''', to name the working directory something other than the module name.'' New in'' __cvs__ ''1.3;'' avoid this feature if sharing mod- ule definitions with older versions of __cvs__. `__-i__ ''prog''' allows you to specify a program ''prog'' to run whenever files in a module are committed. ''prog'' runs with a single argument, the full pathname of the affected directory in a source repository. The `commitinfo', `loginfo', and `editinfo' files provide other ways to call a program on __commit__. `__-o__ ''prog''' allows you to specify a program ''prog'' to run whenever files in a module are checked out. ''prog'' runs with a single argument, the module name. `__-e__ ''prog''' allows you to specify a program ''prog'' to run whenever files in a module are exported. ''prog'' runs with a single argument, the module name. `__-t__ ''prog''' allows you to specify a program ''prog'' to run whenever files in a module are tagged. ''prog'' runs with two arguments: the module name and the symbolic tag specified to __rtag__. `__-u__ ''prog''' allows you to specify a program ''prog'' to run whenever `__cvs update__' is executed from the top-level directory of the checked-out module. ''prog'' runs with a single argument, the full path to the source repository for this module. __commitinfo__, __loginfo__, __rcsinfo__, __editinfo__ These files all specify programs to call at differ- ent points in the `__cvs commit__' process. They have a common structure. Each line is a pair of fields: a regular expression, separated by whitespace from a filename or command-line template. Whenever one of the regular expression matches a directory name in the repository, the rest of the line is used. If the line begins with a __#__ character, the entire line is considered a comment and is ignored. Whitespace between the fields is also ignored. For `loginfo', the rest of the line is a com- mand-line template to execute. The templates can include not only a program name, but whatever list of arguments you wish. If you write `__%s__' somewhere on the argument list, __cvs__ supplies, at that point, the list of files affected by the __commit__. The first entry in the list is the relative path within the source repository where the change is being made. The remaining arguments list the files that are being modified, added, or removed by this __com- mit__ invocation. For `taginfo', the rest of the line is a com- mand-line template to execute. The arguments passed to the command are, in order, the ''tagname , operation'' (i.e. __add__ for `tag', __mov__ for `tag -F', and __del__ for `tag -d`), ''repository ,'' and any remain- ing are pairs of __filename revision .__ A non-zero exit of the filter program will cause the tag to be aborted. For `commitinfo', the rest of the line is a com- mand-line template to execute. The template can include not only a program name, but whatever list of arguments you wish. The full path to the cur- rent source repository is appended to the template, followed by the file names of any files involved in the commit (added, removed, and modified files). For `rcsinfo', the rest of the line is the full path to a file that should be loaded into the log message template. For `editinfo', the rest of the line is a com- mand-line template to execute. The template can include not only a program name, but whatever list of arguments you wish. The full path to the cur- rent log message template file is appended to the template. You can use one of two special strings instead of a regular expression: `__ALL__' specifies a command line template that must always be executed, and `__DE- FAULT__' specifies a command line template to use if no regular expression is a match. The `commitinfo' file contains commands to execute ''before'' any other __commit__ activity, to allow you to check any conditions that must be satisfied before __commit__ can proceed. The rest of the __commit__ will execute only if all selected commands from this file exit with exit status __0__. The `rcsinfo' file allows you to specify ''log tem- plates'' for the __commit__ logging session; you can use this to provide a form to edit when filling out the __commit__ log. The field after the regular expres- sion, in this file, contains filenames (of files containing the logging forms) rather than command templates. The `editinfo' file allows you to execute a script ''before the commit starts'', but after the log infor- mation is recorded. These '' The `loginfo' file contains commands to execute ''at the end'' of a commit. The text specified as a com- mit log message is piped through the command; typi- cal uses include sending mail, filing an article in a newsgroup, or appending to a central file. __cvsignore__, __.cvsignore__ The default list of files (or __sh__(__1__) file name pat- terns) to ignore during `__cvs update__'. At startup time, __cvs__ loads the compiled in default list of file name patterns (see __cvs__(__1__)). Then the per-repository list included in __$CVSROOT/CVS- ROOT/cvsignore__ is loaded, if it exists. Then the per-user list is loaded from `$HOME/.cvsignore'. Finally, as __cvs__ traverses through your directories, it will load any per-directory `.cvsignore' files whenever it finds one. These per-directory files are only valid for exactly the directory that con- tains them, not for any sub-directories. __history__ Create this file in __$CVSROOT/CVSROOT__ to enable his- tory logging (see the description of `__cvs histo- ry__'). !!SEE ALSO __cvs__(__1__), !!COPYING Copyright 1992 Cygnus Support, Brian Berliner, and Jeff Polk Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified ver- sions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above con- ditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original En- glish. ----
One page links to
cvs(5)
:
Man5c
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.