Debian Codegraph @

doc/html/hg-incoming.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 incoming</title>
8 <link rel="stylesheet" href="../style.css" type="text/css" />
9 </head>
10 <body>
11 <div class="document" id="hg-incoming">
12 <span id="hg-incoming-1"></span>
13 <h1 class="title">hg incoming</h1>
14 <h2 class="subtitle" id="show-new-changesets-found-in-source">show new changesets found in source</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 incoming [-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]
29 </pre>
30 </div>
31 <div class="section" id="description">
32 <h1><a class="toc-backref" href="#contents">Description</a></h1>
33 <p>Show new changesets found in the specified path/URL or the default
34 pull location. These are the changesets that would have been pulled
35 by <a class="reference external" href="hg-pull.html"><tt class="docutils literal">hg pull</tt></a> at the time you issued this command.</p>
36 <p>See pull for valid source format details.</p>
37 <div class="verbose docutils container">
38 <p>With -B/--bookmarks, the result of bookmark comparison between
39 local and remote repositories is displayed. With -v/--verbose,
40 status is also displayed for each bookmark like below:</p>
41 <pre class="literal-block">
42 BM1 01234567890a added
43 BM2 1234567890ab advanced
44 BM3 234567890abc diverged
45 BM4 34567890abcd changed
46 </pre>
47 <p>The action taken locally when pulling depends on the
48 status of each bookmark:</p>
49 <table class="docutils field-list" frame="void" rules="none">
50 <col class="field-name" />
51 <col class="field-body" />
52 <tbody valign="top">
53 <tr class="field"><th class="field-name"><tt class="docutils literal">added</tt>:</th><td class="field-body">pull will create it</td>
54 </tr>
55 <tr class="field"><th class="field-name"><tt class="docutils literal">advanced</tt>:</th><td class="field-body">pull will update it</td>
56 </tr>
57 <tr class="field"><th class="field-name"><tt class="docutils literal">diverged</tt>:</th><td class="field-body">pull will create a divergent bookmark</td>
58 </tr>
59 <tr class="field"><th class="field-name"><tt class="docutils literal">changed</tt>:</th><td class="field-body">result depends on remote changesets</td>
60 </tr>
61 </tbody>
62 </table>
63 <p>From the point of view of pulling behavior, bookmark
64 existing only in the remote repository are treated as <tt class="docutils literal">added</tt>,
65 even if it is in fact locally deleted.</p>
66 </div>
67 <div class="verbose docutils container">
68 <p>For remote repository, using --bundle avoids downloading the
69 changesets twice if the incoming is followed by a pull.</p>
70 <p>Examples:</p>
71 <ul>
72 <li><p class="first">show incoming changes with patches and full description:</p>
73 <pre class="literal-block">
74 hg incoming -vp
75 </pre>
76 </li>
77 <li><p class="first">show incoming changes excluding merges, store a bundle:</p>
78 <pre class="literal-block">
79 hg in -vpM --bundle incoming.hg
80 hg pull incoming.hg
81 </pre>
82 </li>
83 <li><p class="first">briefly list changes inside a bundle:</p>
84 <pre class="literal-block">
85 hg in changes.hg -T &quot;{desc|firstline}\n&quot;
86 </pre>
87 </li>
88 </ul>
89 </div>
90 <p>Returns 0 if there are incoming changes, 1 otherwise.</p>
91 </div>
92 <div class="section" id="options">
93 <h1><a class="toc-backref" href="#contents">Options</a></h1>
94 <table class="docutils option-list" frame="void" rules="none">
95 <col class="option" />
96 <col class="description" />
97 <tbody valign="top">
98 <tr><td class="option-group">
99 <kbd><span class="option">-f</span>, <span class="option">--force</span></kbd></td>
100 <td>run even if remote repository is unrelated</td></tr>
101 <tr><td class="option-group" colspan="2">
102 <kbd><span class="option">-n</span>, <span class="option">--newest-first</span></kbd></td>
103 </tr>
104 <tr><td>&nbsp;</td><td>show newest record first</td></tr>
105 <tr><td class="option-group" colspan="2">
106 <kbd><span class="option">--bundle <var>&lt;FILE&gt;</var></span></kbd></td>
107 </tr>
108 <tr><td>&nbsp;</td><td>file to store the bundles into</td></tr>
109 <tr><td class="option-group" colspan="2">
110 <kbd><span class="option">-r</span>, <span class="option">--rev <var>&lt;REV[+]&gt;</var></span></kbd></td>
111 </tr>
112 <tr><td>&nbsp;</td><td>a remote changeset intended to be added</td></tr>
113 <tr><td class="option-group" colspan="2">
114 <kbd><span class="option">-B</span>, <span class="option">--bookmarks</span></kbd></td>
115 </tr>
116 <tr><td>&nbsp;</td><td>compare bookmarks</td></tr>
117 <tr><td class="option-group" colspan="2">
118 <kbd><span class="option">-b</span>, <span class="option">--branch <var>&lt;BRANCH[+]&gt;</var></span></kbd></td>
119 </tr>
120 <tr><td>&nbsp;</td><td>a specific branch you would like to pull</td></tr>
121 <tr><td class="option-group" colspan="2">
122 <kbd><span class="option">--remote-hidden</span></kbd></td>
123 </tr>
124 <tr><td>&nbsp;</td><td>include changesets hidden on the remote (EXPERIMENTAL)</td></tr>
125 <tr><td class="option-group">
126 <kbd><span class="option">-p</span>, <span class="option">--patch</span></kbd></td>
127 <td>show patch</td></tr>
128 <tr><td class="option-group">
129 <kbd><span class="option">-g</span>, <span class="option">--git</span></kbd></td>
130 <td>use git extended diff format</td></tr>
131 <tr><td class="option-group" colspan="2">
132 <kbd><span class="option">-l</span>, <span class="option">--limit <var>&lt;NUM&gt;</var></span></kbd></td>
133 </tr>
134 <tr><td>&nbsp;</td><td>limit number of changes displayed</td></tr>
135 <tr><td class="option-group" colspan="2">
136 <kbd><span class="option">-M</span>, <span class="option">--no-merges</span></kbd></td>
137 </tr>
138 <tr><td>&nbsp;</td><td>do not show merges</td></tr>
139 <tr><td class="option-group">
140 <kbd><span class="option">--stat</span></kbd></td>
141 <td>output diffstat-style summary of changes</td></tr>
142 <tr><td class="option-group">
143 <kbd><span class="option">-G</span>, <span class="option">--graph</span></kbd></td>
144 <td>show the revision DAG</td></tr>
145 <tr><td class="option-group" colspan="2">
146 <kbd><span class="option">--style <var>&lt;STYLE&gt;</var></span></kbd></td>
147 </tr>
148 <tr><td>&nbsp;</td><td>display using template map file (DEPRECATED)</td></tr>
149 <tr><td class="option-group" colspan="2">
150 <kbd><span class="option">-T</span>, <span class="option">--template <var>&lt;TEMPLATE&gt;</var></span></kbd></td>
151 </tr>
152 <tr><td>&nbsp;</td><td>display with template</td></tr>
153 <tr><td class="option-group" colspan="2">
154 <kbd><span class="option">-e</span>, <span class="option">--ssh <var>&lt;CMD&gt;</var></span></kbd></td>
155 </tr>
156 <tr><td>&nbsp;</td><td>specify ssh command to use</td></tr>
157 <tr><td class="option-group" colspan="2">
158 <kbd><span class="option">--remotecmd <var>&lt;CMD&gt;</var></span></kbd></td>
159 </tr>
160 <tr><td>&nbsp;</td><td>specify hg command to run on the remote side</td></tr>
161 <tr><td class="option-group">
162 <kbd><span class="option">--insecure</span></kbd></td>
163 <td>do not verify server certificate (ignoring web.cacerts config)</td></tr>
164 <tr><td class="option-group">
165 <kbd><span class="option">-S</span>, <span class="option">--subrepos</span></kbd></td>
166 <td>recurse into subrepositories</td></tr>
167 </tbody>
168 </table>
169 <p>[+] marked option can be specified multiple times</p>
170 </div>
171 <div class="section" id="aliases">
172 <h1><a class="toc-backref" href="#contents">Aliases</a></h1>
173 <pre class="literal-block">
174 in
175 </pre>
176 </div>
177 </div>
178 </body>
179 </html>