Debian Codegraph @

doc/html/hg-identify.html

raw
1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6 <meta name="generator" content="Docutils 0.21.2: https://docutils.sourceforge.io/" />
7 <title>hg identify</title>
8 <link rel="stylesheet" href="../style.css" type="text/css" />
9 </head>
10 <body>
11 <div class="document" id="hg-identify">
12 <span id="hg-identify-1"></span>
13 <h1 class="title">hg identify</h1>
14 <h2 class="subtitle" id="identify-the-working-directory-or-specified-revision">identify the working directory or specified revision</h2>
15
16 <div class="contents htmlonly topic" id="contents">
17 <p class="topic-title"><a class="reference internal" href="#top">Contents</a></p>
18 <ul class="simple">
19 <li><a class="reference internal" href="#synopsis" id="toc-entry-1">Synopsis</a></li>
20 <li><a class="reference internal" href="#description" id="toc-entry-2">Description</a></li>
21 <li><a class="reference internal" href="#options" id="toc-entry-3">Options</a></li>
22 <li><a class="reference internal" href="#aliases" id="toc-entry-4">Aliases</a></li>
23 </ul>
24 </div>
25 <div class="section" id="synopsis">
26 <h1><a class="toc-backref" href="#contents">Synopsis</a></h1>
27 <pre class="literal-block">
28 hg identify [-nibtB] [-r REV] [SOURCE]
29 </pre>
30 </div>
31 <div class="section" id="description">
32 <h1><a class="toc-backref" href="#contents">Description</a></h1>
33 <p>Print a summary identifying the repository state at REV using one or
34 two parent hash identifiers, followed by a &quot;+&quot; if the working
35 directory has uncommitted changes, the branch name (if not default),
36 a list of tags, and a list of bookmarks.</p>
37 <p>When REV is not given, print a summary of the current state of the
38 repository including the working directory. Specify -r. to get information
39 of the working directory parent without scanning uncommitted changes.</p>
40 <p>Specifying a path to a repository root or Mercurial bundle will
41 cause lookup to operate on that repository/bundle.</p>
42 <div class="verbose docutils container">
43 <p>Template:</p>
44 <p>The following keywords are supported in addition to the common template
45 keywords and functions. See also <a class="reference external" href="hg.1.html#templates"><tt class="docutils literal">hg help templates</tt></a>.</p>
46 <table class="docutils field-list" frame="void" rules="none">
47 <col class="field-name" />
48 <col class="field-body" />
49 <tbody valign="top">
50 <tr class="field"><th class="field-name">dirty:</th><td class="field-body">String. Character <tt class="docutils literal">+</tt> denoting if the working directory has
51 uncommitted changes.</td>
52 </tr>
53 <tr class="field"><th class="field-name">id:</th><td class="field-body">String. One or two nodes, optionally followed by <tt class="docutils literal">+</tt>.</td>
54 </tr>
55 <tr class="field"><th class="field-name">parents:</th><td class="field-body">List of strings. Parent nodes of the changeset.</td>
56 </tr>
57 </tbody>
58 </table>
59 <p>Examples:</p>
60 <ul>
61 <li><p class="first">generate a build identifier for the working directory:</p>
62 <pre class="literal-block">
63 hg id --id &gt; build-id.dat
64 </pre>
65 </li>
66 <li><p class="first">find the revision corresponding to a tag:</p>
67 <pre class="literal-block">
68 hg id -n -r 1.3
69 </pre>
70 </li>
71 <li><p class="first">check the most recent revision of a remote repository:</p>
72 <pre class="literal-block">
73 hg id -r tip https://www.mercurial-scm.org/repo/hg/
74 </pre>
75 </li>
76 </ul>
77 </div>
78 <p>See <a class="reference external" href="hg-log.html"><tt class="docutils literal">hg log</tt></a> for generating more information about specific revisions,
79 including full hash identifiers.</p>
80 <p>Returns 0 if successful.</p>
81 </div>
82 <div class="section" id="options">
83 <h1><a class="toc-backref" href="#contents">Options</a></h1>
84 <table class="docutils option-list" frame="void" rules="none">
85 <col class="option" />
86 <col class="description" />
87 <tbody valign="top">
88 <tr><td class="option-group" colspan="2">
89 <kbd><span class="option">-r</span>, <span class="option">--rev <var>&lt;REV&gt;</var></span></kbd></td>
90 </tr>
91 <tr><td>&nbsp;</td><td>identify the specified revision</td></tr>
92 <tr><td class="option-group">
93 <kbd><span class="option">-n</span>, <span class="option">--num</span></kbd></td>
94 <td>show local revision number</td></tr>
95 <tr><td class="option-group">
96 <kbd><span class="option">-i</span>, <span class="option">--id</span></kbd></td>
97 <td>show global revision id</td></tr>
98 <tr><td class="option-group">
99 <kbd><span class="option">-b</span>, <span class="option">--branch</span></kbd></td>
100 <td>show branch</td></tr>
101 <tr><td class="option-group">
102 <kbd><span class="option">-t</span>, <span class="option">--tags</span></kbd></td>
103 <td>show tags</td></tr>
104 <tr><td class="option-group" colspan="2">
105 <kbd><span class="option">-B</span>, <span class="option">--bookmarks</span></kbd></td>
106 </tr>
107 <tr><td>&nbsp;</td><td>show bookmarks</td></tr>
108 <tr><td class="option-group" colspan="2">
109 <kbd><span class="option">-e</span>, <span class="option">--ssh <var>&lt;CMD&gt;</var></span></kbd></td>
110 </tr>
111 <tr><td>&nbsp;</td><td>specify ssh command to use</td></tr>
112 <tr><td class="option-group" colspan="2">
113 <kbd><span class="option">--remotecmd <var>&lt;CMD&gt;</var></span></kbd></td>
114 </tr>
115 <tr><td>&nbsp;</td><td>specify hg command to run on the remote side</td></tr>
116 <tr><td class="option-group">
117 <kbd><span class="option">--insecure</span></kbd></td>
118 <td>do not verify server certificate (ignoring web.cacerts config)</td></tr>
119 <tr><td class="option-group" colspan="2">
120 <kbd><span class="option">-T</span>, <span class="option">--template <var>&lt;TEMPLATE&gt;</var></span></kbd></td>
121 </tr>
122 <tr><td>&nbsp;</td><td>display with template</td></tr>
123 </tbody>
124 </table>
125 </div>
126 <div class="section" id="aliases">
127 <h1><a class="toc-backref" href="#contents">Aliases</a></h1>
128 <pre class="literal-block">
129 id
130 </pre>
131 </div>
132 </div>
133 </body>
134 </html>