blob: c20e3b6568fd9f47b8be279faf09203d1218a239 [file] [log] [blame]
<!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">
<title>Enabling the CVS resource decorations</title>
<meta name="keyword" content="team">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script>
</HEAD>
<BODY BGCOLOR="#ffffff">
<H1 CLASS="Head">Enabling the CVS resource decorations</H1>
<P>When enabled, CVS will decorate resources in Workbench views with icon and
label decorations that indicate the CVS state of the resource.
</P>
<P>To enable the CVS decorations:
</P>
<ol>
<li>Open the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.Decorators)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<b>General &gt; Appearance &gt; Label Decorations</b></a>
preference page. This page allows the enabling and disabling of all decorations
defined by different plug-ins in the Workbench.</li>
<li>Click on the CVS box to enable the CVS decorations.</li>
<li> Click <b>OK</b>.</li>
</ol>
<p><em>Note:</em> In some cases, the decorations may not appear immediately due
to the fact that they are expensive to compute. In those cases, they are calculated
in the background. </p>
<p>To configure the CVS decorations:
</p>
<ol>
<li>Open the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.team.cvs.ui.CVSDecoratorPreferences)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<b>Team &gt; CVS &gt; Label Decorations</b></a>
preference page. This page allows the configuration of how decorations appear on CVS
projects, folders and files.</li>
<li>To configure the text label decorations click the <strong>Text</strong>
tab and then:
<ol type="a">
<li>Pick the resource type (file, folder, project) for which you want to
change the decoration.</li>
<li>Click in the decoration string for that resource type at the location
where the new decoration element should go.</li>
<li>Click the <b>Add Variables</b> button for that resource type.</li>
<li>Choose the CVS information variable to add. For instance, for files
you could select the <i>added_flag</i> which will be inserted in the decoration
where you placed the cursor. The string <i>{added_flag}</i> will be added
to the decoration string which will decorate newly added resources using
the added resource label (which can be set in the <i>Label Decoration
for Added</i> field).</li>
</ol>
</li>
<li>Repeat the above for any other decorations to be added.</li>
<li>Decorations can be removed by deleting the decoration variable name (i.e.<i>
{added_flag}</i>) from the decoration string. In a similar manner, spacing
can be added.</li>
<li>To configure icon decorations, click the <strong>Icon</strong> tab simply
enable/disable the icon checkboxes.</li>
<li>Click <b>OK</b> or <b>Apply</b> for the new decorations to take effect.</li>
</ol>
<p><em>Note</em>: Under the <strong>General</strong> tab is an option to disable
the deep dirty decoration of folders. This will make decorator determination
more efficient but will make it harder to find dirty resources in one of the
navigation views. Under the <strong>Synchronize View</strong> tab, the Synchronize
view can be configured to show the synchronization state of a resource as part
of the text label displayed in the Structure Compare pane.</p>
<p>You can also change the color and font of items based on the item's CVS state.
To set the color and font:</p>
<ol>
<li>Open the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.team.cvs.ui.CVSDecoratorPreferences)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<b>Team &gt; CVS &gt; Label Decorations</b></a>
preference page.</li>
<li>Check the box to <em>Enable font and color decorations</em>.</li>
<li>Next, Open the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.ColorsAndFonts)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<b>General &gt; Appearance &gt; Colors and Fonts</b></a> preference page.</li>
<li>In the <strong>CVS</strong> category are the various CVS states for which
you can set the colors and fonts. Set them as desired.</li>
<li>You can return to the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.team.cvs.ui.CVSDecoratorPreferences)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<b>Team &gt; CVS &gt; Label Decorations</b></a>
preference page to preview the changes.</li>
<li>Click <b>OK</b> or <b>Apply</b> for the new decorations to take effect.</li>
</ol>
<p><img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br>
<a href="../concepts/concepts-26.htm">Team programming with CVS</a><br>
<a href="../concepts/concepts-30.htm">Synchronizing with a CVS repository</a>
</p>
<p><img border="0" src="../images/ngrelt.png" alt="Related tasks" ><br>
<a href="tasks-96.htm">Checking out a project from a CVS repository</a><br>
<a href="tasks-117.htm">Sharing a new project using CVS</a>
</p>
<p><img border="0" src="../images/ngrelr.png" alt="Related reference" ><br>
<a href="../reference/ref-47.htm">CVS</a><br>
<a href="../reference/ref-cvs-decorations.htm">CVS Label Decorations</a>
</p>
</BODY>
</HTML>