blob: 796be388a924a18e06f83a37d428e5ca9ebe1dc6 [file] [log] [blame]
<!DOCTYPE html public "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<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="Head">The following sections describe the preferences available in the
tab groups of the CVS preferences page.</p>
<h2 class="Para">General</h2>
<p>On the General tab group of the CVS preference page you can customize several
aspects of the CVS Plug-in.</p>
<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">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">Confirm move tag on tag operation</TD>
<TD valign="top" align="left">Use this option to be prompted when the Move
tag option is chosen when tagging.</TD>
<TD>Enabled</TD>
</TR>
<TR>
<TD valign="top" align="left">Display detailed protocol output to stdout</TD>
<TD valign="top" align="left">Use this option to display the communication
trace between the Workbench and a CVS server.</TD>
<TD>Disabled</TD>
</TR>
<TR>
<TD valign="top" align="left">Refresh tags when comparing or replacing tags</TD>
<TD valign="top" align="left">Use this option to have the Compare with and
Replace With tag dialogs automatically refresh the known tags by contacting
the server.</TD>
<TD>Disabled</TD>
</TR>
<TR>
<TD valign="top" align="left">Automatically share projects containing CVS
meta information </TD>
<TD valign="top" align="left">Use this option to have any imported project
that was checked out from CVS using a different CVS tool automatically shared
with CVS. </TD>
<TD>Enabled</TD>
</TR>
<TR>
<TD valign="top" align="left">Use .project project name instead of module name on check out</TD>
<TD valign="top" align="left">Use this option to use the project name stored in the .project file as the
project name. If the checkout wizard cannot find a .project file, it will fallback to use the module name.</TD>
<TD>Disabled</TD>
</TR>
<TR>
<TD valign="top" align="left">Maximum number of files displayed when committing</TD>
<TD valign="top" align="left">Use this option to limit the number of files
that get displayed in the commit dialog.</TD>
<TD>1000</TD>
</TR>
</TABLE>
<p>This is what the General tab group of the CVS preference page looks like:</p>
<p><img src="../images/cvs-general.png"></p>
<h2><strong>Files and Folders</strong></h2>
<p>On the File and Folders tab group of the CVS preference page you can customize
several aspects of the CVS Plug-in.</p>
<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">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">Convert text files to use platform line ending</TD>
<TD valign="top" align="left">Use the option to convert the line endings of
text files to the line ending used by the platform. This option can be disabled
if you are checking out resources to a *nix drive that is mounted on a Windows
machine. </TD>
<TD>Enabled</TD>
</TR>
<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">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">Default text mode</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>
</TABLE>
<p>This is what the File and Folders tab group of the CVS preference page looks
like:</p>
<p><img src="../images/cvs-files.png"></p>
<h2>Connection</h2>
<p>On the Connections tab group of the CVS preference page you can customize several
aspects of the CVS Plug-in.</p>
<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">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">Compression</TD>
<TD valign="top" align="left">Use this option to set the compression level
used when sending files between the client and server.</TD>
<TD>0</TD>
</TR>
</TABLE>
<p>This is what the Connection tab group of the CVS preference page looks like:</p>
<p><img src="../images/cvs-connection.png"></p>
<h2>Prompting</h2>
<p>On the Prompting tab group of the CVS preference page you can customize several
aspects of the CVS Plug-in.</p>
<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">Allow empty commit comments</TD>
<TD valign="top" align="left"><p>Use the option to configure what happens
if a commit comment is not provided when committing.</p>
<ul>
<li><STRONG>Yes: </STRONG>Allow the commit to occur without a comment.</li>
<li><strong>No: </strong>Do not allow the commit to proceed until a
comment is provided.</li>
<li><STRONG>Prompt: </STRONG>Ask the user whether they want to allow
the commit to proceed without a comment.</li>
</ul></TD>
<TD valign="top" align="left">Prompt</TD>
</TR>
<TR>
<TD valign="top" align="left">Automatically 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:
<ul>
<li><STRONG>Yes: </STRONG>Automatically save unsaved changes in open editors
before each CVS operation.</li>
<li><strong>No: </strong>Continue CVS operations even if there are unsaved
changes in open editors.</li>
<li><STRONG>Prompt: </STRONG>Ask the user what to do with unsaved changes
in open editors.</li>
</ul></TD>
<TD valign="top" align="left">Prompt </TD>
</TR>
<TR>
<TD valign="top" align="left">Consult change sets when synchronizing or committing. </TD>
<TD valign="top" align="left"><p>Use this option to configure whether resources that have
been added to a change set should be grouped together under the change set when synchronizing or
committing.</p>
<TD valign="top" align="left">No</TD>
</TR>
</TABLE>
<p>This is what the Prompting tab group of the CVS preference page looks like:</p>
<p><img src="../images/cvs-prompting.png"></p>
<P><IMG height="27" alt="Related reference" src="../images/ngrelr.png" width="159" border="0"><BR>
<A href="ref-6.htm">Perspectives</A></P>
</BODY>
</HTML>