tkcvs.1

TKCVS Source Code For CVS。

.TP
.B cvscfg(colourA) cvscfg(colourB)
Hilight colours for revision-log boxes
.TP
.B cvscfg(tagdepth)
Number of tags you want to see for each revision on the branching diagram before it says "more..." and offers a pop-up to show the rest
.TP
.B cvscfg(toomany_tags)
Number of tags in a Subversion repository that's "too many", ie. will take longer to proecess for the branch diagram than you're willing to wait.  (Building a branch diagram for Subversion is very inefficient.) If there are more than that number and cvscfg(confirm_prompt) is true, a dialog will appear asking whether to process the tags or to draw the diagram without them.
.TP
.B cvscfg(tagcolour,tagstring)
Colors for marking tags. For example:
.RS
    set cvscfg(tagcolour,tkcvs_r6) Purple
.RE
.SS Module browser
.TP
.B cvscfg(aliasfolder)
In the CVS module browser, if true this will cause the alias modules to be grouped in one folder. Cleans up clutter if there are a lot of aliases.
.SS User preferences
.TP
.B cvscfg(allfiles)
Set this to false to see normal files only in the directory browser. Set it to true to see all files including hidden files.
.TP
.B cvscfg(auto_status)
Set the default for automatic status-refresh of a CVS controlled directory. Automatic updates are done when a directory is entered and after some operations.
.TP
.B cvscfg(auto_tag)
Whether to tag the merged-from revision when using TkCVS to merge different revisions of files by default.  A dialog still lets you change your mind, regardless of the default.
.TP
.B cvscfg(confirm_prompt)
Ask for confirmation before performing an operation(true or false)
.TP
.B cvscfg(dateformat)
Format for the date string shown in the "Date" column, for example "%Y/%m/%d %H:%M"
.TP
.B cvscfg(cvslock)
Set to true to turn on the ability to use cvs-admin locking from the GUI.
.TP
.B cvscfg(econtrol)
Set this to true to turn on the ability to use CVS Edit and Unedit, if your site is configured to allow the feature.
.TP
.B cvscfg(editor)
Preferred default editor
.TP
.B cvscfg(editors)
String pairs giving the editor-command and string-match-pattern, for deciding which editor to use
.TP
.B cvscfg(editorargs)
Command-line arguments to send to the default editing program.
.TP
.B cvscfg(ldetail)
Detail level for status reports (latest, summary, verbose)
.TP
.B cvscfg(mergetoformat)
.TP
.B cvscfg(mergefromformat)
Format for mergeto- and mergefrom- tags.  The _BRANCH_ part must be
left as-is, but you can change the prefix and the date format, for
example "mergeto_BRANCH_%d%b%y".  The date format must be the same
for both.  CVS rule: a tag must not contain the characters `$,.:;@'
.TP
.B cvscfg(rdetail)
Detail for repository and workdir reports (terse, summary, verbose)
.TP
.B cvscfg(recurse)
Whether reports are recursive (true or false)
.TP
.B cvscfg(savelines)
How many lines to keep in the trace window
.TP
.B cvscfg(status_filter)
Filter out unknown files (status "?") from CVS Check and CVS Update reports.
.TP
.B cvscfg(use_cvseditor)
Let CVS invoke an editor for commit log messages rather than having tkcvs use its own input box.  By doing this, your site's commit template (rcsinfo) can be used.
.SS File filters
.TP
.B cvscfg(file_filter)
Pattern for which files to list. Empty string is equivalent to the entire directory (minus hidden files)
.TP
.B cvscfg(ignore_file_filter)
Pattern used in the workdir filter for files to be ignored
.TP
.B cvscfg(clean_these)
Pattern to be used for cleaning a directory (removing unwanted files)
.SS System
.TP
.B cvscfg(print_cmd)
System command used for printing. lpr, enscript -Ghr, etc)
.TP
.B cvscfg(shell)
What you want to happen when you ask for a shell
.TP
.B cvscfg(terminal)
Command prefix to use to run something in a terminal window
.SS Portability
.TP
.B cvscfg(aster)
File mask for all files (* for Unix, *.* for windows)
.TP
.B cvscfg(null)
The null device. /dev/null for Unix, nul for windows
.TP
.B cvscfg(tkdiff)
How to start tkdiff. Example sh /usr/local/bin/tkdiff
.TP
.B cvscfg(tmpdir)
Directory in which to do behind-the-scenes checkouts. Usually /tmp or /var/tmp)
.SS Debugging
.TP
.B cvscfg(log_classes)
For debugging: C=CVS commands, E=CVS stderr output, F=File creation/deletion, T=Function entry/exit tracing, D=Debugging
.TP
.B cvscfg(logging)
Logging (debugging) on or off
.SP
.SH Environment Variables
.LP
You should have the CVSROOT environment variable pointing to the location of your CVS repository before you run TkCVS. It will still allow you to work with different repositories within the same session.
.LP
If you wish TkCVS to point to a Subversion repository by default, you can set the environment variable SVNROOT.  This has no meaning to Subversion itself, but it will clue TkCVS if it's started in an un-versioned directory.
.SP
.SH User Configurable Menu Extensions
.LP
It is possible to extend the TkCVS menu by inserting additional commands into the .tkcvs or tkcvs_def.tcl files. These extensions appear on an extra menu to the right of the TkCVS Options menu.
.LP
To create new menu entries on the user-defined menu, set the following variables:
.SS cvsmenu(command)
.LP
Setting a variable with this name to a value like "commandname" causes the CVS command "cvs commandname" to be run when this menu option is selected. For example, the following line:
.LP
.RS
    set cvsmenu(update_A) "update -A"
.RE
.LP
Causes a new menu option titled "update_A" to be added to the user defined menu that will run the command "cvs update -A" on the selected files when it is activated.
.LP
(This example command, for versions of CVS later than 1.3, will force an update to the head version of a file, ignoring any sticky tags or versions attached to the file).
.SS usermenu(command)
.LP
Setting a variable with this name to a value like "commandname" causes the command "commandname" to be run when this menu option is selected. For example, the following line:
.LP
.RS
    set usermenu(view) "cat"
.RE
.LP
Causes a new menu option titled "view" to be added to the User defined menu that will run the command "cat" on the selected files when it is activated.
.LP
Any user-defined commands will be passed a list of file names corresponding to the files selected on the directory listing on the main menu as arguments.
.LP
The output of the user defined commands will be displayed in a window when the command is finished.
.SP
.SH CVS Modules File
.LP
If you haven't put anything in your CVSROOT/modules file, please do so. See the "Administrative Files" section of the CVS manual. Then, you can add comments which TkCVS can use to title the modules and to display them in a tree structure.
.LP
The simplest use of TkCVS's "#D" directive is to display a meaningful title for the module:
.LP
.RS
#D      softproj        Software Development Projects
.RE
.RS
softproj softproj
.RE
.LP
A fancier use is to organize the modules into a tree which will mimic their directory nesting in the repository when they appear in the module browser. For example, suppose we have a directory called "chocolate" which is organized like this:
.LP
.RS
chocolate/
.RE
.RS
    truffle/
.RE
.RS
        cocoa3/
.RE
.RS
            biter/
.RE
.RS
            sniffer/
.RE
.RS
            snuffler/
.RE
.LP
To display its hierarchy, as well as make the deepest directories more accessible by giving them module names, we could put this in the modules file:
.LP
.RS
#D	chocolate	Top Chocolate
.RE
.RS
#D	chocolate/truffle	Cocoa Level 2
.RE
.RS
#D	chocolate/truffle/cocoa3	Cocoa Level 3
.RE
.RS
#D	sniffer	Chocolate Sniffer
.RE
.RS
sniffer	chocolate/truffle/cocoa3/sniffer
.RE
.RS
#D	snuff	Chocolate Snuffler
.RE
.RS
snuff	chocolate/truffle/cocoa3/snuffler
.RE
.RS
#D	biter	Chocolate Biter
.RE
.RS
biter	chocolate/truffle/cocoa3/biter
.RE
.LP
When you are installing TkCVS, you may like to add these additional lines to the modules file (remember to check out the modules module from the repository, and then commit it again when you have finished the edits).
.LP
These extension lines commence with a "#" character, so CVS interprets them as comments. They can be safely left in the file whether you are using TkCVS or not.
.LP
"#M" is equivalent to "#D". The two had different functions in previous versions of TkCVS, but now both are parsed the same way.
.SP
.SH SEE ALSO
cvs(1), svn(1)
.SH AUTHOR
Del ([e-mail]): Maintenance and Subversion support: Dorothy Robinson