| |
| <!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 > 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> |