bundles/org.eclipse.platform.doc.user/reference/ref-32.htm - platform/eclipse.platform.common - Git at Google

 <!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=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>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.&nbsp;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&nbsp;</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.&nbsp; Since file revisions
     in the repository are immutable, the editor opens in a read-only state,
  so it is not modifiable.&nbsp; </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>
	<!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=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>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 > 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 > 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>