[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
B. Quick reference to CVS commands
This appendix describes how to invoke CVS, with
references to where each command or feature is
described in detail. For other references run the
cvs --help
command, or see Index.
A CVS command looks like:
cvs [ global_options ] command [ command_options ] [ command_args ] |
Global options:
-
--allow-root=rootdir
Specify legal CVSROOT directory (server only) (not in CVS 1.9 and older). See Setting up the server for password authentication.
-
-a
Authenticate all communication (client only) (not in CVS 1.9 and older). See Global options.
-
-b
Specify RCS location (CVS 1.9 and older). See Global options.
-
-d root
Specify the CVSROOT. See The Repository.
-
-e editor
Edit messages with editor. See Committing your changes.
-
-f
Do not read the ‘~/.cvsrc’ file. See Global options.
-
-H
-
--help
Print a help message. See Global options.
-
-n
Do not change any files. See Global options.
-
-Q
Be really quiet. See Global options.
-
-q
Be somewhat quiet. See Global options.
-
-r
Make new working files read-only. See Global options.
-
-s variable=value
Set a user variable. See Expansions in administrative files.
-
-T tempdir
Put temporary files in tempdir. See Global options.
-
-t
Trace CVS execution. See Global options.
-
-v
-
--version
Display version and copyright information for CVS.
-
-w
Make new working files read-write. See Global options.
-
-x
Encrypt all communication (client only). See Global options.
-
-z gzip-level
-
Set the compression level (client only). See Global options.
Keyword expansion modes (see section Substitution modes):
-kkv $Id: file1,v 1.1 1993/12/09 03:21:13 joe Exp $ -kkvl $Id: file1,v 1.1 1993/12/09 03:21:13 joe Exp harry $ -kk $Id$ -kv file1,v 1.1 1993/12/09 03:21:13 joe Exp -ko no expansion -kb no expansion, file is binary |
Keywords (see section Keyword List):
$Author: joe $ $Date: 1993/12/09 03:21:13 $ $Header: /home/files/file1,v 1.1 1993/12/09 03:21:13 joe Exp harry $ $Id: file1,v 1.1 1993/12/09 03:21:13 joe Exp harry $ $Locker: harry $ $Name: snapshot_1_14 $ $RCSfile: file1,v $ $Revision: 1.1 $ $Source: /home/files/file1,v $ $State: Exp $ $Log: file1,v $ Revision 1.1 1993/12/09 03:30:17 joe Initial revision |
Commands, command options, and command arguments:
-
add [options] [files…]
Add a new file/directory. See Adding files to a directory.
-
-k kflag
Set keyword expansion.
-
-m msg
Set file description.
-
-
admin [options] [files…]
Administration of history files in the repository. See admin—Administration.
-
-b[rev]
Set default branch. See Reverting to the latest vendor release.
-
-cstring
Set comment leader.
-
-ksubst
Set keyword substitution. See Keyword substitution.
-
-l[rev]
Lock revision rev, or latest revision.
-
-mrev:msg
Replace the log message of revision rev with msg.
-
-orange
Delete revisions from the repository. See admin options.
-
-q
Run quietly; do not print diagnostics.
-
-sstate[:rev]
Set the state. See admin options for more information on possible states.
-
-t
Set file description from standard input.
-
-tfile
Set file description from file.
-
-t-string
Set file description to string.
-
-u[rev]
Unlock revision rev, or latest revision.
-
-
annotate [options] [files…]
Show last revision where each line was modified. See annotate—What revision modified each line of a file?.
-
-D date
Annotate the most recent revision no later than date. See Common command options.
-
-F
Force annotation of binary files. (Without this option, binary files are skipped with a message.)
-
-f
Use head revision if tag/date not found. See Common command options.
-
-l
Local; run only in current working directory. See section Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r tag
Annotate revision tag. See Common command options.
-
-
checkout [options] modules…
Get a copy of the sources. See checkout—Check out sources for editing.
-
-A
Reset any sticky tags/date/options. See Sticky tags and Keyword substitution.
-
-c
Output the module database. See checkout options.
-
-D date
Check out revisions as of date (is sticky). See Common command options.
-
-d dir
Check out into dir. See checkout options.
-
-f
Use head revision if tag/date not found. See Common command options.
-
-j rev
Merge in changes. See checkout options.
-
-k kflag
Use kflag keyword expansion. See Substitution modes.
-
-l
Local; run only in current working directory. See section Recursive behavior.
-
-N
Don't “shorten” module paths if -d specified. See checkout options.
-
-n
Do not run module program (if any). See checkout options.
-
-P
Prune empty directories. See Moving and renaming directories.
-
-p
Check out files to standard output (avoids stickiness). See checkout options.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r tag
Checkout revision tag (is sticky). See Common command options.
-
-s
Like -c, but include module status. See checkout options.
-
-
commit [options] [files…]
Check changes into the repository. See commit—Check files into the repository.
-
-F file
Read log message from file. See commit options.
-
-f
Force the file to be committed; disables recursion. See commit options.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-m msg
Use msg as log message. See commit options.
-
-n
Do not run module program (if any). See commit options.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r rev
Commit to rev. See commit options.
-
-
diff [options] [files…]
Show differences between revisions. See diff—Show differences between revisions. In addition to the options shown below, accepts a wide variety of options to control output style, for example ‘-c’ for context diffs.
-
-D date1
Diff revision for date against working file. See diff options.
-
-D date2
Diff rev1/date1 against date2. See diff options.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-N
Include diffs for added and removed files. See diff options.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r rev1
Diff revision for rev1 against working file. See diff options.
-
-r rev2
Diff rev1/date1 against rev2. See diff options.
-
-
edit [options] [files…]
Get ready to edit a watched file. See How to edit a file which is being watched.
-
-a actions
Specify actions for temporary watch, where actions is
edit
,unedit
,commit
,all
, ornone
. See How to edit a file which is being watched.-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-
editors [options] [files…]
See who is editing a watched file. See Information about who is watching and editing.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-
export [options] modules…
Export files from CVS. See export—Export sources from CVS, similar to checkout.
-
-D date
Check out revisions as of date. See Common command options.
-
-d dir
Check out into dir. See export options.
-
-f
Use head revision if tag/date not found. See Common command options.
-
-k kflag
Use kflag keyword expansion. See Substitution modes.
-
-l
Local; run only in current working directory. See section Recursive behavior.
-
-N
Don't “shorten” module paths if -d specified. See export options.
-
-n
Do not run module program (if any). See export options.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r tag
Checkout revision tag. See Common command options.
-
-
history [options] [files…]
Show repository access history. See history—Show status of files and users.
-
-a
All users (default is self). See history options.
-
-b str
Back to record with str in module/file/repos field. See history options.
-
-c
Report on committed (modified) files. See history options.
-
-D date
Since date. See history options.
-
-e
Report on all record types. See history options.
-
-l
Last modified (committed or modified report). See history options.
-
-m module
Report on module (repeatable). See history options.
-
-n module
In module. See history options.
-
-o
Report on checked out modules. See history options.
-
-p repository
In repository. See history options.
-
-r rev
Since revision rev. See history options.
-
-T
Produce report on all TAGs. See history options.
-
-t tag
Since tag record placed in history file (by anyone). See history options.
-
-u user
For user user (repeatable). See history options.
-
-w
Working directory must match. See history options.
-
-x types
Report on types, one or more of
TOEFWUPCGMAR
. See history options.-
-z zone
Output for time zone zone. See history options.
-
-
import [options] repository vendor-tag release-tags…
Import files into CVS, using vendor branches. See import—Import sources into CVS, using vendor branches.
-
-b bra
Import to vendor branch bra. See Multiple vendor branches.
-
-d
Use the file's modification time as the time of import. See import options.
-
-k kflag
Set default keyword substitution mode. See import options.
-
-m msg
Use msg for log message. See import options.
-
-I ign
More files to ignore (! to reset). See import options.
-
-W spec
More wrappers. See import options.
-
-
init
Create a CVS repository if it doesn't exist. See Creating a repository.
-
kserver
Kerberos authenticated server. See Direct connection with Kerberos.
-
log [options] [files…]
Print out history information for files. See log—Print out log information for files.
-
-b
Only list revisions on the default branch. See log options.
-
-d dates
Specify dates (d1<d2 for range, d for latest before). See log options.
-
-h
Only print header. See log options.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-N
Do not list tags. See log options.
-
-R
Only print name of RCS file. See log options.
-
-rrevs
Only list revisions revs. See log options.
-
-s states
Only list revisions with specified states. See log options.
-
-t
Only print header and descriptive text. See log options.
-
-wlogins
Only list revisions checked in by specified logins. See log options.
-
-
login
Prompt for password for authenticating server. See Using the client with password authentication.
-
logout
Remove stored password for authenticating server. See Using the client with password authentication.
-
pserver
Password authenticated server. See Setting up the server for password authentication.
-
rannotate [options] [modules…]
Show last revision where each line was modified. See annotate—What revision modified each line of a file?.
-
-D date
Annotate the most recent revision no later than date. See Common command options.
-
-F
Force annotation of binary files. (Without this option, binary files are skipped with a message.)
-
-f
Use head revision if tag/date not found. See Common command options.
-
-l
Local; run only in current working directory. See section Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r tag
Annotate revision tag. See Common command options.
-
-
rdiff [options] modules…
Show differences between releases. See rdiff—'patch' format diffs between releases.
-
-c
Context diff output format (default). See rdiff options.
-
-D date
Select revisions based on date. See Common command options.
-
-f
Use head revision if tag/date not found. See Common command options.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r rev
Select revisions based on rev. See Common command options.
-
-s
Short patch - one liner per file. See rdiff options.
-
-t
Top two diffs - last change made to the file. See diff options.
-
-u
Unidiff output format. See rdiff options.
-
-V vers
Use RCS Version vers for keyword expansion (obsolete). See rdiff options.
-
-
release [options] directory
Indicate that a directory is no longer in use. See release—Indicate that a Module is no longer in use.
-
-d
Delete the given directory. See release options.
-
-
remove [options] [files…]
Remove an entry from the repository. See Removing files.
-
-f
Delete the file before removing it. See Removing files.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-
rlog [options] [files…]
Print out history information for modules. See log—Print out log information for files.
-
-b
Only list revisions on the default branch. See log options.
-
-d dates
Specify dates (d1<d2 for range, d for latest before). See log options.
-
-h
Only print header. See log options.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-N
Do not list tags. See log options.
-
-R
Only print name of RCS file. See log options.
-
-rrevs
Only list revisions revs. See log options.
-
-s states
Only list revisions with specified states. See log options.
-
-t
Only print header and descriptive text. See log options.
-
-wlogins
Only list revisions checked in by specified logins. See log options.
-
-
rtag [options] tag modules…
Add a symbolic tag to a module. See Revisions and Branching and merging.
-
-a
Clear tag from removed files that would not otherwise be tagged. See Tagging and adding and removing files.
-
-b
Create a branch named tag. See Branching and merging.
-
-B
Used in conjunction with -F or -d, enables movement and deletion of branch tags. Use with extreme caution.
-
-D date
Tag revisions as of date. See Specifying what to tag by date or revision.
-
-d
Delete tag. See Deleting, moving, and renaming tags.
-
-F
Move tag if it already exists. See Deleting, moving, and renaming tags.
-
-f
Force a head revision match if tag/date not found. See Specifying what to tag by date or revision.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-n
No execution of tag program. See Common command options.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r rev
Tag existing tag rev. See Specifying what to tag by date or revision.
-
-
server
Rsh server. See Connecting with rsh.
-
status [options] files…
Display status information in a working directory. See File status.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-v
Include tag information for file. See Tags–Symbolic revisions.
-
-
tag [options] tag [files…]
Add a symbolic tag to checked out version of files. See Revisions and Branching and merging.
-
-b
Create a branch named tag. See Branching and merging.
-
-c
Check that working files are unmodified. See Specifying what to tag from the working directory.
-
-D date
Tag revisions as of date. See Specifying what to tag by date or revision.
-
-d
Delete tag. See Deleting, moving, and renaming tags.
-
-F
Move tag if it already exists. See Deleting, moving, and renaming tags.
-
-f
Force a head revision match if tag/date not found. See Specifying what to tag by date or revision.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r rev
Tag existing tag rev. See Specifying what to tag by date or revision.
-
-
unedit [options] [files…]
Undo an edit command. See How to edit a file which is being watched.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-
update [options] [files…]
Bring work tree in sync with repository. See update—Bring work tree in sync with repository.
-
-A
Reset any sticky tags/date/options. See Sticky tags and Keyword substitution.
-
-C
Overwrite locally modified files with clean copies from the repository (the modified file is saved in ‘.#file.revision’, however).
-
-D date
Check out revisions as of date (is sticky). See Common command options.
-
-d
Create directories. See update options.
-
-f
Use head revision if tag/date not found. See Common command options.
-
-I ign
More files to ignore (! to reset). See import options.
-
-j rev
Merge in changes. See update options.
-
-k kflag
Use kflag keyword expansion. See Substitution modes.
-
-l
Local; run only in current working directory. See section Recursive behavior.
-
-P
Prune empty directories. See Moving and renaming directories.
-
-p
Check out files to standard output (avoids stickiness). See update options.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-r tag
Checkout revision tag (is sticky). See Common command options.
-
-W spec
More wrappers. See import options.
-
-
version
-
Display the version of CVS being used. If the repository is remote, display both the client and server versions.
-
watch [on|off|add|remove] [options] [files…]
-
on/off: turn on/off read-only checkouts of files. See Telling CVS to watch certain files.
add/remove: add or remove notification on actions. See Telling CVS to notify you.
-
-a actions
Specify actions for temporary watch, where actions is
edit
,unedit
,commit
,all
, ornone
. See How to edit a file which is being watched.-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
-
watchers [options] [files…]
See who is watching a file. See Information about who is watching and editing.
-
-l
Local; run only in current working directory. See Recursive behavior.
-
-R
Operate recursively (default). See section Recursive behavior.
-
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |