-
Notifications
You must be signed in to change notification settings - Fork 72
/
ref-32a.htm
164 lines (164 loc) · 8.62 KB
/
ref-32a.htm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
<!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">
<title>CVS History View</title>
</head>
<body style="background-color: rgb(255,255,255);">
<h1 class="Head">CVS History view</h1>
<p class="Intro">This view provides a list of all the revisions of a resource in the repository as well as all the
revisions of a resource in the local history. From this view you can compare revisions, load a revision, revert the
corresponding workspace file to a revision, tag with an existing tag, show annotations and open an editor on a
revision.</p>
<p class="Para">Here is what the CVS History View looks like:</p>
<p class="Para"><img src="../images/Image216_history_view.png" alt="CVS Resource History View" border="0" align=
"top"></p>
<h2>Columns</h2>
<p class="Para">The History View is able to display both local and remote revisions. Local History revisions have
minimal information associated with them - only a time stamp. As a result, the majority of the column items will
appear blank for Local History revisions. Remote revisions, on the other hand, will have a much more complete set of
information. Here are the columns:</p>
<div class="Topic">
<h3>Revision</h3>
<p class="Para">Since the CVS History view can display both remote and local revisions. For remote revisions:</p>
<ul>
<li>the column displays the remote revision icon: <img src="../images/remote_history_mode.svg" alt=
"Remote History Mode icon" border="0" align="top"></li>
<li>the column displays the revision number in the history.</li>
</ul>For local history revisions:
<ul>
<li>the column displays the local history revision icon: <img src="../images/local_history_mode.svg" alt=
"Local History Mode icon" border="0" align="top"></li>
</ul>
</div>
<div class="Topic">
<h3>Branches</h3>
<p class="Para">This column displays the list of branches on which the revision is available. <i>(Remote revisions
only)</i></p>
</div>
<div class="Topic">
<h3>Tags</h3>
<p class="Para">The tags that are associated with the revision. Selecting a revision line will list the tags in the
lower left pane of the view. <i>(Remote revisions only)</i></p>
</div>
<div class="Topic">
<h3>Revision Time</h3>
<p class="Para">This column displays the creation date and time of the revision in the history.</p>
</div>
<div class="Topic">
<h3>Author</h3>
<p class="Para">This column displays the name of the person who created and authored the version. <i>(Remote
revisions only)</i></p>
</div>
<div class="Topic">
<h3>Comment</h3>
<p class="Para">This column displays the comment (if any) supplied for this revision at the time it was committed.
Selecting a revision line will show the complete comment in the lower right pane of the view. Also, mousing over a
dotted comment will result in showing a tooltip with complete comment. <i>(Remote revisions only)</i></p>
</div>
<h2>Toolbar</h2>
<div class="Topic">
<h3>Refresh</h3>
<p class="Para">This command refreshes the contents of the view, fetching the latest history information for the
resource from the server.</p>
</div>
<div class="Topic">
<h3>Link with Editor and Selection</h3>
<p class="Para">When enabled, the view will display the history for the resource of the active editor or of the
active selection.</p>
</div>
<div class="Topic">
<h3>Pin</h3>
<p class="Para">When enabled will pin the view and its contents. Any new requests for history will open a new
instance of the History View.</p>
</div>
<div class="Topic">
<h3>Navigation History</h3>
<p class="Para">When enabled will allow you to select from a drop down menu a resource for which a history has been
viewed in the past. The action is disabled when the History view is opened for the first time.</p>
</div>
<div class="Topic">
<h3>Group Revisions by Date</h3>
<p class="Para">When enabled, all history items will be sorted into one of the following date categories:</p>
<ul>
<li>Today</li>
<li>Yesterday</li>
<li>This Month</li>
<li>Previous</li>
</ul>
</div>
<div class="Topic">
<h3>Local and Remote Revisions</h3>
<p class="Para">When enabled will display both local and remote revisions of the resource in the History view.</p>
</div>
<div class="Topic">
<h3>Local Revisions</h3>
<p class="Para">When enabled will display only the local revisions of the resource in the History view.</p>
</div>
<div class="Topic">
<h3>Remote Revisions</h3>
<p class="Para">When enabled will display only the remote revisions of the resource in the History view.</p>
</div>
<div class="Topic">
<h3>Collapse All</h3>
<p class="Para">Will the view is in the Group by Date mode, Collapse All will collapse all of the date
categories.</p>
</div>
<div class="Topic">
<h3>Compare Mode</h3>
<p class="Para">When enabled, a double click (or a single click depending on your Open Mode strategy set in
<b>Preferences>General</b>) will open a compare editor. When it is disabled, clicking on a revision will open
that revision.</p>
</div>
<div class="Topic">
<h3>Drop Down Menu</h3>
<p class="Para">The drop down menu contains the following items:</p>
<ul>
<li><b>Wrap Comments</b>: Will wrap comments in the Comment Viewer.</li>
<li><b>Show Comment Viewer</b>: shows the Comment Viewer.</li>
<li><b>Show Tag Viewer</b>: shows the Tag Viewer.</li>
<li><b>Show Search Field</b>: shows the Search Field.</li>
<li><b>Filter....</b>: Opens the Filter Dialog.</li>
<li><b>Remove Filters</b>: Removes any filtering from the History View.</li>
</ul>
</div>
<h2 class="Para">Context menu</h2>
<p class="Para">From the context menu of the CVS Resource History view you can perform a number of interesting
operations.</p>
<h3>Open</h3>
<p class="Para">This command will open the contents of the selected revision in a read only editor. (The editor used
is the one that is registered as the default editor for the file type). <i>Note</i>: If the revision being opened is
the current version of the file, then it will be opened in a regular editor.</p>
<h3>Open With</h3>
<p class="Para">This menu allows choosing an editor to open the contents of the selected revision. <i>Note</i>: If
the revision being opened is the current version of the file, then it will be opened in a regular editor, otherwise a
read only editor is used.</p>
<h3>Compare Current With Revision/Compare With Each Other</h3>
<p class="Para">The compare command differs based on the number of revisions selected in the history view. For a
single selection, <b>Compare Current With Revision</b> will the compare the current version of the resource with the
selected revision. For two selections, <b>Compare with Each Other</b> will compare the selected revisions.</p>
<h3>Get Contents</h3>
<p class="Para">This command will load the contents of the selected revision into the local copy of the file whose
history is displayed in the view. The local file can then be committed to make the contents of latest revision in
HEAD (or a branch) match the contents of the selected revision.</p>
<h3>Get Sticky Revision</h3>
<p class="Para">This command will load the selected revision over the local file whose history is being displayed.
This operation is rarely needed and is mainly used to change the tag on one or more resources. The loaded revision
cannot be subsequently committed but can be tagged.</p>
<h3>Tag with Existing...</h3>
<p class="Para">This command allows an existing tag to be moved to the selected file revision.</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>Refresh View</h3>
<p>This command refreshes the contents of the view.</p>
<h3 class="related">Related reference</h3><a href="ref-32.htm">CVS Repositories view</a>
<h3 class="related">Related concepts</h3><a href="../concepts/concepts-12.htm">Resources</a><br>
<a href="../concepts/concepts-27c.htm">CVS Repositories</a><br>
<a href="../concepts/concepts-17a.htm">Local history</a>
</body>
</html>