cvs.1 & cvs.texinfo: add details about "init"

Add a section about the "init" command that has been missing all this
time. Part of the basic description is resurrected from r. 1.20 of
cvs.1 (in its prior incarnation in the CVS project tree under /man
rather than /doc), contributed by Tom Lees back in 1999. The caveat
about the history file is copied from elsewhere in the current
cvs.texinfo file. Additional fragments written by me. Addresses the
PR bin/45446.
This commit is contained in:
gutteridge 2019-03-02 21:30:40 +00:00
parent 9fd3794014
commit 4e4fac16d4
2 changed files with 64 additions and 1 deletions

View File

@ -3081,6 +3081,36 @@ see node `modules\(aq in the CVS manual.)
.SP
See see node `Tracking sources\(aq in the CVS manual, and see node `From files\(aq in the CVS manual.
.SP
.SH "init"
.SS "Initialize a repository"
.IX "init (subcommand)"
.SP
.IP "\(bu" 2
init
.IP "\(bu" 2
Requires: working directory.
.IP "\(bu" 2
Changes: repository, working directory.
.SP
The \fBinit\fR command initializes a repository by adding the
\fBCVSROOT\fR subdirectory and some default control files. You must
use this command or initialize the repository in some other way before
you can use it. Specify the root of the repository with the general
\fB-d\fR option.
.SP
Note \fBinit\fR will enable history logging; if you don\(aqt want that,
remove the history file after running \fBinit\fR.
.SP
.SH "init examples"
.SP
.PD 0
.SP
.IP "" 2
$ cvs -d /usr/local/cvsroot init
.PD
.IP "" 0
.SP
.SH "log"
.SS "Print out log information for files"
.IX "log (subcommand)"

View File

@ -1952,7 +1952,8 @@ cvs -d /usr/local/cvsroot init
@code{cvs init} is careful to never overwrite any
existing files in the repository, so no harm is done if
you run @code{cvs init} on an already set-up
repository.
repository. Note you may need to be a member of the
group @code{cvsadmin} to do this.
@code{cvs init} will enable history logging; if you
don't want that, remove the history file after running
@ -8126,6 +8127,7 @@ reference to @sc{cvs} commands, @pxref{Invoking CVS}).
* export:: Export sources from CVS, similar to checkout
* history:: Show status of files and users
* import:: Import sources into CVS, using vendor branches
* init:: Initialize a repository
* log:: Show log messages for files
* ls & rls:: List files in the repository
* rdiff:: 'patch' format diffs between releases
@ -10866,6 +10868,37 @@ to recreate symbolic links on checkout, update, etc.;
See @ref{Tracking sources}, and @ref{From files}.
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@node init
@appendixsec init---Initialize a repository
@cindex init (subcommand)
@itemize @bullet
@item
init
@item
Requires: working directory.
@item
Changes: repository, working directory.
@end itemize
The @code{init} command initializes a repository by adding the
@file{CVSROOT} subdirectory and some default control files. You must
use this command or initialize the repository in some other way before
you can use it. Specify the root of the repository with the general
@code{-d} option.
Note @code{init} will enable history logging; if you don't want that,
remove the history file after running @code{init}.
@c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
@node init examples
@appendixsubsec init examples
@example
$ cvs -d /usr/local/cvsroot init
@end example
@c - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@node log
@appendixsec log---Print out log information for files