GNU Info

Info Node: (cvs.info)Invoking CVS

(cvs.info)Invoking CVS


Next: Administrative files Prev: CVS commands Up: Top
Enter node , (file) or (file)node

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 Note: 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 Note: Password authentication server.

`-a'
     Authenticate all communication (client only) (not in CVS 1.9 and
     older).  See Note: Global options.

`-b'
     Specify RCS location (CVS 1.9 and older).  See Note: Global
     options.

`-d ROOT'
     Specify the CVSROOT.  See Note: Repository.

`-e EDITOR'
     Edit messages with EDITOR.  See Note: Committing your changes.

`-f'
     Do not read the `~/.cvsrc' file.  See Note: Global options.

`-H'
`--help'
     Print a help message.  See Note: Global options.

`-l'
     Do not log in `$CVSROOT/CVSROOT/history' file.  See Note: Global
     options.

`-n'
     Do not change any files.  See Note: Global options.

`-Q'
     Be really quiet.  See Note: Global options.

`-q'
     Be somewhat quiet.  See Note: Global options.

`-r'
     Make new working files read-only.  See Note: Global options.

`-s VARIABLE=VALUE'
     Set a user variable.  See Note: Variables.

`-T TEMPDIR'
     Put temporary files in TEMPDIR.  See Note: Global options.

`-t'
     Trace CVS execution.  See Note: Global options.

`-v'

`--version'
     Display version and copyright information for CVS.

`-w'
     Make new working files read-write.  See Note: Global options.

`-x'
     Encrypt all communication (client only).  See Note: Global
     options.

`-z GZIP-LEVEL'
     Set the compression level (client only).  See Note: Global
     options.

   Keyword expansion modes (Note: 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 (Note: 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 Note: Adding files.

    `-k KFLAG'
          Set keyword expansion.

    `-m MSG'
          Set file description.

`admin [OPTIONS] [FILES...]'
     Administration of history files in the repository.  See Note:
     admin.

    `-b[REV]'
          Set default branch.  See Note: Reverting local changes.

    `-cSTRING'
          Set comment leader.

    `-kSUBST'
          Set keyword substitution.  See Note: 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 Note: admin
          options.

    `-q'
          Run quietly; do not print diagnostics.

    `-sSTATE[:REV]'
          Set the state.

    `-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 Note:
     annotate.

    `-D DATE'
          Annotate the most recent revision no later than DATE.  See
          Note: Common options.

    `-f'
          Use head revision if tag/date not found.  See Note: Common
          options.

    `-l'
          Local; run only in current working directory.  Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r TAG'
          Annotate revision TAG.  See Note: Common options.

`checkout [OPTIONS] MODULES...'
     Get a copy of the sources.  See Note: checkout.

    `-A'
          Reset any sticky tags/date/options.  See Note: Sticky tags
          and Note: Keyword substitution.

    `-c'
          Output the module database.  See Note: checkout options.

    `-D DATE'
          Check out revisions as of DATE (is sticky).  See Note: Common
          options.

    `-d DIR'
          Check out into DIR.  See Note: checkout options.

    `-f'
          Use head revision if tag/date not found.  See Note: Common
          options.

    `-j REV'
          Merge in changes.  See Note: checkout options.

    `-k KFLAG'
          Use KFLAG keyword expansion.  See Note: Substitution modes.

    `-l'
          Local; run only in current working directory.  Note:
          Recursive behavior.

    `-N'
          Don't "shorten" module paths if -d specified.  See Note:
          checkout options.

    `-n'
          Do not run module program (if any).  See Note: checkout
          options.

    `-P'
          Prune empty directories.  See Note: Moving directories.

    `-p'
          Check out files to standard output (avoids stickiness).  See
          Note: checkout options.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r TAG'
          Checkout revision TAG (is sticky).  See Note: Common
          options.

    `-s'
          Like -c, but include module status.  See Note: checkout
          options.

`commit [OPTIONS] [FILES...]'
     Check changes into the repository.  See Note: commit.

    `-F FILE'
          Read log message from FILE.  See Note: commit options.

    `-f'
          Force the file to be committed; disables recursion.  See
          Note: commit options.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-m MSG'
          Use MSG as log message.  See Note: commit options.

    `-n'
          Do not run module program (if any).  See Note: commit
          options.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r REV'
          Commit to REV.  See Note: commit options.

`diff [OPTIONS] [FILES...]'
     Show differences between revisions.  See Note: diff.  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 Note: diff
          options.

    `-D DATE2'
          Diff REV1/DATE1 against DATE2.  See Note: diff options.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-N'
          Include diffs for added and removed files.  See Note: diff
          options.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r REV1'
          Diff revision for REV1 against working file.  See Note: diff
          options.

    `-r REV2'
          Diff REV1/DATE1 against REV2.  See Note: diff options.

`edit [OPTIONS] [FILES...]'
     Get ready to edit a watched file.  See Note: Editing files.

    `-a ACTIONS'
          Specify actions for temporary watch, where ACTIONS is `edit',
          `unedit', `commit', `all', or `none'.  See Note: Editing
          files.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

`editors [OPTIONS] [FILES...]'
     See who is editing a watched file.  See Note: Watch information.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

`export [OPTIONS] MODULES...'
     Export files from CVS.  See Note: export.

    `-D DATE'
          Check out revisions as of DATE.  See Note: Common options.

    `-d DIR'
          Check out into DIR.  See Note: export options.

    `-f'
          Use head revision if tag/date not found.  See Note: Common
          options.

    `-k KFLAG'
          Use KFLAG keyword expansion.  See Note: Substitution modes.

    `-l'
          Local; run only in current working directory.  Note:
          Recursive behavior.

    `-N'
          Don't "shorten" module paths if -d specified.  See Note:
          export options.

    `-n'
          Do not run module program (if any).  See Note: export
          options.

    `-P'
          Prune empty directories.  See Note: Moving directories.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r TAG'
          Checkout revision TAG.  See Note: Common options.

`history [OPTIONS] [FILES...]'
     Show repository access history.  See Note: history.

    `-a'
          All users (default is self).  See Note: history options.

    `-b STR'
          Back to record with STR in module/file/repos field.  See
          Note: history options.

    `-c'
          Report on committed (modified) files.  See Note: history
          options.

    `-D DATE'
          Since DATE.  See Note: history options.

    `-e'
          Report on all record types.  See Note: history options.

    `-l'
          Last modified (committed or modified report).  See Note:
          history options.

    `-m MODULE'
          Report on MODULE (repeatable).  See Note: history options.

    `-n MODULE'
          In MODULE.  See Note: history options.

    `-o'
          Report on checked out modules.  See Note: history options.

    `-r REV'
          Since revision REV.  See Note: history options.

    `-T'
          Produce report on all TAGs.  See Note: history options.

    `-t TAG'
          Since tag record placed in history file (by anyone).  See
          Note: history options.

    `-u USER'
          For user USER (repeatable).  See Note: history options.

    `-w'
          Working directory must match.  See Note: history options.

    `-x TYPES'
          Report on TYPES, one or more of `TOEFWUCGMAR'.  See Note:
          history options.

    `-z ZONE'
          Output for time zone ZONE.  See Note: history options.

`import [OPTIONS] REPOSITORY VENDOR-TAG RELEASE-TAGS...'
     Import files into CVS, using vendor branches.  See Note: import.

    `-b BRA'
          Import to vendor branch BRA.  See Note: Multiple vendor
          branches.

    `-d'
          Use the file's modification time as the time of import.  See
          Note: import options.

    `-k KFLAG'
          Set default keyword substitution mode.  See Note: import
          options.

    `-m MSG'
          Use MSG for log message.  See Note: import options.

    `-I IGN'
          More files to ignore (! to reset).  See Note: import
          options.

    `-W SPEC'
          More wrappers.  See Note: import options.

`init'
     Create a CVS repository if it doesn't exist.  See Note: Creating a
     repository.

`log [OPTIONS] [FILES...]'
     Print out history information for files.  See Note: log.

    `-b'
          Only list revisions on the default branch.  See Note: log
          options.

    `-d DATES'
          Specify dates (D1<D2 for range, D for latest before).  See
          Note: log options.

    `-h'
          Only print header.  See Note: log options.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-N'
          Do not list tags.  See Note: log options.

    `-R'
          Only print name of RCS file.  See Note: log options.

    `-rREVS'
          Only list revisions REVS.  See Note: log options.

    `-s STATES'
          Only list revisions with specified states.  See Note: log
          options.

    `-t'
          Only print header and descriptive text.  See Note: log
          options.

    `-wLOGINS'
          Only list revisions checked in by specified logins.  See
          Note: log options.

`login'
     Prompt for password for authenticating server.  See Note: Password
     authentication client.

`logout'
     Remove stored password for authenticating server.  See Note:
     Password authentication client.

`rdiff [OPTIONS] MODULES...'
     Show differences between releases.  See Note: rdiff.

    `-c'
          Context diff output format (default).  See Note: rdiff
          options.

    `-D DATE'
          Select revisions based on DATE.  See Note: Common options.

    `-f'
          Use head revision if tag/date not found.  See Note: Common
          options.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r REV'
          Select revisions based on REV.  See Note: Common options.

    `-s'
          Short patch - one liner per file.  See Note: rdiff options.

    `-t'
          Top two diffs - last change made to the file.  See Note: diff
          options.

    `-u'
          Unidiff output format.  See Note: rdiff options.

    `-V VERS'
          Use RCS Version VERS for keyword expansion (obsolete).  See
          Note: rdiff options.

`release [OPTIONS] DIRECTORY'
     Indicate that a directory is no longer in use.  See Note:
     release.

    `-d'
          Delete the given directory.  See Note: release options.

`remove [OPTIONS] [FILES...]'
     Remove an entry from the repository.  See Note: Removing files.

    `-f'
          Delete the file before removing it.  See Note: Removing
          files.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

`rtag [OPTIONS] TAG MODULES...'
     Add a symbolic tag to a module.  See Note: Revisions and Note:
     Branching and merging.

    `-a'
          Clear tag from removed files that would not otherwise be
          tagged.  See Note: Tagging add/remove.

    `-b'
          Create a branch named TAG.  See Note: Branching and merging.

    `-D DATE'
          Tag revisions as of DATE.  See Note: Tagging by date/tag.

    `-d'
          Delete TAG.  See Note: Modifying tags.

    `-F'
          Move TAG if it already exists.  See Note: Modifying tags.

    `-f'
          Force a head revision match if tag/date not found.  See Note:
          Tagging by date/tag.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-n'
          No execution of tag program.  See Note: Common options.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r REV'
          Tag existing tag REV.  See Note: Tagging by date/tag.

`status [OPTIONS] FILES...'
     Display status information in a working directory.  See Note: File
     status.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-v'
          Include tag information for file.  See Note: Tags.

`tag [OPTIONS] TAG [FILES...]'
     Add a symbolic tag to checked out version of files.  See Note:
     Revisions and Note: Branching and merging.

    `-b'
          Create a branch named TAG.  See Note: Branching and merging.

    `-c'
          Check that working files are unmodified.  See Note: Tagging
          the working directory.

    `-D DATE'
          Tag revisions as of DATE.  See Note: Tagging by date/tag.

    `-d'
          Delete TAG.  See Note: Modifying tags.

    `-F'
          Move TAG if it already exists.  See Note: Modifying tags.

    `-f'
          Force a head revision match if tag/date not found.  See Note:
          Tagging by date/tag.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r REV'
          Tag existing tag REV.  See Note: Tagging by date/tag.

`unedit [OPTIONS] [FILES...]'
     Undo an edit command.  See Note: Editing files.

    `-a ACTIONS'
          Specify actions for temporary watch, where ACTIONS is `edit',
          `unedit', `commit', `all', or `none'.  See Note: Editing
          files.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

`update [OPTIONS] [FILES...]'
     Bring work tree in sync with repository.  See Note: update.

    `-A'
          Reset any sticky tags/date/options.  See Note: Sticky tags
          and Note: 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 Note: Common
          options.

    `-d'
          Create directories.  See Note: update options.

    `-f'
          Use head revision if tag/date not found.  See Note: Common
          options.

    `-I IGN'
          More files to ignore (! to reset).  See Note: import
          options.

    `-j REV'
          Merge in changes.  See Note: update options.

    `-k KFLAG'
          Use KFLAG keyword expansion.  See Note: Substitution modes.

    `-l'
          Local; run only in current working directory.  Note:
          Recursive behavior.

    `-P'
          Prune empty directories.  See Note: Moving directories.

    `-p'
          Check out files to standard output (avoids stickiness).  See
          Note: update options.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

    `-r TAG'
          Checkout revision TAG (is sticky).  See Note: Common
          options.

    `-W SPEC'
          More wrappers.  See Note: 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 Note:
     Setting a watch.

     add/remove: add or remove notification on actions.  See Note:
     Getting Notified.

    `-a ACTIONS'
          Specify actions for temporary watch, where ACTIONS is `edit',
          `unedit', `commit', `all', or `none'.  See Note: Editing
          files.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.

`watchers [OPTIONS] [FILES...]'
     See who is watching a file.  See Note: Watch information.

    `-l'
          Local; run only in current working directory.  See Note:
          Recursive behavior.

    `-R'
          Operate recursively (default).  Note: Recursive behavior.


automatically generated by info2www version 1.2.2.9