blob: 7c8c50b0397378481a566667212a45539c650cd5 [file] [log] [blame]
<!DOCTYPE html public "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META http-equiv="Content-Style-Type" content="text/css"><LINK rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
<TITLE>CVS</TITLE>
</HEAD>
<BODY bgcolor="#ffffff">
<H1 class="Head">CVS</H1>
<P class="Para">On the CVS preference page you can customize several aspects
of the CVS Plug-in.</P><H2 class="Para"><STRONG>General CVS Preferences:</STRONG></H2>
<TABLE border="1" cellspacing="0">
<THEAD>
<TR>
<TH> <P class="Para">Option</P></TH>
<TH> <P class="Para">Description</P></TH>
<TH> <P class="Para">Default</P></TH>
</TR>
</THEAD>
<TR>
<TD valign="top" align="left"> Prune empty directories</TD>
<TD valign="top" align="left"> Use this option to specify the pruning of empty
directories on update and in the synchronization view. Although pruned directories
aren't shown in the workbench there is actually still an empty directory
in the repository. This is helpful because CVS doesn't provide a client
with the ability to remove directories from the server.</TD>
<TD>Enabled </TD>
</TR>
<TR>
<TD valign="top" align="left"> Consider file contents in comparison</TD>
<TD valign="top" align="left"> Use this option to set the default compare
method for comparing and synchronizing CVS resources. By default, time stamps
are used to compare CVS files, and this is by far the fastest method. However,
in some cases a more accurate comparison can be achieved by comparing file
content. This setting can also be toggled from within a compare editor or
the synchronization view.</TD>
<TD>Disabled </TD>
</TR>
<TR>
<TD valign="top" align="left"> Show deleted file markers</TD>
<TD valign="top" align="left"> Use this option to enable markers to be added
to the task view for resources that have been locally removed but not committed.
This is useful for users who prefer update/commit instead of using the synchronize
view. The deleted tasks allow quick fix options for committing the deletion
to the server.</TD>
<TD>Enabled </TD>
</TR>
<TR>
<TD valign="top" align="left">Delete unmanaged resources on replace </TD>
<TD valign="top" align="left">Use this option to allows resources not under
CVS control to be deleted when replacing with resources from the repository.
</TD>
<TD>Enabled </TD>
</TR>
<TR>
<TD valign="top" align="left">Treat all new files as binary </TD>
<TD valign="top" align="left">Use this option to override the file content
settings and treat all new files as binary. </TD>
<TD>Disabled </TD>
</TR>
<TR>
<TD valign="top" align="left">Validate server version compatibility on first
connection </TD>
<TD valign="top" align="left">Use this option to enable a query of the CVS
server version on the first connection to determine server compatibility.
The server version will be output to the console and if an incompatibility
is detected a warning message will be logged when connecting. </TD>
<TD>Enabled </TD>
</TR>
<TR>
<TD valign="top" align="left">Communication timeout </TD>
<TD valign="top" align="left">Use this option to configure the amount of time
in seconds to wait before timing out from a connection to the CVS server.
</TD>
<TD>60 seconds </TD>
</TR>
<TR>
<TD valign="top" align="left">Quietness level </TD>
<TD valign="top" align="left">Sets the amount of status information CVS prints
for a command. In <STRONG>Somewhat quiet</STRONG> mode the printing of unimportant
informational messages is suppressed. The consideration of what is important
depends on each command. In <STRONG>Very quiet</STRONG> mode all output
except what is absolutely necessary to complete the command is suppressed.
In <STRONG>Very Quiet</STRONG> mode, some CVS servers may not communicate
important information about errors that have occurred. You may want to consider
using <STRONG>Somewhat quiet</STRONG> mode instead. </TD>
<TD>Verbose </TD>
</TR>
<TR>
<TD valign="top" align="left">Default keyword substitution </TD>
<TD valign="top" align="left">Use this option to set the default keyword substitution
for text files. </TD>
<TD>ASCII with keyword expansion -kkv </TD>
</TR>
<TR>
<TD valign="top" align="left">Save dirty editors before CVS operations </TD>
<TD valign="top" align="left"> Use this option to configure what happens when
there are open editors with unsaved changes when a CVS operation is performed.
Options are:
<P><STRONG>Never</STRONG></P>
<P>Continue CVS operations even if there are unsaved changes in open editors.</P>
<P><STRONG>Prompt</STRONG></P>
<P>Ask the user what to do with unsaved changes in open editors.</P>
<P><STRONG>Auto-save</STRONG></P>
<p>Automatically save unsaved changes in open editors before each CVS operation.</p></TD>
<TD>Prompt </TD>
</TR>
</TABLE>
<H2>Console preferences:</H2>
<TABLE width="100%" border="1" cellspacing="0">
<THEAD>
<TR>
<TH>
<P class="Para">Option</P>
</TH>
<TH>
<P class="Para">Description</P>
</TH>
</TR>
</THEAD>
<TR>
<TD valign="top" align="left"> Console text color settings</TD>
<TD valign="top" align="left"> Use these options to change the colors for
the text shown in CVS Console.
<UL>
<LI>Command line text <I>(black)</I>
<LI>Message text <I>(blue)</I>
<LI>Error text <I>(red)</I></LI>
</UL>
</TD>
</TR>
</TABLE>
<H2>Ext Connection Method preferences:</H2>
<TABLE border="1" cellspacing="0">
<TR>
<TD valign="top" align="left">CVS_RSH
</TD>
<TD valign="top" align="left"> Use this option to configure the program that
will be called to connect to the remote CVS server. The RSH command is invoked
with following calling pattern:
<P><EM>CVS_RSH Parameters CVS_SERVER</EM></P>
</TD>
<TD>ssh
</TD>
</TR>
<TR>
<TD valign="top" align="left">Parameters
</TD>
<TD valign="top" align="left"> Use this option to configure the parameters
passed to the CVS_RSH program. The default parameter pattern is {host} -l
{user}. It can be tailored using the {host}, {user}, {password} and {port}
variables.</TD>
<TD>{host} -l {user}
</TD>
</TR>
<TR>
<TD valign="top" align="left">CVS_SERVER
</TD>
<TD valign="top" align="left">Use this option to configure the
name of the remote CVS server program to run. Change this setting only
if the remote CVS server binary name is different than the default.
</TD>
<TD>cvs
</TD>
</TR>
</TABLE>
<H2>Label Decorations preferences:</H2>
<TABLE width="100%" border="1" cellspacing="0">
<TR>
<TD valign="center" align="left">Text
</TD>
<TD valign="top" align="left"> Use the options on this page to configure how
CVS information will be added to text labels.</TD>
</TR>
<TR>
<TD valign="center" align="left">Icons
</TD>
<TD valign="top" align="left">Use the options on this page to
configure the which icons can be used as overlays to show CVS specific
information in views.
</TD>
</TR>
<TR>
<TD valign="center" align="left">General
</TD>
<TD valign="top" align="left"> Use the options on this page to configure general
preferences about the decorators:
<P><STRONG>Compute deep outgoing state for folders</STRONG></P>
<P>Use this option to configure if the outgoing indicators on folders
should be calculated. Disabling this option improves the performance
of the decorators because calculating the dirty state for folders requires
computing the dirty state for all child resources. (<EM>enabled by default</EM>)</P>
</TD>
</TR>
<TR>
<TD valign="center" align="left">Synchronize view
</TD>
<TD valign="top" align="left"> Use the options on this page to configure how
label decorations appear in the synchronize view:
<P><STRONG>Show all CVS synchronization information in the text label</STRONG></P>
<P>Use this option to show the synchronization state of a resource in the
text label. This is useful for accessibility requirements. If you are
using a UI text reader, than enabling this option will allow the text
reader to correctly interpret the states shown in the view. Ordinarily synchronization states are shown using icon decorations.</P>
</TD>
</TR>
</TABLE>
<H2>Watch/Edit preferences:</H2>
<TABLE border="1" cellspacing="0">
<TR>
<TD valign="top" align="left">Configure projects to use Watch/edit on checkout</TD>
<TD valign="top" align="left"> Use this option to indicate that files checked
out out from the repository should be made read-only.</TD>
<TD>disabled</TD>
</TR>
<TR>
<TD valign="top" align="left">When read-only files are modified in an editor</TD>
<TD valign="top" align="left"> Use this option to configure what occurs when
a read-only file is modified in an open editor or by another tool.
<P><strong>Send a cvs edit notification to the server</strong></P>
<P>Issues a cvs edit notification to the server before making the file writable.
If other editors exist on the file, the user will be prompted and may
continue or cancel.</P>
<P><strong>Edit the file without informing the server</strong></P>
<P>Makes the file read-only without notifying the server.</P></TD>
<TD>Send a cvs edit notification to the server</TD>
</TR>
</TABLE>
<P><IMG height="27" alt="Related reference" src="../images/ngrelr.gif" width="159" border="0"><BR>
<A href="ref-6.htm">Perspectives</A></P>
<P><BR><A href="../hglegal2003.htm"><IMG height="14" alt="Copyright IBM Corporation and others 2000, 2003" src="../images/ngibmcpy2003.gif" width="324" border="0"></A></P>
</BODY>
</HTML>