(cvs.info.gz) CVS in repository

Info Catalog

(cvs.info.gz) Attic

(cvs.info.gz) Repository storage

(cvs.info.gz) Locks

 
 2.2.5 The CVS directory in the repository
 -----------------------------------------
 
 The `CVS' directory in each repository directory contains information
 such as file attributes (in a file called `CVS/fileattr'.  In the
 future additional files may be added to this directory, so
 implementations should silently ignore additional files.
 
    This behavior is implemented only by CVS 1.7 and later; for details
 see  Watches Compatibility.
 
    The format of the `fileattr' file is a series of entries of the
 following form (where `{' and `}' means the text between the braces can
 be repeated zero or more times):
 
    ENT-TYPE FILENAME <tab> ATTRNAME = ATTRVAL   {; ATTRNAME = ATTRVAL}
 <linefeed>
 
    ENT-TYPE is `F' for a file, in which case the entry specifies the
 attributes for that file.
 
    ENT-TYPE is `D', and FILENAME empty, to specify default attributes
 to be used for newly added files.
 
    Other ENT-TYPE are reserved for future expansion.  CVS 1.9 and older
 will delete them any time it writes file attributes.  CVS 1.10 and
 later will preserve them.
 
    Note that the order of the lines is not significant; a program
 writing the fileattr file may rearrange them at its convenience.
 
    There is currently no way of quoting tabs or line feeds in the
 filename, `=' in ATTRNAME, `;' in ATTRVAL, etc.  Note: some
 implementations also don't handle a NUL character in any of the fields,
 but implementations are encouraged to allow it.
 
    By convention, ATTRNAME starting with `_' is for an attribute given
 special meaning by CVS; other ATTRNAMEs are for user-defined attributes
 (or will be, once implementations start supporting user-defined
 attributes).
 
    Built-in attributes:
 
 `_watched'
      Present means the file is watched and should be checked out
      read-only.
 
 `_watchers'
      Users with watches for this file.  Value is WATCHER > TYPE { ,
      WATCHER > TYPE } where WATCHER is a username, and TYPE is zero or
      more of edit,unedit,commit separated by `+' (that is, nothing if
      none; there is no "none" or "all" keyword).
 
 `_editors'
      Users editing this file.  Value is EDITOR > VAL { , EDITOR > VAL }
      where EDITOR is a username, and VAL is TIME+HOSTNAME+PATHNAME,
      where TIME is when the `cvs edit' command (or equivalent) happened,
      and HOSTNAME and PATHNAME are for the working directory.
 
    Example:
 
      Ffile1 _watched=;_watchers=joe>edit,mary>commit
      Ffile2 _watched=;_editors=sue>8 Jan 1975+workstn1+/home/sue/cvs
      D _watched=
 
 means that the file `file1' should be checked out read-only.
 Furthermore, joe is watching for edits and mary is watching for
 commits.  The file `file2' should be checked out read-only; sue started
 editing it on 8 Jan 1975 in the directory `/home/sue/cvs' on the
 machine `workstn1'.  Future files which are added should be checked out
 read-only.  To represent this example here, we have shown a space after
 `D', `Ffile1', and `Ffile2', but in fact there must be a single tab
 character there and no spaces.
 

Info Catalog

(cvs.info.gz) Attic

(cvs.info.gz) Repository storage

(cvs.info.gz) Locks