blob: 75e25bff9213815d768871f28bad4ecbf4c07327 [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, 2010. 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">
<title>CVS Repositories view</title>
</head>
<body bgcolor="#FFFFFF">
<h1>CVS Repositories view</h1>
<p class="Para">The CVS Repositories view, which is part of the CVS Repository Exploring perspective, shows the CVS
repository locations that you have added to your Workbench. Expanding a location reveals the main trunk (HEAD),
project versions and branches in that repository. You can further expand the project versions and branches to reveal
the folders and files contained within them.</p>
<p>The pop-up menu for this view also allows you to specify new repository locations. Use the CVS Repositories view
to check out resources from the repository to the Workbench, configure the branches and versions shown by the view,
view resource history, and compare resource versions.</p>
<p class="Para">Here is what the CVS Repositories view looks like:</p>
<p class="Para"><img src="../images/Image242_repo_view.png" alt="CVS Repositories View" border="0" align="top"></p>
<p>There are two types of folders displayed in the repositories view. For the most part, they can be treated in the
same fashion. That is, they can be checked out from the Repositories view, etc. However, there are some cases where
modules cannot be expanded in the Repositories view even though they can still be checked out.</p>
<table width="75%" border="1">
<tr>
<td width="9%" align="center"><img alt="Image for a CVS module that maps to a folder on the CVS server." src=
"../images/fldr_obj.svg"></td>
<td width="91%">A CVS module that maps to a folder on the CVS server.</td>
</tr>
<tr>
<td align="center"><img alt="Image for a CVS module defined in the CVSROOT/modules file of the repository." src=
"../images/cvs_module_rep.svg"></td>
<td>A CVS module defined in the CVSROOT/modules file of the repository.</td>
</tr>
</table>
<p>Like other views in the Workbench, the CVS Repositories view has its own toolbar. Toolbar buttons are provided for
refreshing the view, navigating and creating new repository locations. The toolbar also contains a drop-down menu
that allows you to filter the view by working set.</p>
<h2>Toolbar</h2>
<div class="Topic">
<h3>Home</h3>
<p class="Para">This command redraws the view, showing the repository locations as the roots displayed by the
view.</p>
</div>
<div class="Topic">
<h3>Back</h3>
<p class="Para">This command redraws the view, showing the roots that where displayed immediately prior to the
previous issued Go Into command.</p>
</div>
<div class="Topic">
<h3>Go Into</h3>
<p class="Para">This command redraws the view, making the children of the selected entry the roots displayed by the
view.</p>
</div>
<div class="Topic">
<h3>Refresh View</h3>
<p class="Para">This command refreshes the contents of the Repositories view.</p>
</div>
<div class="Topic">
<h3>Collapse All</h3>
<p class="Para">This command collapses all expanded entries in the Repositories view.</p>
</div>
<div class="Topic">
<h3>Add CVS Repository</h3>
<p class="Para">This command brings up the wizard to help you specify a new repository location.</p>
</div>
<h3 class="Para">Drop-Down Menu</h3>
<p class="Para">The drop down menu in the title bar allows the repositories view to be filtered by a working set. It
also allows to hide CVS modules defined in the CVSROOT/modules file.</p>
<h2 class="Para">Context menu</h2>
<p class="Para">From the context menu of the Repositories view you can perform a number of interesting
operations.</p>
<h3>New &gt; Repository Location</h3>
<p class="Para">This command brings up the wizard to help you specify a new repository location (same as Add CVS
Repository toolbar item).</p>
<h3>New &gt; Date Tag</h3>
<p class="Para">This command, available on the repository location and Date category entries, brings up the dialog
which allows the specification of a date tag that is to be added to the Date category of the location entry in the
Repositories view.</p>
<h3>Check Out</h3>
<p>This command checks the selected CVS modules out into projects in the Workbench with the same names as the remote
modules (for remote modules that are folders on the server) or into projects with the name specified with the module
(if the module is defined in the CVSROOT/modules file on the server).</p>
<h3>Check Out As...</h3>
<p>This command open the Check Out wizard in order to allow the configuration of how the selected remote modules are
checked out into the Workbench.</p>
<h3>Tag as Version...</h3>
<p>This command versions the selected resource based on the current branch contents.</p>
<h3>Tag with Existing...</h3>
<p>This command versions the selected resource based on the current branch contents, moving the tag from previously
tagged resources if required.</p>
<h3>Compare</h3>
<p class="Para">This command will compare two selected resources.</p>
<h3>Compare With...</h3>
<p class="Para">This command will compare the selected folder with a branch or version of the same folder.</p>
<h3>Expand All</h3>
<p class="Para">This command will fetch all of the subfolders of the selected item in one pass.</p>
<h3>Refresh View</h3>
<p class="Para">This command will refresh the repository folder tree.</p>
<h3>Paste connection</h3>
<p class="Para">Creates a new repository location based on the content of the clipboard. There must a valid
repository location string (eg. :pserver:dev.eclipse.org:/cvsroot/eclipse) in the clipboard in order paste a new
connection.</p>
<h3>Copy to clipboard</h3>
<p class="Para">Copies the identification string of the selected repository to the clipboard.</p>
<h3>Discard Location</h3>
<p class="Para">This command will remove the selected repository location. Note that all projects that were
previously mapped to this repository must first be unmapped.</p>
<h3>Configure Branches and Versions</h3>
<p class="Para">This command brings up the wizard to help you discover the branch and version tags that exist in the
repository for the selected folder so they can be added to the repositories view to allow the resources that have
these tags can be browsed.</p>
<h3>Refresh Branches...</h3>
<p class="Para">This command, available on repository location entries, allows you to refresh the list of known
branches and versions that are displayed in the repositories view for selected projects. This operation makes use of
the defined auto-refresh files for each project. If the operation fails for a particular project, use Configure
Branches and Versions on the project to select one or more appropriate refresh files.</p>
<h3>Add to Branch List...</h3>
<p>This command adds the selected project to the list of projects that are displayed under the specified branch in
the repositories view. This command only modifies the repositories view and does not affect the repository in any
way. If you want to add the project to a branch, you can perform a <strong>Tag with Existing</strong> after
performing this operation.</p>
<h3>Open</h3>
<p>This command opens the selected file in an editor. Since file revisions in the repository are immutable, the
editor opens in a read-only state, so it is not modifiable.</p>
<h3>Show Annotation</h3>
<p>This command shows the contents of file with annotations identifying the author of each line of code in the
file.</p>
<h3>Show History</h3>
<p>This command shows the revision history of the selected file in the History view.</p>
<h3>Properties</h3>
<p>Available on repository location entries, this command allows the modification of any of the properties of the
location. It also allows the assignment of a display name and a server encoding which is used to translate file paths
and commit comments between the client and server (but does not affect file contents).</p>
<h3 class="related">Related concepts</h3><a href="../concepts/concepts-26.htm">Team programming with CVS</a><br>
<a href="../concepts/concepts-27c.htm">CVS Repositories</a><br>
<a href="../concepts/concepts-27b.htm">Branches</a><br>
<a href="../concepts/concepts-27.htm">Versions</a><br>
<a href="../concepts/concepts-17a.htm">Local history</a>
<h3 class="related">Related tasks</h3><a href="../tasks/tasks-92.htm">Creating a CVS repository location</a><br>
<a href="../tasks/tasks-94.htm">Discarding a CVS repository location</a><br>
<a href="../tasks/tasks-93.htm">Refreshing the CVS repositories view</a><br>
<a href="../tasks/tasks-95.htm">Changing the properties of a CVS Repository Location</a><br>
<a href="../tasks/tasks-96.htm">Checking out a project from a CVS repository</a><br>
<a href="../tasks/tasks-103.htm">Replacing resources in the Workbench</a><br>
<a href="../tasks/tasks-117.htm">Sharing a new project using CVS</a><br>
<a href="../tasks/tasks-119.htm">Viewing a file's revision history</a>
<h3 class="related">Related reference</h3><a href="ref-47.htm">CVS</a><br>
<a href="ref-32a.htm">CVS Resource History View</a>
</body>
</html>