home *** CD-ROM | disk | FTP | other *** search
GNU Info File | 1996-10-13 | 31.2 KB | 638 lines |
- This is Info file cvs.info, produced by Makeinfo-1.64 from the input
- file /ade-source/fsf/cvs/doc/cvs.texinfo.
-
- Copyright (C) 1992, 1993 Signum Support AB Copyright (C) 1993, 1994
- Free Software Foundation, Inc.
-
- Permission is granted to make and distribute verbatim copies of this
- manual provided the copyright notice and this permission notice are
- preserved on all copies.
-
- Permission is granted to copy and distribute modified versions of
- this manual under the conditions for verbatim copying, provided also
- that the section entitled "GNU General Public License" is included
- exactly as in the original, and provided that the entire resulting
- derived work is distributed under the terms of a permission notice
- identical to this one.
-
- Permission is granted to copy and distribute translations of this
- manual into another language, under the above conditions for modified
- versions, except that the section entitled "GNU General Public License"
- and this permission notice may be included in translations approved by
- the Free Software Foundation instead of in the original English.
-
- File: cvs.info, Node: Environment variables, Next: Troubleshooting, Prev: Administrative files, Up: Top
-
- All environment variables which affect CVS
- ******************************************
-
- This is a complete list of all environment variables that affect CVS.
-
- `$CVSIGNORE'
- A whitespace-separated list of file name patterns that CVS should
- ignore. *Note cvsignore::.
-
- `$CVSWRAPPERS'
- A whitespace-separated list of file name patterns that CVS should
- treat as wrappers. *Note Wrappers::.
-
- `$CVSREAD'
- If this is set, `checkout' and `update' will try hard to make the
- files in your working directory read-only. When this is not set,
- the default behavior is to permit modification of your working
- files.
-
- `$CVSROOT'
- Should contain the full pathname to the root of the CVS source
- repository (where the RCS history files are kept). This
- information must be available to CVS for most commands to execute;
- if `$CVSROOT' is not set, or if you wish to override it for one
- invocation, you can supply it on the command line: `cvs -d cvsroot
- cvs_command...' Once you have checked out a working directory, CVS
- stores the appropriate root (in the file `CVS/Root'), so normally
- you only need to worry about this when initially checking out a
- working directory.
-
- `$EDITOR'
- `$CVSEDITOR'
- Specifies the program to use for recording log messages during
- commit. If not set, the default is `/usr/ucb/vi'. `$CVSEDITOR'
- overrides `$EDITOR'. `$CVSEDITOR' does not exist in CVS 1.3, but
- the next release will probably include it.
-
- `$PATH'
- If `$RCSBIN' is not set, and no path is compiled into CVS, it will
- use `$PATH' to try to find all programs it uses.
-
- `$RCSBIN'
- This is the value CVS is using for where to find RCS binaries.
- *Note Global options::, for a description of how to specify this.
- If not set, a compiled-in value is used, or your `$PATH' is
- searched.
-
- `$HOME'
- `$HOMEPATH'
- Used to locate the directory where the `.cvsrc' file is searched
- (`$HOMEPATH' is used for Windows-NT). *note ~/.cvsrc::.
-
- `$CVS_RSH'
- Specifies the external program which CVS connects with, when
- `:ext:' access method is specified. *note Connecting via rsh::..
-
- `$CVS_SERVER'
- Used in client-server mode when accessing a remote repository
- using RSH. It specifies the name of the program to start on the
- server side when accessing a remote repository using RSH. The
- default value is `cvs'. *note Connecting via rsh::.
-
- `$CVS_PASSFILE'
- Used in client-server mode when accessing the `cvs login server'.
- Default value is `$HOME/.cvspass'. *note Password authentication
- client::.
-
- `$CVS_PASSWORD'
- Used in client-server mode when accessing the `cvs login server'.
- *note Password authentication client::.
-
- `$CVS_CLIENT_PORT'
- Used in client-server mode when accessing the server via Kerberos.
- *note Kerberos authenticated::.
-
- `$CVS_RCMD_PORT'
- Used in client-server mode. If set, specifies the port number to
- be used when accessing the RCMD demon on the server side.
- (Currently not used for Unix clients).
-
- `$CVS_CLIENT_LOG'
- Used for debugging only in client-server mode. If set, everything
- send to the server is logged into ``$CVS_CLIENT_LOG'.in' and
- everything send from the server is logged into
- ``$CVS_CLIENT_LOG'.out'.
-
- `$CVS_SERVER_SLEEP'
- Used only for debugging the server side in client-server mode. If
- set, delays the start of the server child process the the
- specified amount of seconds so that you can attach to it with a
- debugger.
-
- `$CVS_IGNORE_REMOTE_ROOT'
- (What is the purpose of this variable?)
-
- `$COMSPEC'
- Used under OS/2 only. It specifies the name of the command
- interpreter and defaults to CMD.EXE.
-
- `$TMPDIR'
- `$TMP'
- `$TEMP'
- Directory in which temporary files are located. Those parts of
- CVS which are implemented using RCS inspect the above variables in
- the order they appear above and the first value found is taken; if
- none of them are set, a host-dependent default is used, typically
- `/tmp'. The CVS server uses `TMPDIR'. *Note Global options::,
- for a description of how to specify this. Some parts of CVS will
- always use `/tmp' (via the `tmpnam' function provided by the
- system).
-
- On Windows NT, `TMP' is used (via the `_tempnam' function provided
- by the system).
-
- The `patch' program which is used by the CVS client uses `TMPDIR',
- and if it is not set, uses `/tmp' (at least with GNU patch 2.1).
-
- CVS invokes RCS to perform certain operations. The following
- environment variables affect RCS. Note that if you are using the
- client/server CVS, these variables need to be set on the server side
- (which may or not may be possible depending on how you are connecting).
- There is probably not any need to set any of them, however.
-
- `$LOGNAME'
- `$USER'
- If set, they affect who RCS thinks you are. If you have trouble
- checking in files it might be because your login name differs from
- the setting of e.g. `$LOGNAME'.
-
- `$RCSINIT'
- Options prepended to the argument list, separated by spaces. A
- backslash escapes spaces within an option. The `$RCSINIT' options
- are prepended to the argument lists of most RCS commands.
-
- File: cvs.info, Node: Troubleshooting, Next: Copying, Prev: Environment variables, Up: Top
-
- Troubleshooting
- ***************
-
- * Menu:
-
- * Magic branch numbers:: Magic branch numbers
-
- File: cvs.info, Node: Magic branch numbers, Up: Troubleshooting
-
- Magic branch numbers
- ====================
-
- Externally, branch numbers consist of an odd number of dot-separated
- decimal integers. *Note Revision numbers::. That is not the whole
- truth, however. For efficiency reasons CVS sometimes inserts an extra 0
- in the second rightmost position (1.2.3 becomes 1.2.0.3, 8.9.10.11.12
- becomes 8.9.10.11.0.12 and so on).
-
- CVS does a pretty good job at hiding these so called magic branches,
- but in a few places the hiding is incomplete:
-
- * The magic branch number appears in the output from `cvs log'.
-
- * You cannot specify a symbolic branch name to `cvs admin'.
-
- You can use the `admin' command to reassign a symbolic name to a
- branch the way RCS expects it to be. If `R4patches' is assigned to the
- branch 1.4.2 (magic branch number 1.4.0.2) in file `numbers.c' you can
- do this:
-
- $ cvs admin -NR4patches:1.4.2 numbers.c
-
- It only works if at least one revision is already committed on the
- branch. Be very careful so that you do not assign the tag to the wrong
- number. (There is no way to see how the tag was assigned yesterday).
-
- File: cvs.info, Node: Copying, Next: Index, Prev: Troubleshooting, Up: Top
-
- GNU GENERAL PUBLIC LICENSE
- **************************
-
- File: cvs.info, Node: Index, Prev: Copying, Up: Top
-
- Index
- *****
-
- * Menu:
-
- * -j (merging branches): Merging a branch.
- * -k (RCS kflags): Substitution modes.
- * .# files: update output.
- * .bashrc, setting CVSROOT in: Specifying a repository.
- * .cshrc, setting CVSROOT in: Specifying a repository.
- * .cvsrc file: ~/.cvsrc.
- * .profile, setting CVSROOT in: Specifying a repository.
- * .tcshrc, setting CVSROOT in: Specifying a repository.
- * /usr/local/cvsroot, as example repository: Repository.
- * :ext:: Connecting via rsh.
- * :kserver:: Kerberos authenticated.
- * :local:: Repository.
- * :pserver:: Password authentication client.
- * :server:: Connecting via rsh.
- * <<<<<<<: Conflicts example.
- * =======: Conflicts example.
- * >>>>>>>: Conflicts example.
- * __ files (VMS): update output.
- * A sample session: A sample session.
- * abandoning work: Editing files.
- * About this manual: Preface.
- * add (subcommand): Adding files.
- * Adding a tag: Tags.
- * Adding files: Adding files.
- * Admin (subcommand): admin.
- * Administrative files (intro): Intro administrative files.
- * Administrative files (reference): Administrative files.
- * Administrative files, editing them: Intro administrative files.
- * ALL in commitinfo: commitinfo.
- * annotate (subcommand): annotate.
- * Atomic transactions, lack of: Concurrency.
- * authenticated client, using: Password authentication client.
- * authenticating server, setting up: Password authentication server.
- * Author keyword: Keyword list.
- * Automatically ignored files: cvsignore.
- * Avoiding editor invocation: Common options.
- * Binary files: Binary files.
- * Branch merge example: Merging a branch.
- * Branch number: Revision numbers.
- * Branch numbers: Creating a branch.
- * Branch, creating a: Creating a branch.
- * Branch, vendor-: Tracking sources.
- * Branches: Branches.
- * Branches motivation: Branches motivation.
- * Branches, copying changes between: Merging.
- * Branches, sticky: Sticky tags.
- * Bringing a file up to date: Updating a file.
- * Bugs, known in this manual: BUGS.
- * Bugs, reporting (manual): BUGS.
- * Changes, copying between branches: Merging.
- * Changing a log message: admin options.
- * checked out copy, keeping: Keeping a checked out copy.
- * Checkin program: modules.
- * Checking commits: commitinfo.
- * Checking out source: Getting the source.
- * Checkout (subcommand): checkout.
- * Checkout program: modules.
- * checkout, as term for getting ready to edit: Editing files.
- * Checkout, example: Getting the source.
- * choosing, reserved or unreserved checkouts: Choosing a model.
- * Cleaning up: Cleaning up.
- * Client/Server Operation: Remote repositories.
- * Co (subcommand): checkout.
- * Command reference: Invoking CVS.
- * Command structure: Structure.
- * Comment leader: admin examples.
- * Commit (subcommand): commit.
- * Commit files: commit files.
- * Commit, when to: When to commit.
- * Commitinfo: commitinfo.
- * Committing changes: Committing your changes.
- * Common options: Common options.
- * Common syntax of info files: syntax.
- * COMSPEC: Environment variables.
- * Conflict markers: Conflicts example.
- * Conflict resolution: Conflicts example.
- * Conflicts (merge example): Conflicts example.
- * Contributors (CVS program): What is CVS?.
- * Contributors (manual): Credits.
- * Copying changes: Merging.
- * Correcting a log message: admin options.
- * Creating a branch: Creating a branch.
- * Creating a project: Starting a new project.
- * Creating a repository: Creating a repository.
- * Credits (CVS program): What is CVS?.
- * Credits (manual): Credits.
- * CVS 1.6, and watches: Watches Compatibility.
- * CVS command structure: Structure.
- * CVS passwd file: Password authentication server.
- * CVS, history of: What is CVS?.
- * CVS, introduction to: What is CVS?.
- * CVS_CLIENT_LOG: Environment variables.
- * CVS_CLIENT_PORT: Kerberos authenticated.
- * CVS_IGNORE_REMOTE_ROOT: Environment variables.
- * CVS_PASSFILE, environment variable: Password authentication client.
- * CVS_PASSWORD, environment variable: Password authentication client.
- * CVS_RCMD_PORT: Environment variables.
- * CVS_RSH: Environment variables.
- * CVS_SERVER: Connecting via rsh.
- * CVS_SERVER_SLEEP: Environment variables.
- * CVSEDITOR: Environment variables.
- * CVSEDITOR, environment variable: Committing your changes.
- * CVSIGNORE: Environment variables.
- * cvsignore (admin file), global: cvsignore.
- * CVSREAD: Environment variables.
- * CVSREAD, overriding: Global options.
- * cvsroot: Repository.
- * CVSROOT: Environment variables.
- * CVSROOT (file): Administrative files.
- * CVSROOT, environment variable: Specifying a repository.
- * CVSROOT, module name: Intro administrative files.
- * CVSROOT, multiple repositories: Multiple repositories.
- * CVSROOT, overriding: Global options.
- * CVSUMASK: File permissions.
- * CVSWRAPPERS: Environment variables.
- * cvswrappers (admin file): Wrappers.
- * CVSWRAPPERS, environment variable: Wrappers.
- * Date keyword: Keyword list.
- * Dates: Common options.
- * Decimal revision number: Revision numbers.
- * DEFAULT in commitinfo: commitinfo.
- * DEFAULT in editinfo: editinfo.
- * Defining a module: Defining the module.
- * Defining modules (intro): Intro administrative files.
- * Defining modules (reference manual): modules.
- * Deleting files: Removing files.
- * Deleting revisions: admin options.
- * Deleting sticky tags: Sticky tags.
- * Descending directories: Recursive behavior.
- * Diff: Viewing differences.
- * Diff (subcommand): diff.
- * Differences, merging: Merging two revisions.
- * Directories, moving: Moving directories.
- * Directory, descending: Recursive behavior.
- * Disjoint repositories: Multiple repositories.
- * Distributing log messages: loginfo.
- * driver.c (merge example): Conflicts example.
- * edit (subcommand): Editing files.
- * editinfo (admin file): editinfo.
- * Editing administrative files: Intro administrative files.
- * Editing the modules file: Defining the module.
- * EDITOR: Environment variables.
- * Editor, avoiding invocation of: Common options.
- * EDITOR, environment variable: Committing your changes.
- * EDITOR, overriding: Global options.
- * Editor, specifying per module: editinfo.
- * editors (subcommand): Watch information.
- * emerge: Conflicts example.
- * Environment variables: Environment variables.
- * Errors, reporting (manual): BUGS.
- * Example of a work-session: A sample session.
- * Example of merge: Conflicts example.
- * Example, branch merge: Merging a branch.
- * Export (subcommand): export.
- * Export program: modules.
- * Fetching source: Getting the source.
- * File locking: Multiple developers.
- * File permissions: File permissions.
- * File status: File status.
- * Files, moving: Moving files.
- * Files, reference manual: Administrative files.
- * Fixing a log message: admin options.
- * Forcing a tag match: Common options.
- * Form for log message: rcsinfo.
- * Format of CVS commands: Structure.
- * Getting started: A sample session.
- * Getting the source: Getting the source.
- * Global cvsignore: cvsignore.
- * Global options: Global options.
- * Group: File permissions.
- * Header keyword: Keyword list.
- * History (subcommand): history.
- * History browsing: History browsing.
- * History file: history file.
- * History files: Repository files.
- * History of CVS: What is CVS?.
- * HOME: Environment variables.
- * HOMEPATH: Environment variables.
- * Id keyword: Keyword list.
- * Ident (shell command): Using keywords.
- * Identifying files: Keyword substitution.
- * Ignored files: cvsignore.
- * Ignoring files: cvsignore.
- * Import (subcommand): import.
- * Importing files: From files.
- * Importing files, from other version control systesm: From other version control systems.
- * Importing modules: First import.
- * Index: Index.
- * Info files (syntax): syntax.
- * Informing others: Informing others.
- * init (subcommand): Creating a repository.
- * Introduction to CVS: What is CVS?.
- * Invoking CVS: Invoking CVS.
- * Isolation: History browsing.
- * Join: Merging a branch.
- * keeping a checked out copy: Keeping a checked out copy.
- * kerberos: Kerberos authenticated.
- * Keyword expansion: Keyword substitution.
- * Keyword substitution: Keyword substitution.
- * Kflag: Substitution modes.
- * kinit: Kerberos authenticated.
- * Known bugs in this manual: BUGS.
- * Layout of repository: Repository.
- * Left-hand options: Global options.
- * Linear development: Revision numbers.
- * List, mailing list: What is CVS?.
- * Locally Added: File status.
- * Locally Modified: File status.
- * Locally Removed: File status.
- * Locker keyword: Keyword list.
- * Locking files: Multiple developers.
- * locks, cvs: Concurrency.
- * Log (subcommand): log.
- * Log information, saving: history file.
- * Log keyword: Keyword list.
- * Log keyword, selecting comment leader: admin examples.
- * Log message entry: Committing your changes.
- * Log message template: rcsinfo.
- * Log message, correcting: admin options.
- * Log messages: loginfo.
- * Log messages, editing: editinfo.
- * Login (subcommand): Password authentication client.
- * loginfo (admin file): loginfo.
- * LOGNAME: Environment variables.
- * Mail, automatic mail on commit: Informing others.
- * Mailing list: What is CVS?.
- * Mailing log messages: loginfo.
- * Main trunk (intro): Revision numbers.
- * Main trunk and branches: Branches.
- * Many repositories: Multiple repositories.
- * Markers, conflict: Conflicts example.
- * Merge, an example: Conflicts example.
- * Merge, branch example: Merging a branch.
- * Merging: Merging.
- * Merging a branch: Merging a branch.
- * Merging a file: Updating a file.
- * Merging two revisions: Merging two revisions.
- * Modifications, copying between branches: Merging.
- * Module status: modules.
- * Module, defining: Defining the module.
- * Modules (admin file): modules.
- * Modules (intro): Basic concepts.
- * Modules file: Intro administrative files.
- * Modules file, changing: Defining the module.
- * Motivation for branches: Branches motivation.
- * Moving directories: Moving directories.
- * Moving files: Moving files.
- * Multiple developers: Multiple developers.
- * Multiple repositories: Multiple repositories.
- * Name keyword: Keyword list.
- * Name, symbolic (tag): Tags.
- * Needs Checkout: File status.
- * Needs Merge: File status.
- * Needs Patch: File status.
- * Newsgroups: What is CVS?.
- * notify (admin file): Getting Notified.
- * Nroff (selecting comment leader): admin examples.
- * Number, branch: Revision numbers.
- * Number, revision-: Revision numbers.
- * option defaults: ~/.cvsrc.
- * Options, global: Global options.
- * Outdating revisions: admin options.
- * Overlap: Updating a file.
- * Overriding CVSREAD: Global options.
- * Overriding CVSROOT: Global options.
- * Overriding EDITOR: Global options.
- * Overriding RCSBIN: Global options.
- * Overriding TMPDIR: Global options.
- * Parallel repositories: Multiple repositories.
- * passwd (admin file): Password authentication server.
- * password client, using: Password authentication client.
- * password server, setting up: Password authentication server.
- * PATH: Environment variables.
- * Per-module editor: editinfo.
- * Policy: When to commit.
- * Precommit checking: commitinfo.
- * Preface: Preface.
- * Pserver (subcommand): Password authentication server.
- * RCS history files: Repository files.
- * RCS keywords: Keyword list.
- * RCS revision numbers: Tags.
- * RCS, importing files from: From other version control systems.
- * RCS-style locking: Multiple developers.
- * RCSBIN: Environment variables.
- * RCSBIN, overriding: Global options.
- * RCSfile keyword: Keyword list.
- * rcsinfo (admin file): rcsinfo.
- * RCSINIT: Environment variables.
- * Rdiff (subcommand): rdiff.
- * read-only files, and -r: Global options.
- * read-only files, and CVSREAD: Environment variables.
- * read-only files, and watches: Setting a watch.
- * read-only files, in repository: File permissions.
- * Read-only mode: Global options.
- * Recursive (directory descending): Recursive behavior.
- * Reference manual (files): Administrative files.
- * Reference manual for variables: Environment variables.
- * Reference, commands: Invoking CVS.
- * Release (subcommand): release.
- * Releases, revisions and versions: Versions revisions releases.
- * Releasing your working copy: Cleaning up.
- * Remote repositories: Remote repositories.
- * Remove (subcommand): Removing files.
- * Removing a change: Merging two revisions.
- * Removing files: Removing files.
- * Removing your working copy: Cleaning up.
- * Renaming directories: Moving directories.
- * Renaming files: Moving files.
- * Replacing a log message: admin options.
- * Reporting bugs (manual): BUGS.
- * Repositories, multiple: Multiple repositories.
- * Repositories, remote: Remote repositories.
- * Repository (intro): Repository.
- * Repository, example: Repository.
- * Repository, how data is stored: Repository storage.
- * Repository, setting up: Creating a repository.
- * reserved checkouts: Multiple developers.
- * Resetting sticky tags: Sticky tags.
- * Resolving a conflict: Conflicts example.
- * Restoring old version of removed file: Sticky tags.
- * Resurrecting old version of dead file: Sticky tags.
- * Retrieving an old revision using tags: Tags.
- * reverting to repository version: Editing files.
- * Revision keyword: Keyword list.
- * Revision management: Revision management.
- * Revision numbers: Revision numbers.
- * Revision tree: Revision numbers.
- * Revision tree, making branches: Branches.
- * Revisions, merging differences between: Merging two revisions.
- * Revisions, versions and releases: Versions revisions releases.
- * Right-hand options: Common options.
- * rsh: Connecting via rsh.
- * Rtag (subcommand): rtag.
- * rtag, creating a branch using: Creating a branch.
- * Saving space: admin options.
- * SCCS, importing files from: From other version control systems.
- * Security: File permissions.
- * setgid: File permissions.
- * Setting up a repository: Creating a repository.
- * setuid: File permissions.
- * Signum Support: Preface.
- * Source keyword: Keyword list.
- * Source, getting CVS source: What is CVS?.
- * Source, getting from CVS: Getting the source.
- * Specifying dates: Common options.
- * Spreading information: Informing others.
- * Starting a project with CVS: Starting a new project.
- * State keyword: Keyword list.
- * Status (subcommand): status.
- * Status of a file: File status.
- * Status of a module: modules.
- * sticky date: Sticky tags.
- * Sticky tags: Sticky tags.
- * Sticky tags, resetting: Sticky tags.
- * Storing log messages: loginfo.
- * Structure: Structure.
- * Subdirectories: Recursive behavior.
- * Support, getting CVS support: Preface.
- * Symbolic name (tag): Tags.
- * Syntax of info files: syntax.
- * Tag (subcommand): tag.
- * Tag program: modules.
- * tag, command, introduction: Tags.
- * tag, example: Tags.
- * Tag, retrieving old revisions: Tags.
- * Tag, symbolic name: Tags.
- * taginfo: user-defined logging.
- * Tags: Tags.
- * Tags, sticky: Sticky tags.
- * tc, Trivial Compiler (example): A sample session.
- * Team of developers: Multiple developers.
- * TEMP: Environment variables.
- * Template for log message: rcsinfo.
- * temporary files, location of: Environment variables.
- * Third-party sources: Tracking sources.
- * Time: Common options.
- * timezone, in input: Common options.
- * timezone, in output: log.
- * TMP: Environment variables.
- * TMPDIR: Environment variables.
- * TMPDIR, overriding: Global options.
- * Trace: Global options.
- * Traceability: History browsing.
- * Tracking sources: Tracking sources.
- * Transactions, atomic, lack of: Concurrency.
- * Trivial Compiler (example): A sample session.
- * Typical repository: Repository.
- * umask, for repository files: File permissions.
- * Undoing a change: Merging two revisions.
- * unedit (subcommand): Editing files.
- * Unknown: File status.
- * unreserved checkouts: Multiple developers.
- * Unresolved Conflict: File status.
- * Up-to-date: File status.
- * Update (subcommand): update.
- * Update program: modules.
- * update, introduction: Updating a file.
- * Updating a file: Updating a file.
- * USER: Environment variables.
- * users (admin file): Getting Notified.
- * Vendor: Tracking sources.
- * Vendor branch: Tracking sources.
- * Versions, revisions and releases: Versions revisions releases.
- * Viewing differences: Viewing differences.
- * watch add (subcommand): Getting Notified.
- * watch off (subcommand): Setting a watch.
- * watch on (subcommand): Setting a watch.
- * watch remove (subcommand): Getting Notified.
- * watchers (subcommand): Watch information.
- * Watches: Watches.
- * Wdiff (import example): First import.
- * What (shell command): Using keywords.
- * What branches are good for: Branches motivation.
- * What is CVS?: What is CVS?.
- * When to commit: When to commit.
- * Work-session, example of: A sample session.
- * Working copy: Multiple developers.
- * Working copy, removing: Cleaning up.
- * Wrappers: Wrappers.
- * zone, time, in input: Common options.
- * zone, time, in output: log.
-
-
-