| <!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=utf-8"> |
| <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> |
