bundles/org.eclipse.platform.doc.user/reference/ref-19cvs.htm

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<HEAD>

<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. 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">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
<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
  
  <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.team.cvs.ui.CVSPreferences)")'>
  <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link">
  <strong>Team &gt; CVS</strong></a>
  
  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>
  <TR>
    <TD valign="top" align="left">Maximum number of comments on history</TD>
    <TD valign="top" align="left">Use this option to limit the number of comments 
      that get displayed in the commit dialog.</TD>
    <TD>10</TD>
  </TR>  
</TABLE>
<p>This is what the General tab group of the CVS preference page looks like:</p>
<p><img alt="CVS preference page - General tab" 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. The option applies to both the files and the CVS control 
files.</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. It should be noted that
      pruning is always on when checking out from a branch of version regardless 
      of the value of this preference, in accordance with the CVS specification.</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 alt="CVS preference page - File and Folders tab" 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. Setting this option to
      0 means that the compression is disabled.</TD>
    <TD>0 (disabled)</TD>
  </TR>
</TABLE>
<p>This is what the Connection tab group of the CVS preference page looks like:</p>
<p><img alt="CVS preference page - Connection tab" 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 whether you 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 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">Use this option to configure whether all the resources that
    are contained in the same change set should be included in the operation when synchronizing or
    committing.</TD>
    <TD valign="top" align="left">No</TD>
  </TR>
  <TR> 
    <TD valign="top" align="left">Commit resources with warnings</TD>
    <TD valign="top" align="left">Use this option to configure whether the resources with warnings
    should be committed.</TD>
    <TD valign="top" align="left">Yes</TD>
  </TR>
  <TR> 
    <TD valign="top" align="left">Commit resources with errors</TD>
    <TD valign="top" align="left">Use this option to configure whether the resources with errors
    should be committed.</TD>
    <TD valign="top" align="left">Prompt</TD>
  </TR>  
    
</TABLE>
<p>This is what the Prompting tab group of the CVS preference page looks like:</p>
<p><img alt="CVS preference page - Prompting tab" src="../images/cvs-prompting.png"></p>

<h3 class="related">Related reference</h3>
  <A href="ref-6.htm">Perspectives</A>

</BODY>
</HTML>