Copyright (C) 2000-2012 |
GNU Info (cvs.info)Invoking CVSQuick 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 |