|
From: <pa...@us...> - 2003-07-19 14:43:45
|
Update of /cvsroot/emc/documents/lyx In directory sc8-pr-cvs1:/tmp/cvs-serv7451/lyx Modified Files: Dev_Developer.lyx Log Message: cvs notes added Index: Dev_Developer.lyx =================================================================== RCS file: /cvsroot/emc/documents/lyx/Dev_Developer.lyx,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** Dev_Developer.lyx 5 Jul 2003 01:15:03 -0000 1.1 --- Dev_Developer.lyx 19 Jul 2003 14:43:42 -0000 1.2 *************** *** 936,938 **** --- 936,1295 ---- \newline cvs commit: Committing . + \layout Section + + CVS Usage + \layout Standard + + Much of the following has been extracted from http://cvsbook.red-bean.com/cvsbook.h + tml + \newline + + \layout Standard + + + \series bold + Tip: + \series default + add the line + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + \SpecialChar ~ + export CVS_RSH=ssh + \layout Standard + + to the .bashrc file in your home directory - Saves having to remember it + each time. + \newline + + \layout Standard + + CVS commands follow this form: + \layout Standard + + cvs [GLOBAL_OPTIONS] COMMAND [OPTIONS] [FILES] + \newline + + \layout Standard + + The second set of options is sometimes called command options. + Because there are so many of them, though, I'll just call them "options" + in most places to save space. + + \newline + + \layout Standard + + Many commands are meant to be run within a working copy and, therefore, + may be invoked without file arguments. + These commands default to all of the files in the current directory and + below. + So when I refer to the "file" or "files" in the text, Depending on how + you invoked CVS, these files may or may not have been explicitly mentioned + on the command line. + \newline + + \layout Subsection* + + Global Options + \layout Standard + + Here are a few of the global options to CVS. + + \newline + + \layout Standard + + -d REPOSITORY + \newline + + \layout Standard + + This specifies the repository, which might be an absolute pathname or a + more complex expression involving a connection method, username and host, + and path. + If it is an expression specifying a connection method, the general syntax + is: + \layout Standard + + :METHOD:USER@HOSTNAME:PATH_TO_REPOSITORY + \newline + Here are examples using each of the connection methods: + \newline + + \layout Standard + + :ext:jb...@cv...:/cvsroot/emc - Connects using rsh, ssh, or + some other external connection program. + If the $CVS_RSH environment variable is unset, this defaults to rsh; otherwise, + it uses the value of that variable. + + \layout Standard + + :server:jb...@cv...:/cvsroot/emc - Like :ext:, but uses CVS's + internal implementation of rsh. + (This may not be available on all platforms.) + \layout Standard + + :pserver:jb...@cv...:/cvsroot/emc - Connects using the password + authenticating server (see The Password-Authenticating Server in Repository + Administration; see also the login command.) + \layout Standard + + :local:jblogs@localhost:/var/cvs/emc - Accesses a local repository directly, + as though only the absolute path to the repository had been given. + + \newline + + \layout Standard + + --help [COMMAND] or -H [COMMAND] + \newline + These two options are synonymous. + If no COMMAND is specified, a basic usage message is printed to the standard + output. + If COMMAND is specified, a usage message for that command is printed. + + \newline + + \layout Standard + + --help-options + \newline + + \layout Standard + + Prints out a list of all global options to CVS, with brief explanations. + \newline + + \layout Standard + + --help-synonyms + \newline + + \layout Standard + + Prints out a list of CVS commands and their short forms ("up" for "update", + and so on). + \newline + + \layout Standard + + -n + \newline + + \layout Standard + + Doesn't change any files in the working copy or in the repository. + In other words, the command is executed as a "dry run" - CVS goes through + most of the steps of the command but stops short of actually running it. + \newline + + \layout Standard + + This is useful when you want to see what the command would have done had + you actually run it. + One common scenario is when you want to see what files in your working + directory have been modified, but not do a full update (which would bring + down changes from the repository). + By running cvs -n update, you can see a summary of what's been done locally, + without changing your working copy. + \newline + + \layout Standard + + -q + \newline + + \layout Standard + + This tells CVS to be moderately quiet by suppressing the printing of unimportant + informational messages. + What is considered "important" depends on the command. + For example, in updates, the messages that CVS normally prints on entering + each subdirectory of the working copy are suppressed, but the one-line + status messages for modified or updated files are still printed. + \newline + + \layout Standard + + -Q + \newline + + \layout Standard + + This tells CVS to be very quiet, by suppressing all output except what is + absolutely necessary to complete the command. + Commands whose sole purpose is to produce some output (such as diff or + annotate), of course, still give that output. + However, commands that could have an effect independent of any messages + that they may print (such as update or commit) print nothing. + + \newline + + \layout Standard + + -v or --version + \newline + + \layout Standard + + Causes CVS to print out its version and copyright information and then exit + with no error. + \newline + + \layout Standard + + -z GZIPLEVEL + \newline + + \layout Standard + + Sets the compression level on communications with the server. + The argument GZIPLEVEL must be a number from 1 to 9. + Level 1 is minimal compression (very fast, but doesn't compress much); + Level 9 is highest compression (uses a lot of CPU time, but sure does squeeze + the data). + Level 9 is only useful on very slow network connections. + Most people find levels between 3 and 5 to be most beneficial. + \newline + + \layout Standard + + A space between -z and its argument is optional. + \layout Subsection* + + Example Commands + \layout Subsubsection* + + Checkout + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc checkout emc + \layout Standard + + checkout is used to aquire a local working copy of the emc directory. + Alternative names are co and get. + \layout Standard + + This can also be used with a -D option to get date specific versions of + the code. + For example: + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc -D + \begin_inset Quotes erd + \end_inset + + yesterday + \begin_inset Quotes erd + \end_inset + + emc + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc -D + \begin_inset Quotes erd + \end_inset + + 2003-01-12 + \begin_inset Quotes erd + \end_inset + + emc + \layout Standard + + In the first example, all files that were modified prior to yesterday will + be checked out, in the second, all changes before 12th Jan 2003. + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc -r test_5_1_03 emc + \layout Standard + + This checks out all the files that have been tagged (or in the branch) test_5_1_ + 03. + \newline + Tags and dates are stcky and any further check outs will use the same tag + unless + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc -A emc + \layout Standard + + is used. + \layout Subsubsection* + + Commit + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc commit -m + \begin_inset Quotes erd + \end_inset + + foo bar edit + \begin_inset Quotes erd + \end_inset + + + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc ci -m + \begin_inset Quotes erd + \end_inset + + foo bar edit + \begin_inset Quotes erd + \end_inset + + + \layout Standard + + Commits changes from the local working directory to the central repository. + This only works with checked out branches or the main trunk. + If the sources have been checked out with a tag or date, then commits will + fail (unless the tag is for a branch). + \layout Standard + + -m + \begin_inset Quotes erd + \end_inset + + message + \begin_inset Quotes erd + \end_inset + + is compulsory. + \layout Subsubsection* + + Add + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc add new_file + \layout Standard + + \SpecialChar ~ + \SpecialChar ~ + cvs -z3 -d:ext:jb...@cv...:/cvsroot/emc new new_file + \layout Standard + + Adds a new file or directory to the repository. + The new addition will not be visable untill a cvs commit has also taken + place - Note the comments about sticky tags also apply. \the_end |