summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/cvs/doc/cvs.info-8
diff options
context:
space:
mode:
authorThorsten Lockert <tholo@cvs.openbsd.org>1999-09-10 05:14:54 +0000
committerThorsten Lockert <tholo@cvs.openbsd.org>1999-09-10 05:14:54 +0000
commit9c8d611dcb7b2503e40f35cdee447fd422c8d895 (patch)
tree6cf599c8dbe174400229ff095b1b06c2eabe6eae /gnu/usr.bin/cvs/doc/cvs.info-8
parentcd99c1703e7a27d21741a2b814c1ec61bd6301d2 (diff)
Latest version from Cyclic; skipped files
Diffstat (limited to 'gnu/usr.bin/cvs/doc/cvs.info-8')
-rw-r--r--gnu/usr.bin/cvs/doc/cvs.info-8118
1 files changed, 111 insertions, 7 deletions
diff --git a/gnu/usr.bin/cvs/doc/cvs.info-8 b/gnu/usr.bin/cvs/doc/cvs.info-8
index f3e35a6065c..f8ad1c54fba 100644
--- a/gnu/usr.bin/cvs/doc/cvs.info-8
+++ b/gnu/usr.bin/cvs/doc/cvs.info-8
@@ -1,5 +1,4 @@
-This is Info file cvs.info, produced by Makeinfo version 1.67 from the
-input file ../../work/ccvs/doc/cvs.texinfo.
+This is cvs.info, produced by Makeinfo version 3.12f from ./cvs.texinfo.
START-INFO-DIR-ENTRY
* CVS: (cvs). Concurrent Versions System
@@ -23,6 +22,60 @@ versions, except that this permission notice may be stated in a
translation approved by the Free Software Foundation.

+File: cvs.info, Node: checkoutlist, Next: history file, Prev: cvsignore, Up: Administrative files
+
+The checkoutlist file
+=====================
+
+ It may be helpful to use CVS to maintain your own files in the
+`CVSROOT' directory. For example, suppose that you have a script
+`logcommit.pl' which you run by including the following line in the
+`commitinfo' administrative file:
+
+ ALL $CVSROOT/CVSROOT/logcommit.pl
+
+ To maintain `logcommit.pl' with CVS you would add the following line
+to the `checkoutlist' administrative file:
+
+ logcommit.pl
+
+ The format of `checkoutlist' is one line for each file that you want
+to maintain using CVS, giving the name of the file.
+
+ After setting up `checkoutlist' in this fashion, the files listed
+there will function just like CVS's built-in administrative files. For
+example, when checking in one of the files you should get a message
+such as:
+
+ cvs commit: Rebuilding administrative file database
+
+ and the checked out copy in the `CVSROOT' directory should be
+updated.
+
+ Note that listing `passwd' (*note Password authentication server::.)
+in `checkoutlist' is not recommended for security reasons.
+
+ For information about keeping a checkout out copy in a more general
+context than the one provided by `checkoutlist', see *Note Keeping a
+checked out copy::.
+
+
+File: cvs.info, Node: history file, Next: Variables, Prev: checkoutlist, Up: Administrative files
+
+The history file
+================
+
+ The file `$CVSROOT/CVSROOT/history' is used to log information for
+the `history' command (*note history::.). This file must be created to
+turn on logging. This is done automatically if the `cvs init' command
+is used to set up the repository (*note Creating a repository::.).
+
+ The file format of the `history' file is documented only in comments
+in the CVS source code, but generally programs should use the `cvs
+history' command to access it anyway, in case the format changes with
+future releases of CVS.
+
+
File: cvs.info, Node: Variables, Next: config, Prev: history file, Up: Administrative files
Expansions in administrative files
@@ -36,7 +89,7 @@ in. There are several mechanisms to do that.
environment variable), use `~' followed by `/' or the end of the line.
Likewise for the home directory of USER, use `~USER'. These variables
are expanded on the server machine, and don't get any reasonable
-expansion if pserver (*note Password authenticated::.) is in use;
+expansion if pserver (*note Password authenticated::.) is in use;
therefore user variables (see below) may be a better choice to
customize behavior based on the user running CVS.
@@ -115,8 +168,8 @@ very strict. Extraneous spaces or tabs are not permitted.
`PreservePermissions=VALUE'
Enable support for saving special device files, symbolic links,
file permissions and ownerships in the repository. The default
- value is `no'. *Note Special Files:: for the full implications of
- using this keyword.
+ value is `no'. *Note Special Files::, for the full implications
+ of using this keyword.
`TopLevelAdmin=VALUE'
Modify the `checkout' command to create a `CVS' directory at the
@@ -198,7 +251,9 @@ All environment variables which affect CVS
use `$PATH' to try to find all programs it uses.
`$HOME'
+
`$HOMEPATH'
+
`$HOMEDRIVE'
Used to locate the directory where the `.cvsrc' file, and other
such files, are searched. On Unix, CVS just checks for HOME. On
@@ -359,6 +414,18 @@ using at any particular moment).
using CVS, retrying the operation which produced it should work
fine.
+`cvs [server aborted]: Cannot check out files into the repository itself'
+ The obvious cause for this message (especially for
+ non-client/server CVS) is that the CVS root is, for example,
+ `/usr/local/cvsroot' and you try to check out files when you are
+ in a subdirectory, such as `/usr/local/cvsroot/test'. However,
+ there is a more subtle cause, which is that the temporary
+ directory on the server is set to a subdirectory of the root
+ (which is also not allowed). If this is the problem, set the
+ temporary directory to somewhere else, for example `/var/tmp'; see
+ `TMPDIR' in *Note Environment variables::, for how to set the
+ temporary directory.
+
`cannot open CVS/Entries for reading: No such file or directory'
This generally indicates a CVS internal error, and can be handled
as with other CVS bugs (*note BUGS::.). Usually there is a
@@ -415,7 +482,7 @@ using at any particular moment).
`cvs [update aborted]: could not patch FILE: No such file or directory'
This means that there was a problem finding the `patch' program.
Make sure that it is in your `PATH'. Note that despite
- appearances the message is *not* referring to whether it can find
+ appearances the message is _not_ referring to whether it can find
FILE. If both the client and the server are running a current
version of CVS, then there is no need for an external patch
program and you should not see this message. But if either client
@@ -443,6 +510,19 @@ using at any particular moment).
before the above message. For more information on setting up a
CVS client and server, see *Note Remote repositories::.
+`cvs [update aborted]: EOF in key in RCS file FILE,v'
+`cvs [checkout aborted]: EOF while looking for end of string in RCS file FILE,v'
+ This means that there is a syntax error in the given RCS file.
+ Note that this might be true even if RCS can read the file OK; CVS
+ does more error checking of errors in the RCS file. That is why
+ you may see this message when upgrading from CVS 1.9 to CVS 1.10.
+ The likely cause for the original corruption is hardware, the
+ operating system, or the like. Of course, if you find a case in
+ which CVS seems to corrupting the file, by all means report it,
+ (*note BUGS::.). There are quite a few variations of this error
+ message, depending on exactly where in the RCS file CVS finds the
+ syntax error.
+
`cvs commit: Executing 'mkmodules''
This means that your repository is set up for a version of CVS
prior to CVS 1.8. When using CVS 1.8 or later, the above message
@@ -464,6 +544,18 @@ using at any particular moment).
sure your username is set to a non-empty value and re-create the
RCS file.
+`cvs [checkout aborted]: no such tag TAG'
+ This message means that CVS isn't familiar with the tag TAG.
+ Usually this means that you have mistyped a tag name; however
+ there are (relatively obscure) cases in which CVS will require you
+ to try a few other CVS commands involving that tag, before you
+ find one which will cause CVS to update the `val-tags' file; see
+ discussion of val-tags in *Note File permissions::. You only need
+ to worry about this once for a given tag; when a tag is listed in
+ `val-tags', it stays there. Note that using `-f' to not require
+ tag matches does not override this check; see *Note Common
+ options::.
+
`*PANIC* administration files missing'
This typically means that there is a directory named CVS but it
does not contain the administrative files which CVS puts in a CVS
@@ -498,6 +590,9 @@ using at any particular moment).
be specified with a `-f' option. Of course, if you don't need
`log.pl' you can just comment it out of `loginfo'.
+`cvs [update aborted]: unexpected EOF reading FILE,v'
+ See `EOF in key in RCS file'.
+
`cvs [login aborted]: unrecognized auth response from SERVER'
This message typically means that the server is not set up
properly. For example, if `inetd.conf' points to a nonexistent
@@ -603,6 +698,9 @@ the next steps depend largely on which access method you are using.
2401 is registered for use with CVS. I hear that there is an AIX
patch available to address this problem.
+ Another good debugging tool is the `-d' (debugging) option to
+ inetd. Consult your system documentation for more information.
+

File: cvs.info, Node: Other problems, Prev: Connection, Up: Troubleshooting
@@ -612,6 +710,12 @@ Other common problems
Here is a list of problems which do not fit into the above
categories. They are in no particular order.
+ * On Windows, if there is a 30 second or so delay when you run a CVS
+ command, it may mean that you have your home directory set to
+ `C:/', for example (see `HOMEDRIVE' and `HOMEPATH' in *Note
+ Environment variables::). CVS expects the home directory to not
+ end in a slash, for example `C:' or `C:\cvs'.
+
* If you are running CVS 1.9.18 or older, and `cvs update' finds a
conflict and tries to merge, as described in *Note Conflicts
example::, but doesn't tell you there were conflicts, then you may
@@ -726,7 +830,7 @@ problems with CVS itself.
justification for sending mail directly to one of the CVS
maintainers rather than to `bug-cvs'; those maintainers who want
to hear about such bug reports read `bug-cvs'. Also note that
- sending a bug report to other mailing lists or newsgroups is *not*
+ sending a bug report to other mailing lists or newsgroups is _not_
a substitute for sending it to `bug-cvs'. It is fine to discuss
CVS bugs on whatever forum you prefer, but there are not
necessarily any maintainers reading bug reports sent anywhere