/usr/share/doc/gnat-gps/html/The-Version-Control-Contextual-Menu.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2002-2010 AdaCore.

This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, see http://www.gnu.org/licenses/.

A copy of the license is included in the section entitled
"GNU General Public License". -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Using the GNAT Programming Studio: The Version Control Contextual Menu</title>

<meta name="description" content="Using the GNAT Programming Studio: The Version Control Contextual Menu">
<meta name="keywords" content="Using the GNAT Programming Studio: The Version Control Contextual Menu">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-table.html#Index-table" rel="index" title="Index table">
<link href="Version-Control-System.html#Version-Control-System" rel="up" title="Version Control System">
<link href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file" rel="next" title="Working with global ChangeLog file">
<link href="The-VCS-Menu.html#The-VCS-Menu" rel="previous" title="The VCS Menu">
<style type="text/css">
<!--
   

a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
pre.smallexample {background-color:rgb(240,240,240);
                     font-family: courier new,courier,fixed;
                     font-size: 14px;
                     margin: 0px 40px 0px 40px;
                     border-width: 1px 2px 2px 1px;
                     border-top-style: dotted;
                     border-left-style: dotted;
                     border-right-style: solid;
                     border-bottom-style: solid;
                     border-color: black;}
   code             {color:black;
                     font-family: courier new,courier,fixed;
                     font-size: 14px;}
   body             {font-family: arial,helvetica,sans-serif;
                     font-size: 16px;
                     max-width: 800px;
                     text-align: justify}
   samp             {font-family: courier new,courier,fixed;
                     font-size: 14px}
                    

-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="The-Version-Control-Contextual-Menu"></a>
<div class="header">
<p>
Next: <a href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file" accesskey="n" rel="next">Working with global ChangeLog file</a>, Previous: <a href="The-VCS-Menu.html#The-VCS-Menu" accesskey="p" rel="previous">The VCS Menu</a>, Up: <a href="Version-Control-System.html#Version-Control-System" accesskey="u" rel="up">Version Control System</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Version-Control-Contextual-Menu-1"></a>
<h3 class="section">12.4 The Version Control Contextual Menu</h3>

<p>This section describes the version control contextual menu displayed when you
right-click on an entity (e.g. a file, a directory, a project) from various
parts of GPS, including the project view, the source editor and the VCS
Explorer.
</p>
<p>Depending on the context, some of the items described in this section won&rsquo;t
be shown, which means that they are not relevant to the current context.
</p>
<dl compact="compact">
<dt><b>Remove project</b></dt>
<dd><p>Only displayed on a project line. This will remove the selected
project from the VCS Explorer.
</p>
</dd>
<dt><b>Expand all</b></dt>
<dd><p>Expand all VCS Explorer project nodes.
</p>
</dd>
<dt><b>Collapse all</b></dt>
<dd><p>Collapse all VCS Explorer project nodes.
</p>
</dd>
<dt><b>Clear View</b></dt>
<dd><p>Clear the VCS Explorer.
</p>
</dd>
<dt><b>Query status</b></dt>
<dd><p>Query the status of the selected item. Brings up the VCS Explorer.
</p>
</dd>
<dt><b>Update</b></dt>
<dd><a name="Update"></a><p>Update the currently selected item (file, directory or project).
</p>
</dd>
<dt><b>Commit</b></dt>
<dd><a name="Commit"></a><p>Submits the changes made to the file to the repository, and queries
the status for the file once the change is made.
</p>
<p>It is possible to tell GPS to check the file before the actual commit
happens. This is done by specifying a <code>File checker</code> in the
<code>VCS</code> tab of the project properties dialog. This <code>File
checker</code> is in fact a script or executable that takes an absolute file
name as argument, and displays any error message on the standard
output. The VCS commit operation will actually occur only if nothing
was written on the standard output.
</p>
<p>It is also possible to check the change-log of a file before commit, by
specifying a <code>Log checker</code> in the project properties dialog. This
works on change-log files in the same way as the <code>File checker</code> works on
source files.
</p>
</dd>
<dt><b>Open</b></dt>
<dd><a name="Open"></a><p>Open the currently selected file for writing. On some VCS systems,
this is a necessary operation, and on other systems it is not.
</p>
</dd>
<dt><b>View entire revision history</b></dt>
<dd><a name="View-revision-history"></a><p>Show the revision logs for all previous revisions of this file.
</p>
</dd>
<dt><b>View specific revision history</b></dt>
<dd><p>Show the revision logs for one previous revision of this file.
</p>
</dd>
<dt><b>Compare against head revision</b></dt>
<dd><a name="index-compare"></a>
<a name="Compare-against-head"></a><p>Show a visual comparison between the local file and the most recent
version of that file in the repository.
</p>
</dd>
<dt><b>Compare against other revision</b></dt>
<dd><a name="Compare-against-working"></a><p>Show a visual comparison between the local file and one specific
version of that file in the repository.
</p>
</dd>
<dt><b>Compare two revisions</b></dt>
<dd><a name="Compare-against-revision"></a><p>Show a visual comparison between two specific revisions
of the file in the repository.
</p>
</dd>
<dt><b>Compare base against head</b></dt>
<dd><a name="Compare-base-against-head"></a><p>Show a visual comparison between the corresponding version of the
file in the repository and the most recent version of that file.
</p>
</dd>
<dt><b>Compare against tag/branch</b></dt>
<dd><a name="Compare-base-against-tag_002fbranch"></a><p>Only available on a Revision View and over a tag/branch. Show a visual
comparison between the corresponding version of the file in the
repository and the version of that file in the tag/branch.
</p>
</dd>
<dt><b>Annotate</b></dt>
<dd><a name="Annotate"></a><p>Display the annotations for the file, i.e. the information for each
line of the file showing the revision corresponding to that file, and
additional information depending on the VCS system.
</p>
<p>When using CVS or Subversion, the annotations are clickable. Left-clicking on
an annotation line will query and display the changelog associated to the
specific revision for this line.
</p>
</dd>
<dt><b>Remove Annotate</b></dt>
<dd><p>Remove the annotations from the selected file.
</p>
</dd>
<dt><b>Edit revision log</b></dt>
<dd><p>Edit the current revision log for the selected file.
</p>
</dd>
<dt><b>Edit global ChangeLog</b></dt>
<dd><p>Edit the global ChangeLog entry for the selected file.
see <a href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file">Working with global ChangeLog file</a>.
</p>
</dd>
<dt><b>Remove revision log</b></dt>
<dd><p>Clear the current revision associated to the selected file.
</p>
</dd>
<dt><b>Add</b></dt>
<dd><p>Add a file to the repository, using the current revision log for this
file. If no revision log exists, activating this menu will create
one. The file is committed in the repository.
</p>
</dd>
<dt><b>Add/No commit</b></dt>
<dd><p>Add a file to the repository, using the current revision log for this
file. If no revision log exists, activating this menu will create
one. The file is not committed in the repository.
</p>
</dd>
<dt><b>Remove</b></dt>
<dd><p>Remove a file from the repository, using the current revision log for
this file. If no revision log exists, activating this menu will create
one. The modification is committed in the repository.
</p>
</dd>
<dt><b>Remove/No commit</b></dt>
<dd><p>Remove a file from the repository, using the current revision log for
this file. If no revision log exists, activating this menu will create
one. The modification is not committed in the repository.
</p>
</dd>
<dt><b>Revert</b></dt>
<dd><p>Revert a locale file to the repository revision, discarding all local
changes.
</p>
</dd>
<dt><b>Resolved</b></dt>
<dd><p>Mark files&rsquo; merge conflics as resolved. Some version control systems
(like Subversion) will block any commit until this action is called.
</p>
</dd>
<dt><b>Switch tag/bracnh</b></dt>
<dd><p>Only available on a Revision View and over a tag/branch name. Will
switch the tree starting from a selected root to this specific tag or
branch.
</p>
</dd>
<dt><b>Merge</b></dt>
<dd><p>Only available on a Revision View and over a tag/branch name. Merge
file changes made on this specific tag/branch.
</p>
</dd>
<dt><b>View revision</b></dt>
<dd><p>Only available on a Revision View and over a revision.
</p>
</dd>
<dt><b>Commit as new Activity</b></dt>
<dd><p>An action to prepare a group-commit in just one-click. This action will:
</p>
<ul>
<li> create an anonymous activity,
</li><li> add all files selected into the VCS Explorer into the newly
created anonymous activity,
</li><li> open the activity log,
</li></ul>

<p>Just fill the activity log and commit the anonymous activity.
</p>
</dd>
<dt><b>Add to Activity</b></dt>
<dd><p>A menu containing all the current activities. Selecting one will add
the current file to this activity. This menu is present only if the
file is not already part of an activity.
</p>
</dd>
<dt><b>Remove from Activity</b></dt>
<dd><p>Remove file from the given activity. This menu is present only if the
file is already part of an activity.
</p>
</dd>
<dt><b>Directory</b></dt>
<dd><p>Only available when the current context contains directory information
</p>
<dl compact="compact">
<dt><i>Add/No commit</i></dt>
<dd><p>Add the selected directory into the VCS.
</p>
</dd>
<dt><i>Remove/No commit</i></dt>
<dd><p>Remove the selected directory from the VCS.
</p>
</dd>
<dt><i>Commit</i></dt>
<dd><p>Commit the selected directory into the VCS. This action is available
only if the VCS supports commit on directories, see <a href="The-VCS-node.html#The-VCS-node">The VCS node</a>.
</p>
</dd>
<dt><i>Add to Activity</i></dt>
<dd><p>Add the selected directory into the VCS. This action is available
only if the VCS supports commit on directories, see <a href="The-VCS-node.html#The-VCS-node">The VCS node</a>.
</p>
</dd>
<dt><i>Query status for directory</i></dt>
<dd><p>Query status for the files contained in the selected directory.
</p>
</dd>
<dt><i>Update directory</i></dt>
<dd><p>Update the files in the selected directory.
</p>
</dd>
<dt><i>Query status for directory recursively</i></dt>
<dd><p>Query status for the files in the selected directory and all
subdirectories recursively. Links and hidden directories are not
included.
</p>
</dd>
<dt><i>Update directory recursively</i></dt>
<dd><p>Update the files in the selected directory and all
subdirectories recursively. Links and hidden directories not included..
</p>
</dd>
</dl>

</dd>
<dt><b>Project</b></dt>
<dd><p>Only available when the current context contains project information
</p>
<dl compact="compact">
<dt><i>List all files in project</i></dt>
<dd><p>Bring up the VCS Explorer with all the source files contained in the project.
</p>
</dd>
<dt><i>Query status for project</i></dt>
<dd><p>Query the status for all the source files contained in the project.
</p>
</dd>
<dt><i>Update project</i></dt>
<dd><p>Update all the source files in the project.
</p>
</dd>
<dt><i>List all files in project and sub-projects</i></dt>
<dd><p>Bring up the VCS Explorer with all the source files contained in the
project and all imported sub-projects.
</p>
</dd>
<dt><i>Query status for project and sub-projects</i></dt>
<dd><p>Query the status for all the source files contained in the project
and all imported sub-projects.
</p>
</dd>
<dt><i>Update project and sub-projects</i></dt>
<dd><p>Update all the source files in the project and all imported
sub-projects.
</p>
</dd>
</dl>

</dd>
<dt><b>Select files same status</b></dt>
<dd><p>Select the files having the same status as the current selected file.
</p>
</dd>
<dt><b>Filters</b></dt>
<dd><p>Only available from the VCS Explorer. This menu controls filtering of the
items displayed in the list.
</p>
<dl compact="compact">
<dt><i>Show all status</i></dt>
<dd><p>Do not filter out any file from the list in the VCS Explorer.
</p>
</dd>
<dt><i>Hide all status</i></dt>
<dd><p>Filter out all the files from the list in the VCS Explorer.
</p>
</dd>
<dt><i>Show &lt;status&gt;</i></dt>
<dd><p>When disabled, filter out the files with the given status from the VCS
Explorer.
</p></dd>
</dl>

</dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file" accesskey="n" rel="next">Working with global ChangeLog file</a>, Previous: <a href="The-VCS-Menu.html#The-VCS-Menu" accesskey="p" rel="previous">The VCS Menu</a>, Up: <a href="Version-Control-System.html#Version-Control-System" accesskey="u" rel="up">Version Control System</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
gnat-gps-doc 5.0-16 / usr / share / doc / gnat-gps / html / The-Version-Control-Contextual-Menu.html
