##// END OF EJS Templates
bookmarks: fix bug that activated a bookmark even with -r passed...
Sean Farley -
r19112:23f785b3 2.6 stable
parent child Browse files
Show More
@@ -1,5860 +1,5860 b''
1 1 # commands.py - command processing for mercurial
2 2 #
3 3 # Copyright 2005-2007 Matt Mackall <mpm@selenic.com>
4 4 #
5 5 # This software may be used and distributed according to the terms of the
6 6 # GNU General Public License version 2 or any later version.
7 7
8 8 from node import hex, bin, nullid, nullrev, short
9 9 from lock import release
10 10 from i18n import _
11 11 import os, re, difflib, time, tempfile, errno
12 12 import hg, scmutil, util, revlog, copies, error, bookmarks
13 13 import patch, help, encoding, templatekw, discovery
14 14 import archival, changegroup, cmdutil, hbisect
15 15 import sshserver, hgweb, hgweb.server, commandserver
16 16 import merge as mergemod
17 17 import minirst, revset, fileset
18 18 import dagparser, context, simplemerge, graphmod
19 19 import random, setdiscovery, treediscovery, dagutil, pvec, localrepo
20 20 import phases, obsolete
21 21
22 22 table = {}
23 23
24 24 command = cmdutil.command(table)
25 25
26 26 # common command options
27 27
28 28 globalopts = [
29 29 ('R', 'repository', '',
30 30 _('repository root directory or name of overlay bundle file'),
31 31 _('REPO')),
32 32 ('', 'cwd', '',
33 33 _('change working directory'), _('DIR')),
34 34 ('y', 'noninteractive', None,
35 35 _('do not prompt, automatically pick the first choice for all prompts')),
36 36 ('q', 'quiet', None, _('suppress output')),
37 37 ('v', 'verbose', None, _('enable additional output')),
38 38 ('', 'config', [],
39 39 _('set/override config option (use \'section.name=value\')'),
40 40 _('CONFIG')),
41 41 ('', 'debug', None, _('enable debugging output')),
42 42 ('', 'debugger', None, _('start debugger')),
43 43 ('', 'encoding', encoding.encoding, _('set the charset encoding'),
44 44 _('ENCODE')),
45 45 ('', 'encodingmode', encoding.encodingmode,
46 46 _('set the charset encoding mode'), _('MODE')),
47 47 ('', 'traceback', None, _('always print a traceback on exception')),
48 48 ('', 'time', None, _('time how long the command takes')),
49 49 ('', 'profile', None, _('print command execution profile')),
50 50 ('', 'version', None, _('output version information and exit')),
51 51 ('h', 'help', None, _('display help and exit')),
52 52 ('', 'hidden', False, _('consider hidden changesets')),
53 53 ]
54 54
55 55 dryrunopts = [('n', 'dry-run', None,
56 56 _('do not perform actions, just print output'))]
57 57
58 58 remoteopts = [
59 59 ('e', 'ssh', '',
60 60 _('specify ssh command to use'), _('CMD')),
61 61 ('', 'remotecmd', '',
62 62 _('specify hg command to run on the remote side'), _('CMD')),
63 63 ('', 'insecure', None,
64 64 _('do not verify server certificate (ignoring web.cacerts config)')),
65 65 ]
66 66
67 67 walkopts = [
68 68 ('I', 'include', [],
69 69 _('include names matching the given patterns'), _('PATTERN')),
70 70 ('X', 'exclude', [],
71 71 _('exclude names matching the given patterns'), _('PATTERN')),
72 72 ]
73 73
74 74 commitopts = [
75 75 ('m', 'message', '',
76 76 _('use text as commit message'), _('TEXT')),
77 77 ('l', 'logfile', '',
78 78 _('read commit message from file'), _('FILE')),
79 79 ]
80 80
81 81 commitopts2 = [
82 82 ('d', 'date', '',
83 83 _('record the specified date as commit date'), _('DATE')),
84 84 ('u', 'user', '',
85 85 _('record the specified user as committer'), _('USER')),
86 86 ]
87 87
88 88 templateopts = [
89 89 ('', 'style', '',
90 90 _('display using template map file'), _('STYLE')),
91 91 ('', 'template', '',
92 92 _('display with template'), _('TEMPLATE')),
93 93 ]
94 94
95 95 logopts = [
96 96 ('p', 'patch', None, _('show patch')),
97 97 ('g', 'git', None, _('use git extended diff format')),
98 98 ('l', 'limit', '',
99 99 _('limit number of changes displayed'), _('NUM')),
100 100 ('M', 'no-merges', None, _('do not show merges')),
101 101 ('', 'stat', None, _('output diffstat-style summary of changes')),
102 102 ('G', 'graph', None, _("show the revision DAG")),
103 103 ] + templateopts
104 104
105 105 diffopts = [
106 106 ('a', 'text', None, _('treat all files as text')),
107 107 ('g', 'git', None, _('use git extended diff format')),
108 108 ('', 'nodates', None, _('omit dates from diff headers'))
109 109 ]
110 110
111 111 diffwsopts = [
112 112 ('w', 'ignore-all-space', None,
113 113 _('ignore white space when comparing lines')),
114 114 ('b', 'ignore-space-change', None,
115 115 _('ignore changes in the amount of white space')),
116 116 ('B', 'ignore-blank-lines', None,
117 117 _('ignore changes whose lines are all blank')),
118 118 ]
119 119
120 120 diffopts2 = [
121 121 ('p', 'show-function', None, _('show which function each change is in')),
122 122 ('', 'reverse', None, _('produce a diff that undoes the changes')),
123 123 ] + diffwsopts + [
124 124 ('U', 'unified', '',
125 125 _('number of lines of context to show'), _('NUM')),
126 126 ('', 'stat', None, _('output diffstat-style summary of changes')),
127 127 ]
128 128
129 129 mergetoolopts = [
130 130 ('t', 'tool', '', _('specify merge tool')),
131 131 ]
132 132
133 133 similarityopts = [
134 134 ('s', 'similarity', '',
135 135 _('guess renamed files by similarity (0<=s<=100)'), _('SIMILARITY'))
136 136 ]
137 137
138 138 subrepoopts = [
139 139 ('S', 'subrepos', None,
140 140 _('recurse into subrepositories'))
141 141 ]
142 142
143 143 # Commands start here, listed alphabetically
144 144
145 145 @command('^add',
146 146 walkopts + subrepoopts + dryrunopts,
147 147 _('[OPTION]... [FILE]...'))
148 148 def add(ui, repo, *pats, **opts):
149 149 """add the specified files on the next commit
150 150
151 151 Schedule files to be version controlled and added to the
152 152 repository.
153 153
154 154 The files will be added to the repository at the next commit. To
155 155 undo an add before that, see :hg:`forget`.
156 156
157 157 If no names are given, add all files to the repository.
158 158
159 159 .. container:: verbose
160 160
161 161 An example showing how new (unknown) files are added
162 162 automatically by :hg:`add`::
163 163
164 164 $ ls
165 165 foo.c
166 166 $ hg status
167 167 ? foo.c
168 168 $ hg add
169 169 adding foo.c
170 170 $ hg status
171 171 A foo.c
172 172
173 173 Returns 0 if all files are successfully added.
174 174 """
175 175
176 176 m = scmutil.match(repo[None], pats, opts)
177 177 rejected = cmdutil.add(ui, repo, m, opts.get('dry_run'),
178 178 opts.get('subrepos'), prefix="", explicitonly=False)
179 179 return rejected and 1 or 0
180 180
181 181 @command('addremove',
182 182 similarityopts + walkopts + dryrunopts,
183 183 _('[OPTION]... [FILE]...'))
184 184 def addremove(ui, repo, *pats, **opts):
185 185 """add all new files, delete all missing files
186 186
187 187 Add all new files and remove all missing files from the
188 188 repository.
189 189
190 190 New files are ignored if they match any of the patterns in
191 191 ``.hgignore``. As with add, these changes take effect at the next
192 192 commit.
193 193
194 194 Use the -s/--similarity option to detect renamed files. This
195 195 option takes a percentage between 0 (disabled) and 100 (files must
196 196 be identical) as its parameter. With a parameter greater than 0,
197 197 this compares every removed file with every added file and records
198 198 those similar enough as renames. Detecting renamed files this way
199 199 can be expensive. After using this option, :hg:`status -C` can be
200 200 used to check which files were identified as moved or renamed. If
201 201 not specified, -s/--similarity defaults to 100 and only renames of
202 202 identical files are detected.
203 203
204 204 Returns 0 if all files are successfully added.
205 205 """
206 206 try:
207 207 sim = float(opts.get('similarity') or 100)
208 208 except ValueError:
209 209 raise util.Abort(_('similarity must be a number'))
210 210 if sim < 0 or sim > 100:
211 211 raise util.Abort(_('similarity must be between 0 and 100'))
212 212 return scmutil.addremove(repo, pats, opts, similarity=sim / 100.0)
213 213
214 214 @command('^annotate|blame',
215 215 [('r', 'rev', '', _('annotate the specified revision'), _('REV')),
216 216 ('', 'follow', None,
217 217 _('follow copies/renames and list the filename (DEPRECATED)')),
218 218 ('', 'no-follow', None, _("don't follow copies and renames")),
219 219 ('a', 'text', None, _('treat all files as text')),
220 220 ('u', 'user', None, _('list the author (long with -v)')),
221 221 ('f', 'file', None, _('list the filename')),
222 222 ('d', 'date', None, _('list the date (short with -q)')),
223 223 ('n', 'number', None, _('list the revision number (default)')),
224 224 ('c', 'changeset', None, _('list the changeset')),
225 225 ('l', 'line-number', None, _('show line number at the first appearance'))
226 226 ] + diffwsopts + walkopts,
227 227 _('[-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...'))
228 228 def annotate(ui, repo, *pats, **opts):
229 229 """show changeset information by line for each file
230 230
231 231 List changes in files, showing the revision id responsible for
232 232 each line
233 233
234 234 This command is useful for discovering when a change was made and
235 235 by whom.
236 236
237 237 Without the -a/--text option, annotate will avoid processing files
238 238 it detects as binary. With -a, annotate will annotate the file
239 239 anyway, although the results will probably be neither useful
240 240 nor desirable.
241 241
242 242 Returns 0 on success.
243 243 """
244 244 if opts.get('follow'):
245 245 # --follow is deprecated and now just an alias for -f/--file
246 246 # to mimic the behavior of Mercurial before version 1.5
247 247 opts['file'] = True
248 248
249 249 datefunc = ui.quiet and util.shortdate or util.datestr
250 250 getdate = util.cachefunc(lambda x: datefunc(x[0].date()))
251 251
252 252 if not pats:
253 253 raise util.Abort(_('at least one filename or pattern is required'))
254 254
255 255 hexfn = ui.debugflag and hex or short
256 256
257 257 opmap = [('user', ' ', lambda x: ui.shortuser(x[0].user())),
258 258 ('number', ' ', lambda x: str(x[0].rev())),
259 259 ('changeset', ' ', lambda x: hexfn(x[0].node())),
260 260 ('date', ' ', getdate),
261 261 ('file', ' ', lambda x: x[0].path()),
262 262 ('line_number', ':', lambda x: str(x[1])),
263 263 ]
264 264
265 265 if (not opts.get('user') and not opts.get('changeset')
266 266 and not opts.get('date') and not opts.get('file')):
267 267 opts['number'] = True
268 268
269 269 linenumber = opts.get('line_number') is not None
270 270 if linenumber and (not opts.get('changeset')) and (not opts.get('number')):
271 271 raise util.Abort(_('at least one of -n/-c is required for -l'))
272 272
273 273 funcmap = [(func, sep) for op, sep, func in opmap if opts.get(op)]
274 274 funcmap[0] = (funcmap[0][0], '') # no separator in front of first column
275 275
276 276 def bad(x, y):
277 277 raise util.Abort("%s: %s" % (x, y))
278 278
279 279 ctx = scmutil.revsingle(repo, opts.get('rev'))
280 280 m = scmutil.match(ctx, pats, opts)
281 281 m.bad = bad
282 282 follow = not opts.get('no_follow')
283 283 diffopts = patch.diffopts(ui, opts, section='annotate')
284 284 for abs in ctx.walk(m):
285 285 fctx = ctx[abs]
286 286 if not opts.get('text') and util.binary(fctx.data()):
287 287 ui.write(_("%s: binary file\n") % ((pats and m.rel(abs)) or abs))
288 288 continue
289 289
290 290 lines = fctx.annotate(follow=follow, linenumber=linenumber,
291 291 diffopts=diffopts)
292 292 pieces = []
293 293
294 294 for f, sep in funcmap:
295 295 l = [f(n) for n, dummy in lines]
296 296 if l:
297 297 sized = [(x, encoding.colwidth(x)) for x in l]
298 298 ml = max([w for x, w in sized])
299 299 pieces.append(["%s%s%s" % (sep, ' ' * (ml - w), x)
300 300 for x, w in sized])
301 301
302 302 if pieces:
303 303 for p, l in zip(zip(*pieces), lines):
304 304 ui.write("%s: %s" % ("".join(p), l[1]))
305 305
306 306 if lines and not lines[-1][1].endswith('\n'):
307 307 ui.write('\n')
308 308
309 309 @command('archive',
310 310 [('', 'no-decode', None, _('do not pass files through decoders')),
311 311 ('p', 'prefix', '', _('directory prefix for files in archive'),
312 312 _('PREFIX')),
313 313 ('r', 'rev', '', _('revision to distribute'), _('REV')),
314 314 ('t', 'type', '', _('type of distribution to create'), _('TYPE')),
315 315 ] + subrepoopts + walkopts,
316 316 _('[OPTION]... DEST'))
317 317 def archive(ui, repo, dest, **opts):
318 318 '''create an unversioned archive of a repository revision
319 319
320 320 By default, the revision used is the parent of the working
321 321 directory; use -r/--rev to specify a different revision.
322 322
323 323 The archive type is automatically detected based on file
324 324 extension (or override using -t/--type).
325 325
326 326 .. container:: verbose
327 327
328 328 Examples:
329 329
330 330 - create a zip file containing the 1.0 release::
331 331
332 332 hg archive -r 1.0 project-1.0.zip
333 333
334 334 - create a tarball excluding .hg files::
335 335
336 336 hg archive project.tar.gz -X ".hg*"
337 337
338 338 Valid types are:
339 339
340 340 :``files``: a directory full of files (default)
341 341 :``tar``: tar archive, uncompressed
342 342 :``tbz2``: tar archive, compressed using bzip2
343 343 :``tgz``: tar archive, compressed using gzip
344 344 :``uzip``: zip archive, uncompressed
345 345 :``zip``: zip archive, compressed using deflate
346 346
347 347 The exact name of the destination archive or directory is given
348 348 using a format string; see :hg:`help export` for details.
349 349
350 350 Each member added to an archive file has a directory prefix
351 351 prepended. Use -p/--prefix to specify a format string for the
352 352 prefix. The default is the basename of the archive, with suffixes
353 353 removed.
354 354
355 355 Returns 0 on success.
356 356 '''
357 357
358 358 ctx = scmutil.revsingle(repo, opts.get('rev'))
359 359 if not ctx:
360 360 raise util.Abort(_('no working directory: please specify a revision'))
361 361 node = ctx.node()
362 362 dest = cmdutil.makefilename(repo, dest, node)
363 363 if os.path.realpath(dest) == repo.root:
364 364 raise util.Abort(_('repository root cannot be destination'))
365 365
366 366 kind = opts.get('type') or archival.guesskind(dest) or 'files'
367 367 prefix = opts.get('prefix')
368 368
369 369 if dest == '-':
370 370 if kind == 'files':
371 371 raise util.Abort(_('cannot archive plain files to stdout'))
372 372 dest = cmdutil.makefileobj(repo, dest)
373 373 if not prefix:
374 374 prefix = os.path.basename(repo.root) + '-%h'
375 375
376 376 prefix = cmdutil.makefilename(repo, prefix, node)
377 377 matchfn = scmutil.match(ctx, [], opts)
378 378 archival.archive(repo, dest, node, kind, not opts.get('no_decode'),
379 379 matchfn, prefix, subrepos=opts.get('subrepos'))
380 380
381 381 @command('backout',
382 382 [('', 'merge', None, _('merge with old dirstate parent after backout')),
383 383 ('', 'parent', '',
384 384 _('parent to choose when backing out merge (DEPRECATED)'), _('REV')),
385 385 ('r', 'rev', '', _('revision to backout'), _('REV')),
386 386 ] + mergetoolopts + walkopts + commitopts + commitopts2,
387 387 _('[OPTION]... [-r] REV'))
388 388 def backout(ui, repo, node=None, rev=None, **opts):
389 389 '''reverse effect of earlier changeset
390 390
391 391 Prepare a new changeset with the effect of REV undone in the
392 392 current working directory.
393 393
394 394 If REV is the parent of the working directory, then this new changeset
395 395 is committed automatically. Otherwise, hg needs to merge the
396 396 changes and the merged result is left uncommitted.
397 397
398 398 .. note::
399 399 backout cannot be used to fix either an unwanted or
400 400 incorrect merge.
401 401
402 402 .. container:: verbose
403 403
404 404 By default, the pending changeset will have one parent,
405 405 maintaining a linear history. With --merge, the pending
406 406 changeset will instead have two parents: the old parent of the
407 407 working directory and a new child of REV that simply undoes REV.
408 408
409 409 Before version 1.7, the behavior without --merge was equivalent
410 410 to specifying --merge followed by :hg:`update --clean .` to
411 411 cancel the merge and leave the child of REV as a head to be
412 412 merged separately.
413 413
414 414 See :hg:`help dates` for a list of formats valid for -d/--date.
415 415
416 416 Returns 0 on success.
417 417 '''
418 418 if rev and node:
419 419 raise util.Abort(_("please specify just one revision"))
420 420
421 421 if not rev:
422 422 rev = node
423 423
424 424 if not rev:
425 425 raise util.Abort(_("please specify a revision to backout"))
426 426
427 427 date = opts.get('date')
428 428 if date:
429 429 opts['date'] = util.parsedate(date)
430 430
431 431 cmdutil.bailifchanged(repo)
432 432 node = scmutil.revsingle(repo, rev).node()
433 433
434 434 op1, op2 = repo.dirstate.parents()
435 435 a = repo.changelog.ancestor(op1, node)
436 436 if a != node:
437 437 raise util.Abort(_('cannot backout change on a different branch'))
438 438
439 439 p1, p2 = repo.changelog.parents(node)
440 440 if p1 == nullid:
441 441 raise util.Abort(_('cannot backout a change with no parents'))
442 442 if p2 != nullid:
443 443 if not opts.get('parent'):
444 444 raise util.Abort(_('cannot backout a merge changeset'))
445 445 p = repo.lookup(opts['parent'])
446 446 if p not in (p1, p2):
447 447 raise util.Abort(_('%s is not a parent of %s') %
448 448 (short(p), short(node)))
449 449 parent = p
450 450 else:
451 451 if opts.get('parent'):
452 452 raise util.Abort(_('cannot use --parent on non-merge changeset'))
453 453 parent = p1
454 454
455 455 # the backout should appear on the same branch
456 456 wlock = repo.wlock()
457 457 try:
458 458 branch = repo.dirstate.branch()
459 459 bheads = repo.branchheads(branch)
460 460 hg.clean(repo, node, show_stats=False)
461 461 repo.dirstate.setbranch(branch)
462 462 rctx = scmutil.revsingle(repo, hex(parent))
463 463 cmdutil.revert(ui, repo, rctx, repo.dirstate.parents())
464 464 if not opts.get('merge') and op1 != node:
465 465 try:
466 466 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''))
467 467 return hg.update(repo, op1)
468 468 finally:
469 469 ui.setconfig('ui', 'forcemerge', '')
470 470
471 471 e = cmdutil.commiteditor
472 472 if not opts['message'] and not opts['logfile']:
473 473 # we don't translate commit messages
474 474 opts['message'] = "Backed out changeset %s" % short(node)
475 475 e = cmdutil.commitforceeditor
476 476
477 477 def commitfunc(ui, repo, message, match, opts):
478 478 return repo.commit(message, opts.get('user'), opts.get('date'),
479 479 match, editor=e)
480 480 newnode = cmdutil.commit(ui, repo, commitfunc, [], opts)
481 481 cmdutil.commitstatus(repo, newnode, branch, bheads)
482 482
483 483 def nice(node):
484 484 return '%d:%s' % (repo.changelog.rev(node), short(node))
485 485 ui.status(_('changeset %s backs out changeset %s\n') %
486 486 (nice(repo.changelog.tip()), nice(node)))
487 487 if opts.get('merge') and op1 != node:
488 488 hg.clean(repo, op1, show_stats=False)
489 489 ui.status(_('merging with changeset %s\n')
490 490 % nice(repo.changelog.tip()))
491 491 try:
492 492 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''))
493 493 return hg.merge(repo, hex(repo.changelog.tip()))
494 494 finally:
495 495 ui.setconfig('ui', 'forcemerge', '')
496 496 finally:
497 497 wlock.release()
498 498 return 0
499 499
500 500 @command('bisect',
501 501 [('r', 'reset', False, _('reset bisect state')),
502 502 ('g', 'good', False, _('mark changeset good')),
503 503 ('b', 'bad', False, _('mark changeset bad')),
504 504 ('s', 'skip', False, _('skip testing changeset')),
505 505 ('e', 'extend', False, _('extend the bisect range')),
506 506 ('c', 'command', '', _('use command to check changeset state'), _('CMD')),
507 507 ('U', 'noupdate', False, _('do not update to target'))],
508 508 _("[-gbsr] [-U] [-c CMD] [REV]"))
509 509 def bisect(ui, repo, rev=None, extra=None, command=None,
510 510 reset=None, good=None, bad=None, skip=None, extend=None,
511 511 noupdate=None):
512 512 """subdivision search of changesets
513 513
514 514 This command helps to find changesets which introduce problems. To
515 515 use, mark the earliest changeset you know exhibits the problem as
516 516 bad, then mark the latest changeset which is free from the problem
517 517 as good. Bisect will update your working directory to a revision
518 518 for testing (unless the -U/--noupdate option is specified). Once
519 519 you have performed tests, mark the working directory as good or
520 520 bad, and bisect will either update to another candidate changeset
521 521 or announce that it has found the bad revision.
522 522
523 523 As a shortcut, you can also use the revision argument to mark a
524 524 revision as good or bad without checking it out first.
525 525
526 526 If you supply a command, it will be used for automatic bisection.
527 527 The environment variable HG_NODE will contain the ID of the
528 528 changeset being tested. The exit status of the command will be
529 529 used to mark revisions as good or bad: status 0 means good, 125
530 530 means to skip the revision, 127 (command not found) will abort the
531 531 bisection, and any other non-zero exit status means the revision
532 532 is bad.
533 533
534 534 .. container:: verbose
535 535
536 536 Some examples:
537 537
538 538 - start a bisection with known bad revision 12, and good revision 34::
539 539
540 540 hg bisect --bad 34
541 541 hg bisect --good 12
542 542
543 543 - advance the current bisection by marking current revision as good or
544 544 bad::
545 545
546 546 hg bisect --good
547 547 hg bisect --bad
548 548
549 549 - mark the current revision, or a known revision, to be skipped (e.g. if
550 550 that revision is not usable because of another issue)::
551 551
552 552 hg bisect --skip
553 553 hg bisect --skip 23
554 554
555 555 - skip all revisions that do not touch directories ``foo`` or ``bar``
556 556
557 557 hg bisect --skip '!( file("path:foo") & file("path:bar") )'
558 558
559 559 - forget the current bisection::
560 560
561 561 hg bisect --reset
562 562
563 563 - use 'make && make tests' to automatically find the first broken
564 564 revision::
565 565
566 566 hg bisect --reset
567 567 hg bisect --bad 34
568 568 hg bisect --good 12
569 569 hg bisect --command 'make && make tests'
570 570
571 571 - see all changesets whose states are already known in the current
572 572 bisection::
573 573
574 574 hg log -r "bisect(pruned)"
575 575
576 576 - see the changeset currently being bisected (especially useful
577 577 if running with -U/--noupdate)::
578 578
579 579 hg log -r "bisect(current)"
580 580
581 581 - see all changesets that took part in the current bisection::
582 582
583 583 hg log -r "bisect(range)"
584 584
585 585 - with the graphlog extension, you can even get a nice graph::
586 586
587 587 hg log --graph -r "bisect(range)"
588 588
589 589 See :hg:`help revsets` for more about the `bisect()` keyword.
590 590
591 591 Returns 0 on success.
592 592 """
593 593 def extendbisectrange(nodes, good):
594 594 # bisect is incomplete when it ends on a merge node and
595 595 # one of the parent was not checked.
596 596 parents = repo[nodes[0]].parents()
597 597 if len(parents) > 1:
598 598 side = good and state['bad'] or state['good']
599 599 num = len(set(i.node() for i in parents) & set(side))
600 600 if num == 1:
601 601 return parents[0].ancestor(parents[1])
602 602 return None
603 603
604 604 def print_result(nodes, good):
605 605 displayer = cmdutil.show_changeset(ui, repo, {})
606 606 if len(nodes) == 1:
607 607 # narrowed it down to a single revision
608 608 if good:
609 609 ui.write(_("The first good revision is:\n"))
610 610 else:
611 611 ui.write(_("The first bad revision is:\n"))
612 612 displayer.show(repo[nodes[0]])
613 613 extendnode = extendbisectrange(nodes, good)
614 614 if extendnode is not None:
615 615 ui.write(_('Not all ancestors of this changeset have been'
616 616 ' checked.\nUse bisect --extend to continue the '
617 617 'bisection from\nthe common ancestor, %s.\n')
618 618 % extendnode)
619 619 else:
620 620 # multiple possible revisions
621 621 if good:
622 622 ui.write(_("Due to skipped revisions, the first "
623 623 "good revision could be any of:\n"))
624 624 else:
625 625 ui.write(_("Due to skipped revisions, the first "
626 626 "bad revision could be any of:\n"))
627 627 for n in nodes:
628 628 displayer.show(repo[n])
629 629 displayer.close()
630 630
631 631 def check_state(state, interactive=True):
632 632 if not state['good'] or not state['bad']:
633 633 if (good or bad or skip or reset) and interactive:
634 634 return
635 635 if not state['good']:
636 636 raise util.Abort(_('cannot bisect (no known good revisions)'))
637 637 else:
638 638 raise util.Abort(_('cannot bisect (no known bad revisions)'))
639 639 return True
640 640
641 641 # backward compatibility
642 642 if rev in "good bad reset init".split():
643 643 ui.warn(_("(use of 'hg bisect <cmd>' is deprecated)\n"))
644 644 cmd, rev, extra = rev, extra, None
645 645 if cmd == "good":
646 646 good = True
647 647 elif cmd == "bad":
648 648 bad = True
649 649 else:
650 650 reset = True
651 651 elif extra or good + bad + skip + reset + extend + bool(command) > 1:
652 652 raise util.Abort(_('incompatible arguments'))
653 653
654 654 if reset:
655 655 p = repo.join("bisect.state")
656 656 if os.path.exists(p):
657 657 os.unlink(p)
658 658 return
659 659
660 660 state = hbisect.load_state(repo)
661 661
662 662 if command:
663 663 changesets = 1
664 664 try:
665 665 node = state['current'][0]
666 666 except LookupError:
667 667 if noupdate:
668 668 raise util.Abort(_('current bisect revision is unknown - '
669 669 'start a new bisect to fix'))
670 670 node, p2 = repo.dirstate.parents()
671 671 if p2 != nullid:
672 672 raise util.Abort(_('current bisect revision is a merge'))
673 673 try:
674 674 while changesets:
675 675 # update state
676 676 state['current'] = [node]
677 677 hbisect.save_state(repo, state)
678 678 status = util.system(command,
679 679 environ={'HG_NODE': hex(node)},
680 680 out=ui.fout)
681 681 if status == 125:
682 682 transition = "skip"
683 683 elif status == 0:
684 684 transition = "good"
685 685 # status < 0 means process was killed
686 686 elif status == 127:
687 687 raise util.Abort(_("failed to execute %s") % command)
688 688 elif status < 0:
689 689 raise util.Abort(_("%s killed") % command)
690 690 else:
691 691 transition = "bad"
692 692 ctx = scmutil.revsingle(repo, rev, node)
693 693 rev = None # clear for future iterations
694 694 state[transition].append(ctx.node())
695 695 ui.status(_('changeset %d:%s: %s\n') % (ctx, ctx, transition))
696 696 check_state(state, interactive=False)
697 697 # bisect
698 698 nodes, changesets, good = hbisect.bisect(repo.changelog, state)
699 699 # update to next check
700 700 node = nodes[0]
701 701 if not noupdate:
702 702 cmdutil.bailifchanged(repo)
703 703 hg.clean(repo, node, show_stats=False)
704 704 finally:
705 705 state['current'] = [node]
706 706 hbisect.save_state(repo, state)
707 707 print_result(nodes, good)
708 708 return
709 709
710 710 # update state
711 711
712 712 if rev:
713 713 nodes = [repo.lookup(i) for i in scmutil.revrange(repo, [rev])]
714 714 else:
715 715 nodes = [repo.lookup('.')]
716 716
717 717 if good or bad or skip:
718 718 if good:
719 719 state['good'] += nodes
720 720 elif bad:
721 721 state['bad'] += nodes
722 722 elif skip:
723 723 state['skip'] += nodes
724 724 hbisect.save_state(repo, state)
725 725
726 726 if not check_state(state):
727 727 return
728 728
729 729 # actually bisect
730 730 nodes, changesets, good = hbisect.bisect(repo.changelog, state)
731 731 if extend:
732 732 if not changesets:
733 733 extendnode = extendbisectrange(nodes, good)
734 734 if extendnode is not None:
735 735 ui.write(_("Extending search to changeset %d:%s\n"
736 736 % (extendnode.rev(), extendnode)))
737 737 state['current'] = [extendnode.node()]
738 738 hbisect.save_state(repo, state)
739 739 if noupdate:
740 740 return
741 741 cmdutil.bailifchanged(repo)
742 742 return hg.clean(repo, extendnode.node())
743 743 raise util.Abort(_("nothing to extend"))
744 744
745 745 if changesets == 0:
746 746 print_result(nodes, good)
747 747 else:
748 748 assert len(nodes) == 1 # only a single node can be tested next
749 749 node = nodes[0]
750 750 # compute the approximate number of remaining tests
751 751 tests, size = 0, 2
752 752 while size <= changesets:
753 753 tests, size = tests + 1, size * 2
754 754 rev = repo.changelog.rev(node)
755 755 ui.write(_("Testing changeset %d:%s "
756 756 "(%d changesets remaining, ~%d tests)\n")
757 757 % (rev, short(node), changesets, tests))
758 758 state['current'] = [node]
759 759 hbisect.save_state(repo, state)
760 760 if not noupdate:
761 761 cmdutil.bailifchanged(repo)
762 762 return hg.clean(repo, node)
763 763
764 764 @command('bookmarks|bookmark',
765 765 [('f', 'force', False, _('force')),
766 766 ('r', 'rev', '', _('revision'), _('REV')),
767 767 ('d', 'delete', False, _('delete a given bookmark')),
768 768 ('m', 'rename', '', _('rename a given bookmark'), _('NAME')),
769 769 ('i', 'inactive', False, _('mark a bookmark inactive'))],
770 770 _('hg bookmarks [-f] [-d] [-i] [-m NAME] [-r REV] [NAME]'))
771 771 def bookmark(ui, repo, mark=None, rev=None, force=False, delete=False,
772 772 rename=None, inactive=False):
773 773 '''track a line of development with movable markers
774 774
775 775 Bookmarks are pointers to certain commits that move when committing.
776 776 Bookmarks are local. They can be renamed, copied and deleted. It is
777 777 possible to use :hg:`merge NAME` to merge from a given bookmark, and
778 778 :hg:`update NAME` to update to a given bookmark.
779 779
780 780 You can use :hg:`bookmark NAME` to set a bookmark on the working
781 781 directory's parent revision with the given name. If you specify
782 782 a revision using -r REV (where REV may be an existing bookmark),
783 783 the bookmark is assigned to that revision.
784 784
785 785 Bookmarks can be pushed and pulled between repositories (see :hg:`help
786 786 push` and :hg:`help pull`). This requires both the local and remote
787 787 repositories to support bookmarks. For versions prior to 1.8, this means
788 788 the bookmarks extension must be enabled.
789 789
790 790 If you set a bookmark called '@', new clones of the repository will
791 791 have that revision checked out (and the bookmark made active) by
792 792 default.
793 793
794 794 With -i/--inactive, the new bookmark will not be made the active
795 795 bookmark. If -r/--rev is given, the new bookmark will not be made
796 796 active even if -i/--inactive is not given. If no NAME is given, the
797 797 current active bookmark will be marked inactive.
798 798 '''
799 799 hexfn = ui.debugflag and hex or short
800 800 marks = repo._bookmarks
801 801 cur = repo.changectx('.').node()
802 802
803 803 def checkformat(mark):
804 804 mark = mark.strip()
805 805 if not mark:
806 806 raise util.Abort(_("bookmark names cannot consist entirely of "
807 807 "whitespace"))
808 808 scmutil.checknewlabel(repo, mark, 'bookmark')
809 809 return mark
810 810
811 811 def checkconflict(repo, mark, force=False, target=None):
812 812 if mark in marks and not force:
813 813 if target:
814 814 if marks[mark] == target and target == cur:
815 815 # re-activating a bookmark
816 816 return
817 817 anc = repo.changelog.ancestors([repo[target].rev()])
818 818 bmctx = repo[marks[mark]]
819 819 divs = [repo[b].node() for b in marks
820 820 if b.split('@', 1)[0] == mark.split('@', 1)[0]]
821 821
822 822 # allow resolving a single divergent bookmark even if moving
823 823 # the bookmark across branches when a revision is specified
824 824 # that contains a divergent bookmark
825 825 if bmctx.rev() not in anc and target in divs:
826 826 bookmarks.deletedivergent(repo, [target], mark)
827 827 return
828 828
829 829 deletefrom = [b for b in divs
830 830 if repo[b].rev() in anc or b == target]
831 831 bookmarks.deletedivergent(repo, deletefrom, mark)
832 832 if bmctx.rev() in anc:
833 833 ui.status(_("moving bookmark '%s' forward from %s\n") %
834 834 (mark, short(bmctx.node())))
835 835 return
836 836 raise util.Abort(_("bookmark '%s' already exists "
837 837 "(use -f to force)") % mark)
838 838 if ((mark in repo.branchmap() or mark == repo.dirstate.branch())
839 839 and not force):
840 840 raise util.Abort(
841 841 _("a bookmark cannot have the name of an existing branch"))
842 842
843 843 if delete and rename:
844 844 raise util.Abort(_("--delete and --rename are incompatible"))
845 845 if delete and rev:
846 846 raise util.Abort(_("--rev is incompatible with --delete"))
847 847 if rename and rev:
848 848 raise util.Abort(_("--rev is incompatible with --rename"))
849 849 if mark is None and (delete or rev):
850 850 raise util.Abort(_("bookmark name required"))
851 851
852 852 if delete:
853 853 if mark not in marks:
854 854 raise util.Abort(_("bookmark '%s' does not exist") % mark)
855 855 if mark == repo._bookmarkcurrent:
856 856 bookmarks.setcurrent(repo, None)
857 857 del marks[mark]
858 858 marks.write()
859 859
860 860 elif rename:
861 861 if mark is None:
862 862 raise util.Abort(_("new bookmark name required"))
863 863 mark = checkformat(mark)
864 864 if rename not in marks:
865 865 raise util.Abort(_("bookmark '%s' does not exist") % rename)
866 866 checkconflict(repo, mark, force)
867 867 marks[mark] = marks[rename]
868 868 if repo._bookmarkcurrent == rename and not inactive:
869 869 bookmarks.setcurrent(repo, mark)
870 870 del marks[rename]
871 871 marks.write()
872 872
873 873 elif mark is not None:
874 874 mark = checkformat(mark)
875 875 if inactive and mark == repo._bookmarkcurrent:
876 876 bookmarks.setcurrent(repo, None)
877 877 return
878 878 tgt = cur
879 879 if rev:
880 880 tgt = scmutil.revsingle(repo, rev).node()
881 881 checkconflict(repo, mark, force, tgt)
882 882 marks[mark] = tgt
883 if not inactive and cur == marks[mark]:
883 if not inactive and cur == marks[mark] and not rev:
884 884 bookmarks.setcurrent(repo, mark)
885 885 elif cur != tgt and mark == repo._bookmarkcurrent:
886 886 bookmarks.setcurrent(repo, None)
887 887 marks.write()
888 888
889 889 # Same message whether trying to deactivate the current bookmark (-i
890 890 # with no NAME) or listing bookmarks
891 891 elif len(marks) == 0:
892 892 ui.status(_("no bookmarks set\n"))
893 893
894 894 elif inactive:
895 895 if not repo._bookmarkcurrent:
896 896 ui.status(_("no active bookmark\n"))
897 897 else:
898 898 bookmarks.setcurrent(repo, None)
899 899
900 900 else: # show bookmarks
901 901 for bmark, n in sorted(marks.iteritems()):
902 902 current = repo._bookmarkcurrent
903 903 if bmark == current:
904 904 prefix, label = '*', 'bookmarks.current'
905 905 else:
906 906 prefix, label = ' ', ''
907 907
908 908 if ui.quiet:
909 909 ui.write("%s\n" % bmark, label=label)
910 910 else:
911 911 ui.write(" %s %-25s %d:%s\n" % (
912 912 prefix, bmark, repo.changelog.rev(n), hexfn(n)),
913 913 label=label)
914 914
915 915 @command('branch',
916 916 [('f', 'force', None,
917 917 _('set branch name even if it shadows an existing branch')),
918 918 ('C', 'clean', None, _('reset branch name to parent branch name'))],
919 919 _('[-fC] [NAME]'))
920 920 def branch(ui, repo, label=None, **opts):
921 921 """set or show the current branch name
922 922
923 923 .. note::
924 924 Branch names are permanent and global. Use :hg:`bookmark` to create a
925 925 light-weight bookmark instead. See :hg:`help glossary` for more
926 926 information about named branches and bookmarks.
927 927
928 928 With no argument, show the current branch name. With one argument,
929 929 set the working directory branch name (the branch will not exist
930 930 in the repository until the next commit). Standard practice
931 931 recommends that primary development take place on the 'default'
932 932 branch.
933 933
934 934 Unless -f/--force is specified, branch will not let you set a
935 935 branch name that already exists, even if it's inactive.
936 936
937 937 Use -C/--clean to reset the working directory branch to that of
938 938 the parent of the working directory, negating a previous branch
939 939 change.
940 940
941 941 Use the command :hg:`update` to switch to an existing branch. Use
942 942 :hg:`commit --close-branch` to mark this branch as closed.
943 943
944 944 Returns 0 on success.
945 945 """
946 946 if not opts.get('clean') and not label:
947 947 ui.write("%s\n" % repo.dirstate.branch())
948 948 return
949 949
950 950 wlock = repo.wlock()
951 951 try:
952 952 if opts.get('clean'):
953 953 label = repo[None].p1().branch()
954 954 repo.dirstate.setbranch(label)
955 955 ui.status(_('reset working directory to branch %s\n') % label)
956 956 elif label:
957 957 if not opts.get('force') and label in repo.branchmap():
958 958 if label not in [p.branch() for p in repo.parents()]:
959 959 raise util.Abort(_('a branch of the same name already'
960 960 ' exists'),
961 961 # i18n: "it" refers to an existing branch
962 962 hint=_("use 'hg update' to switch to it"))
963 963 scmutil.checknewlabel(repo, label, 'branch')
964 964 repo.dirstate.setbranch(label)
965 965 ui.status(_('marked working directory as branch %s\n') % label)
966 966 ui.status(_('(branches are permanent and global, '
967 967 'did you want a bookmark?)\n'))
968 968 finally:
969 969 wlock.release()
970 970
971 971 @command('branches',
972 972 [('a', 'active', False, _('show only branches that have unmerged heads')),
973 973 ('c', 'closed', False, _('show normal and closed branches'))],
974 974 _('[-ac]'))
975 975 def branches(ui, repo, active=False, closed=False):
976 976 """list repository named branches
977 977
978 978 List the repository's named branches, indicating which ones are
979 979 inactive. If -c/--closed is specified, also list branches which have
980 980 been marked closed (see :hg:`commit --close-branch`).
981 981
982 982 If -a/--active is specified, only show active branches. A branch
983 983 is considered active if it contains repository heads.
984 984
985 985 Use the command :hg:`update` to switch to an existing branch.
986 986
987 987 Returns 0.
988 988 """
989 989
990 990 hexfunc = ui.debugflag and hex or short
991 991
992 992 activebranches = set([repo[n].branch() for n in repo.heads()])
993 993 branches = []
994 994 for tag, heads in repo.branchmap().iteritems():
995 995 for h in reversed(heads):
996 996 ctx = repo[h]
997 997 isopen = not ctx.closesbranch()
998 998 if isopen:
999 999 tip = ctx
1000 1000 break
1001 1001 else:
1002 1002 tip = repo[heads[-1]]
1003 1003 isactive = tag in activebranches and isopen
1004 1004 branches.append((tip, isactive, isopen))
1005 1005 branches.sort(key=lambda i: (i[1], i[0].rev(), i[0].branch(), i[2]),
1006 1006 reverse=True)
1007 1007
1008 1008 for ctx, isactive, isopen in branches:
1009 1009 if (not active) or isactive:
1010 1010 if isactive:
1011 1011 label = 'branches.active'
1012 1012 notice = ''
1013 1013 elif not isopen:
1014 1014 if not closed:
1015 1015 continue
1016 1016 label = 'branches.closed'
1017 1017 notice = _(' (closed)')
1018 1018 else:
1019 1019 label = 'branches.inactive'
1020 1020 notice = _(' (inactive)')
1021 1021 if ctx.branch() == repo.dirstate.branch():
1022 1022 label = 'branches.current'
1023 1023 rev = str(ctx.rev()).rjust(31 - encoding.colwidth(ctx.branch()))
1024 1024 rev = ui.label('%s:%s' % (rev, hexfunc(ctx.node())),
1025 1025 'log.changeset changeset.%s' % ctx.phasestr())
1026 1026 tag = ui.label(ctx.branch(), label)
1027 1027 if ui.quiet:
1028 1028 ui.write("%s\n" % tag)
1029 1029 else:
1030 1030 ui.write("%s %s%s\n" % (tag, rev, notice))
1031 1031
1032 1032 @command('bundle',
1033 1033 [('f', 'force', None, _('run even when the destination is unrelated')),
1034 1034 ('r', 'rev', [], _('a changeset intended to be added to the destination'),
1035 1035 _('REV')),
1036 1036 ('b', 'branch', [], _('a specific branch you would like to bundle'),
1037 1037 _('BRANCH')),
1038 1038 ('', 'base', [],
1039 1039 _('a base changeset assumed to be available at the destination'),
1040 1040 _('REV')),
1041 1041 ('a', 'all', None, _('bundle all changesets in the repository')),
1042 1042 ('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE')),
1043 1043 ] + remoteopts,
1044 1044 _('[-f] [-t TYPE] [-a] [-r REV]... [--base REV]... FILE [DEST]'))
1045 1045 def bundle(ui, repo, fname, dest=None, **opts):
1046 1046 """create a changegroup file
1047 1047
1048 1048 Generate a compressed changegroup file collecting changesets not
1049 1049 known to be in another repository.
1050 1050
1051 1051 If you omit the destination repository, then hg assumes the
1052 1052 destination will have all the nodes you specify with --base
1053 1053 parameters. To create a bundle containing all changesets, use
1054 1054 -a/--all (or --base null).
1055 1055
1056 1056 You can change compression method with the -t/--type option.
1057 1057 The available compression methods are: none, bzip2, and
1058 1058 gzip (by default, bundles are compressed using bzip2).
1059 1059
1060 1060 The bundle file can then be transferred using conventional means
1061 1061 and applied to another repository with the unbundle or pull
1062 1062 command. This is useful when direct push and pull are not
1063 1063 available or when exporting an entire repository is undesirable.
1064 1064
1065 1065 Applying bundles preserves all changeset contents including
1066 1066 permissions, copy/rename information, and revision history.
1067 1067
1068 1068 Returns 0 on success, 1 if no changes found.
1069 1069 """
1070 1070 revs = None
1071 1071 if 'rev' in opts:
1072 1072 revs = scmutil.revrange(repo, opts['rev'])
1073 1073
1074 1074 bundletype = opts.get('type', 'bzip2').lower()
1075 1075 btypes = {'none': 'HG10UN', 'bzip2': 'HG10BZ', 'gzip': 'HG10GZ'}
1076 1076 bundletype = btypes.get(bundletype)
1077 1077 if bundletype not in changegroup.bundletypes:
1078 1078 raise util.Abort(_('unknown bundle type specified with --type'))
1079 1079
1080 1080 if opts.get('all'):
1081 1081 base = ['null']
1082 1082 else:
1083 1083 base = scmutil.revrange(repo, opts.get('base'))
1084 1084 if base:
1085 1085 if dest:
1086 1086 raise util.Abort(_("--base is incompatible with specifying "
1087 1087 "a destination"))
1088 1088 common = [repo.lookup(rev) for rev in base]
1089 1089 heads = revs and map(repo.lookup, revs) or revs
1090 1090 cg = repo.getbundle('bundle', heads=heads, common=common)
1091 1091 outgoing = None
1092 1092 else:
1093 1093 dest = ui.expandpath(dest or 'default-push', dest or 'default')
1094 1094 dest, branches = hg.parseurl(dest, opts.get('branch'))
1095 1095 other = hg.peer(repo, opts, dest)
1096 1096 revs, checkout = hg.addbranchrevs(repo, repo, branches, revs)
1097 1097 heads = revs and map(repo.lookup, revs) or revs
1098 1098 outgoing = discovery.findcommonoutgoing(repo, other,
1099 1099 onlyheads=heads,
1100 1100 force=opts.get('force'),
1101 1101 portable=True)
1102 1102 cg = repo.getlocalbundle('bundle', outgoing)
1103 1103 if not cg:
1104 1104 scmutil.nochangesfound(ui, repo, outgoing and outgoing.excluded)
1105 1105 return 1
1106 1106
1107 1107 changegroup.writebundle(cg, fname, bundletype)
1108 1108
1109 1109 @command('cat',
1110 1110 [('o', 'output', '',
1111 1111 _('print output to file with formatted name'), _('FORMAT')),
1112 1112 ('r', 'rev', '', _('print the given revision'), _('REV')),
1113 1113 ('', 'decode', None, _('apply any matching decode filter')),
1114 1114 ] + walkopts,
1115 1115 _('[OPTION]... FILE...'))
1116 1116 def cat(ui, repo, file1, *pats, **opts):
1117 1117 """output the current or given revision of files
1118 1118
1119 1119 Print the specified files as they were at the given revision. If
1120 1120 no revision is given, the parent of the working directory is used,
1121 1121 or tip if no revision is checked out.
1122 1122
1123 1123 Output may be to a file, in which case the name of the file is
1124 1124 given using a format string. The formatting rules are the same as
1125 1125 for the export command, with the following additions:
1126 1126
1127 1127 :``%s``: basename of file being printed
1128 1128 :``%d``: dirname of file being printed, or '.' if in repository root
1129 1129 :``%p``: root-relative path name of file being printed
1130 1130
1131 1131 Returns 0 on success.
1132 1132 """
1133 1133 ctx = scmutil.revsingle(repo, opts.get('rev'))
1134 1134 err = 1
1135 1135 m = scmutil.match(ctx, (file1,) + pats, opts)
1136 1136 for abs in ctx.walk(m):
1137 1137 fp = cmdutil.makefileobj(repo, opts.get('output'), ctx.node(),
1138 1138 pathname=abs)
1139 1139 data = ctx[abs].data()
1140 1140 if opts.get('decode'):
1141 1141 data = repo.wwritedata(abs, data)
1142 1142 fp.write(data)
1143 1143 fp.close()
1144 1144 err = 0
1145 1145 return err
1146 1146
1147 1147 @command('^clone',
1148 1148 [('U', 'noupdate', None,
1149 1149 _('the clone will include an empty working copy (only a repository)')),
1150 1150 ('u', 'updaterev', '', _('revision, tag or branch to check out'), _('REV')),
1151 1151 ('r', 'rev', [], _('include the specified changeset'), _('REV')),
1152 1152 ('b', 'branch', [], _('clone only the specified branch'), _('BRANCH')),
1153 1153 ('', 'pull', None, _('use pull protocol to copy metadata')),
1154 1154 ('', 'uncompressed', None, _('use uncompressed transfer (fast over LAN)')),
1155 1155 ] + remoteopts,
1156 1156 _('[OPTION]... SOURCE [DEST]'))
1157 1157 def clone(ui, source, dest=None, **opts):
1158 1158 """make a copy of an existing repository
1159 1159
1160 1160 Create a copy of an existing repository in a new directory.
1161 1161
1162 1162 If no destination directory name is specified, it defaults to the
1163 1163 basename of the source.
1164 1164
1165 1165 The location of the source is added to the new repository's
1166 1166 ``.hg/hgrc`` file, as the default to be used for future pulls.
1167 1167
1168 1168 Only local paths and ``ssh://`` URLs are supported as
1169 1169 destinations. For ``ssh://`` destinations, no working directory or
1170 1170 ``.hg/hgrc`` will be created on the remote side.
1171 1171
1172 1172 To pull only a subset of changesets, specify one or more revisions
1173 1173 identifiers with -r/--rev or branches with -b/--branch. The
1174 1174 resulting clone will contain only the specified changesets and
1175 1175 their ancestors. These options (or 'clone src#rev dest') imply
1176 1176 --pull, even for local source repositories. Note that specifying a
1177 1177 tag will include the tagged changeset but not the changeset
1178 1178 containing the tag.
1179 1179
1180 1180 If the source repository has a bookmark called '@' set, that
1181 1181 revision will be checked out in the new repository by default.
1182 1182
1183 1183 To check out a particular version, use -u/--update, or
1184 1184 -U/--noupdate to create a clone with no working directory.
1185 1185
1186 1186 .. container:: verbose
1187 1187
1188 1188 For efficiency, hardlinks are used for cloning whenever the
1189 1189 source and destination are on the same filesystem (note this
1190 1190 applies only to the repository data, not to the working
1191 1191 directory). Some filesystems, such as AFS, implement hardlinking
1192 1192 incorrectly, but do not report errors. In these cases, use the
1193 1193 --pull option to avoid hardlinking.
1194 1194
1195 1195 In some cases, you can clone repositories and the working
1196 1196 directory using full hardlinks with ::
1197 1197
1198 1198 $ cp -al REPO REPOCLONE
1199 1199
1200 1200 This is the fastest way to clone, but it is not always safe. The
1201 1201 operation is not atomic (making sure REPO is not modified during
1202 1202 the operation is up to you) and you have to make sure your
1203 1203 editor breaks hardlinks (Emacs and most Linux Kernel tools do
1204 1204 so). Also, this is not compatible with certain extensions that
1205 1205 place their metadata under the .hg directory, such as mq.
1206 1206
1207 1207 Mercurial will update the working directory to the first applicable
1208 1208 revision from this list:
1209 1209
1210 1210 a) null if -U or the source repository has no changesets
1211 1211 b) if -u . and the source repository is local, the first parent of
1212 1212 the source repository's working directory
1213 1213 c) the changeset specified with -u (if a branch name, this means the
1214 1214 latest head of that branch)
1215 1215 d) the changeset specified with -r
1216 1216 e) the tipmost head specified with -b
1217 1217 f) the tipmost head specified with the url#branch source syntax
1218 1218 g) the revision marked with the '@' bookmark, if present
1219 1219 h) the tipmost head of the default branch
1220 1220 i) tip
1221 1221
1222 1222 Examples:
1223 1223
1224 1224 - clone a remote repository to a new directory named hg/::
1225 1225
1226 1226 hg clone http://selenic.com/hg
1227 1227
1228 1228 - create a lightweight local clone::
1229 1229
1230 1230 hg clone project/ project-feature/
1231 1231
1232 1232 - clone from an absolute path on an ssh server (note double-slash)::
1233 1233
1234 1234 hg clone ssh://user@server//home/projects/alpha/
1235 1235
1236 1236 - do a high-speed clone over a LAN while checking out a
1237 1237 specified version::
1238 1238
1239 1239 hg clone --uncompressed http://server/repo -u 1.5
1240 1240
1241 1241 - create a repository without changesets after a particular revision::
1242 1242
1243 1243 hg clone -r 04e544 experimental/ good/
1244 1244
1245 1245 - clone (and track) a particular named branch::
1246 1246
1247 1247 hg clone http://selenic.com/hg#stable
1248 1248
1249 1249 See :hg:`help urls` for details on specifying URLs.
1250 1250
1251 1251 Returns 0 on success.
1252 1252 """
1253 1253 if opts.get('noupdate') and opts.get('updaterev'):
1254 1254 raise util.Abort(_("cannot specify both --noupdate and --updaterev"))
1255 1255
1256 1256 r = hg.clone(ui, opts, source, dest,
1257 1257 pull=opts.get('pull'),
1258 1258 stream=opts.get('uncompressed'),
1259 1259 rev=opts.get('rev'),
1260 1260 update=opts.get('updaterev') or not opts.get('noupdate'),
1261 1261 branch=opts.get('branch'))
1262 1262
1263 1263 return r is None
1264 1264
1265 1265 @command('^commit|ci',
1266 1266 [('A', 'addremove', None,
1267 1267 _('mark new/missing files as added/removed before committing')),
1268 1268 ('', 'close-branch', None,
1269 1269 _('mark a branch as closed, hiding it from the branch list')),
1270 1270 ('', 'amend', None, _('amend the parent of the working dir')),
1271 1271 ] + walkopts + commitopts + commitopts2 + subrepoopts,
1272 1272 _('[OPTION]... [FILE]...'))
1273 1273 def commit(ui, repo, *pats, **opts):
1274 1274 """commit the specified files or all outstanding changes
1275 1275
1276 1276 Commit changes to the given files into the repository. Unlike a
1277 1277 centralized SCM, this operation is a local operation. See
1278 1278 :hg:`push` for a way to actively distribute your changes.
1279 1279
1280 1280 If a list of files is omitted, all changes reported by :hg:`status`
1281 1281 will be committed.
1282 1282
1283 1283 If you are committing the result of a merge, do not provide any
1284 1284 filenames or -I/-X filters.
1285 1285
1286 1286 If no commit message is specified, Mercurial starts your
1287 1287 configured editor where you can enter a message. In case your
1288 1288 commit fails, you will find a backup of your message in
1289 1289 ``.hg/last-message.txt``.
1290 1290
1291 1291 The --amend flag can be used to amend the parent of the
1292 1292 working directory with a new commit that contains the changes
1293 1293 in the parent in addition to those currently reported by :hg:`status`,
1294 1294 if there are any. The old commit is stored in a backup bundle in
1295 1295 ``.hg/strip-backup`` (see :hg:`help bundle` and :hg:`help unbundle`
1296 1296 on how to restore it).
1297 1297
1298 1298 Message, user and date are taken from the amended commit unless
1299 1299 specified. When a message isn't specified on the command line,
1300 1300 the editor will open with the message of the amended commit.
1301 1301
1302 1302 It is not possible to amend public changesets (see :hg:`help phases`)
1303 1303 or changesets that have children.
1304 1304
1305 1305 See :hg:`help dates` for a list of formats valid for -d/--date.
1306 1306
1307 1307 Returns 0 on success, 1 if nothing changed.
1308 1308 """
1309 1309 if opts.get('subrepos'):
1310 1310 # Let --subrepos on the command line override config setting.
1311 1311 ui.setconfig('ui', 'commitsubrepos', True)
1312 1312
1313 1313 extra = {}
1314 1314 if opts.get('close_branch'):
1315 1315 extra['close'] = 1
1316 1316
1317 1317 branch = repo[None].branch()
1318 1318 bheads = repo.branchheads(branch)
1319 1319
1320 1320 if opts.get('amend'):
1321 1321 if ui.configbool('ui', 'commitsubrepos'):
1322 1322 raise util.Abort(_('cannot amend recursively'))
1323 1323
1324 1324 old = repo['.']
1325 1325 if old.phase() == phases.public:
1326 1326 raise util.Abort(_('cannot amend public changesets'))
1327 1327 if len(repo[None].parents()) > 1:
1328 1328 raise util.Abort(_('cannot amend while merging'))
1329 1329 if (not obsolete._enabled) and old.children():
1330 1330 raise util.Abort(_('cannot amend changeset with children'))
1331 1331
1332 1332 e = cmdutil.commiteditor
1333 1333 if opts.get('force_editor'):
1334 1334 e = cmdutil.commitforceeditor
1335 1335
1336 1336 def commitfunc(ui, repo, message, match, opts):
1337 1337 editor = e
1338 1338 # message contains text from -m or -l, if it's empty,
1339 1339 # open the editor with the old message
1340 1340 if not message:
1341 1341 message = old.description()
1342 1342 editor = cmdutil.commitforceeditor
1343 1343 return repo.commit(message,
1344 1344 opts.get('user') or old.user(),
1345 1345 opts.get('date') or old.date(),
1346 1346 match,
1347 1347 editor=editor,
1348 1348 extra=extra)
1349 1349
1350 1350 current = repo._bookmarkcurrent
1351 1351 marks = old.bookmarks()
1352 1352 node = cmdutil.amend(ui, repo, commitfunc, old, extra, pats, opts)
1353 1353 if node == old.node():
1354 1354 ui.status(_("nothing changed\n"))
1355 1355 return 1
1356 1356 elif marks:
1357 1357 ui.debug('moving bookmarks %r from %s to %s\n' %
1358 1358 (marks, old.hex(), hex(node)))
1359 1359 newmarks = repo._bookmarks
1360 1360 for bm in marks:
1361 1361 newmarks[bm] = node
1362 1362 if bm == current:
1363 1363 bookmarks.setcurrent(repo, bm)
1364 1364 newmarks.write()
1365 1365 else:
1366 1366 e = cmdutil.commiteditor
1367 1367 if opts.get('force_editor'):
1368 1368 e = cmdutil.commitforceeditor
1369 1369
1370 1370 def commitfunc(ui, repo, message, match, opts):
1371 1371 return repo.commit(message, opts.get('user'), opts.get('date'),
1372 1372 match, editor=e, extra=extra)
1373 1373
1374 1374 node = cmdutil.commit(ui, repo, commitfunc, pats, opts)
1375 1375
1376 1376 if not node:
1377 1377 stat = repo.status(match=scmutil.match(repo[None], pats, opts))
1378 1378 if stat[3]:
1379 1379 ui.status(_("nothing changed (%d missing files, see "
1380 1380 "'hg status')\n") % len(stat[3]))
1381 1381 else:
1382 1382 ui.status(_("nothing changed\n"))
1383 1383 return 1
1384 1384
1385 1385 cmdutil.commitstatus(repo, node, branch, bheads, opts)
1386 1386
1387 1387 @command('copy|cp',
1388 1388 [('A', 'after', None, _('record a copy that has already occurred')),
1389 1389 ('f', 'force', None, _('forcibly copy over an existing managed file')),
1390 1390 ] + walkopts + dryrunopts,
1391 1391 _('[OPTION]... [SOURCE]... DEST'))
1392 1392 def copy(ui, repo, *pats, **opts):
1393 1393 """mark files as copied for the next commit
1394 1394
1395 1395 Mark dest as having copies of source files. If dest is a
1396 1396 directory, copies are put in that directory. If dest is a file,
1397 1397 the source must be a single file.
1398 1398
1399 1399 By default, this command copies the contents of files as they
1400 1400 exist in the working directory. If invoked with -A/--after, the
1401 1401 operation is recorded, but no copying is performed.
1402 1402
1403 1403 This command takes effect with the next commit. To undo a copy
1404 1404 before that, see :hg:`revert`.
1405 1405
1406 1406 Returns 0 on success, 1 if errors are encountered.
1407 1407 """
1408 1408 wlock = repo.wlock(False)
1409 1409 try:
1410 1410 return cmdutil.copy(ui, repo, pats, opts)
1411 1411 finally:
1412 1412 wlock.release()
1413 1413
1414 1414 @command('debugancestor', [], _('[INDEX] REV1 REV2'))
1415 1415 def debugancestor(ui, repo, *args):
1416 1416 """find the ancestor revision of two revisions in a given index"""
1417 1417 if len(args) == 3:
1418 1418 index, rev1, rev2 = args
1419 1419 r = revlog.revlog(scmutil.opener(os.getcwd(), audit=False), index)
1420 1420 lookup = r.lookup
1421 1421 elif len(args) == 2:
1422 1422 if not repo:
1423 1423 raise util.Abort(_("there is no Mercurial repository here "
1424 1424 "(.hg not found)"))
1425 1425 rev1, rev2 = args
1426 1426 r = repo.changelog
1427 1427 lookup = repo.lookup
1428 1428 else:
1429 1429 raise util.Abort(_('either two or three arguments required'))
1430 1430 a = r.ancestor(lookup(rev1), lookup(rev2))
1431 1431 ui.write("%d:%s\n" % (r.rev(a), hex(a)))
1432 1432
1433 1433 @command('debugbuilddag',
1434 1434 [('m', 'mergeable-file', None, _('add single file mergeable changes')),
1435 1435 ('o', 'overwritten-file', None, _('add single file all revs overwrite')),
1436 1436 ('n', 'new-file', None, _('add new file at each rev'))],
1437 1437 _('[OPTION]... [TEXT]'))
1438 1438 def debugbuilddag(ui, repo, text=None,
1439 1439 mergeable_file=False,
1440 1440 overwritten_file=False,
1441 1441 new_file=False):
1442 1442 """builds a repo with a given DAG from scratch in the current empty repo
1443 1443
1444 1444 The description of the DAG is read from stdin if not given on the
1445 1445 command line.
1446 1446
1447 1447 Elements:
1448 1448
1449 1449 - "+n" is a linear run of n nodes based on the current default parent
1450 1450 - "." is a single node based on the current default parent
1451 1451 - "$" resets the default parent to null (implied at the start);
1452 1452 otherwise the default parent is always the last node created
1453 1453 - "<p" sets the default parent to the backref p
1454 1454 - "*p" is a fork at parent p, which is a backref
1455 1455 - "*p1/p2" is a merge of parents p1 and p2, which are backrefs
1456 1456 - "/p2" is a merge of the preceding node and p2
1457 1457 - ":tag" defines a local tag for the preceding node
1458 1458 - "@branch" sets the named branch for subsequent nodes
1459 1459 - "#...\\n" is a comment up to the end of the line
1460 1460
1461 1461 Whitespace between the above elements is ignored.
1462 1462
1463 1463 A backref is either
1464 1464
1465 1465 - a number n, which references the node curr-n, where curr is the current
1466 1466 node, or
1467 1467 - the name of a local tag you placed earlier using ":tag", or
1468 1468 - empty to denote the default parent.
1469 1469
1470 1470 All string valued-elements are either strictly alphanumeric, or must
1471 1471 be enclosed in double quotes ("..."), with "\\" as escape character.
1472 1472 """
1473 1473
1474 1474 if text is None:
1475 1475 ui.status(_("reading DAG from stdin\n"))
1476 1476 text = ui.fin.read()
1477 1477
1478 1478 cl = repo.changelog
1479 1479 if len(cl) > 0:
1480 1480 raise util.Abort(_('repository is not empty'))
1481 1481
1482 1482 # determine number of revs in DAG
1483 1483 total = 0
1484 1484 for type, data in dagparser.parsedag(text):
1485 1485 if type == 'n':
1486 1486 total += 1
1487 1487
1488 1488 if mergeable_file:
1489 1489 linesperrev = 2
1490 1490 # make a file with k lines per rev
1491 1491 initialmergedlines = [str(i) for i in xrange(0, total * linesperrev)]
1492 1492 initialmergedlines.append("")
1493 1493
1494 1494 tags = []
1495 1495
1496 1496 lock = tr = None
1497 1497 try:
1498 1498 lock = repo.lock()
1499 1499 tr = repo.transaction("builddag")
1500 1500
1501 1501 at = -1
1502 1502 atbranch = 'default'
1503 1503 nodeids = []
1504 1504 id = 0
1505 1505 ui.progress(_('building'), id, unit=_('revisions'), total=total)
1506 1506 for type, data in dagparser.parsedag(text):
1507 1507 if type == 'n':
1508 1508 ui.note(('node %s\n' % str(data)))
1509 1509 id, ps = data
1510 1510
1511 1511 files = []
1512 1512 fctxs = {}
1513 1513
1514 1514 p2 = None
1515 1515 if mergeable_file:
1516 1516 fn = "mf"
1517 1517 p1 = repo[ps[0]]
1518 1518 if len(ps) > 1:
1519 1519 p2 = repo[ps[1]]
1520 1520 pa = p1.ancestor(p2)
1521 1521 base, local, other = [x[fn].data() for x in (pa, p1,
1522 1522 p2)]
1523 1523 m3 = simplemerge.Merge3Text(base, local, other)
1524 1524 ml = [l.strip() for l in m3.merge_lines()]
1525 1525 ml.append("")
1526 1526 elif at > 0:
1527 1527 ml = p1[fn].data().split("\n")
1528 1528 else:
1529 1529 ml = initialmergedlines
1530 1530 ml[id * linesperrev] += " r%i" % id
1531 1531 mergedtext = "\n".join(ml)
1532 1532 files.append(fn)
1533 1533 fctxs[fn] = context.memfilectx(fn, mergedtext)
1534 1534
1535 1535 if overwritten_file:
1536 1536 fn = "of"
1537 1537 files.append(fn)
1538 1538 fctxs[fn] = context.memfilectx(fn, "r%i\n" % id)
1539 1539
1540 1540 if new_file:
1541 1541 fn = "nf%i" % id
1542 1542 files.append(fn)
1543 1543 fctxs[fn] = context.memfilectx(fn, "r%i\n" % id)
1544 1544 if len(ps) > 1:
1545 1545 if not p2:
1546 1546 p2 = repo[ps[1]]
1547 1547 for fn in p2:
1548 1548 if fn.startswith("nf"):
1549 1549 files.append(fn)
1550 1550 fctxs[fn] = p2[fn]
1551 1551
1552 1552 def fctxfn(repo, cx, path):
1553 1553 return fctxs.get(path)
1554 1554
1555 1555 if len(ps) == 0 or ps[0] < 0:
1556 1556 pars = [None, None]
1557 1557 elif len(ps) == 1:
1558 1558 pars = [nodeids[ps[0]], None]
1559 1559 else:
1560 1560 pars = [nodeids[p] for p in ps]
1561 1561 cx = context.memctx(repo, pars, "r%i" % id, files, fctxfn,
1562 1562 date=(id, 0),
1563 1563 user="debugbuilddag",
1564 1564 extra={'branch': atbranch})
1565 1565 nodeid = repo.commitctx(cx)
1566 1566 nodeids.append(nodeid)
1567 1567 at = id
1568 1568 elif type == 'l':
1569 1569 id, name = data
1570 1570 ui.note(('tag %s\n' % name))
1571 1571 tags.append("%s %s\n" % (hex(repo.changelog.node(id)), name))
1572 1572 elif type == 'a':
1573 1573 ui.note(('branch %s\n' % data))
1574 1574 atbranch = data
1575 1575 ui.progress(_('building'), id, unit=_('revisions'), total=total)
1576 1576 tr.close()
1577 1577
1578 1578 if tags:
1579 1579 repo.opener.write("localtags", "".join(tags))
1580 1580 finally:
1581 1581 ui.progress(_('building'), None)
1582 1582 release(tr, lock)
1583 1583
1584 1584 @command('debugbundle', [('a', 'all', None, _('show all details'))], _('FILE'))
1585 1585 def debugbundle(ui, bundlepath, all=None, **opts):
1586 1586 """lists the contents of a bundle"""
1587 1587 f = hg.openpath(ui, bundlepath)
1588 1588 try:
1589 1589 gen = changegroup.readbundle(f, bundlepath)
1590 1590 if all:
1591 1591 ui.write(("format: id, p1, p2, cset, delta base, len(delta)\n"))
1592 1592
1593 1593 def showchunks(named):
1594 1594 ui.write("\n%s\n" % named)
1595 1595 chain = None
1596 1596 while True:
1597 1597 chunkdata = gen.deltachunk(chain)
1598 1598 if not chunkdata:
1599 1599 break
1600 1600 node = chunkdata['node']
1601 1601 p1 = chunkdata['p1']
1602 1602 p2 = chunkdata['p2']
1603 1603 cs = chunkdata['cs']
1604 1604 deltabase = chunkdata['deltabase']
1605 1605 delta = chunkdata['delta']
1606 1606 ui.write("%s %s %s %s %s %s\n" %
1607 1607 (hex(node), hex(p1), hex(p2),
1608 1608 hex(cs), hex(deltabase), len(delta)))
1609 1609 chain = node
1610 1610
1611 1611 chunkdata = gen.changelogheader()
1612 1612 showchunks("changelog")
1613 1613 chunkdata = gen.manifestheader()
1614 1614 showchunks("manifest")
1615 1615 while True:
1616 1616 chunkdata = gen.filelogheader()
1617 1617 if not chunkdata:
1618 1618 break
1619 1619 fname = chunkdata['filename']
1620 1620 showchunks(fname)
1621 1621 else:
1622 1622 chunkdata = gen.changelogheader()
1623 1623 chain = None
1624 1624 while True:
1625 1625 chunkdata = gen.deltachunk(chain)
1626 1626 if not chunkdata:
1627 1627 break
1628 1628 node = chunkdata['node']
1629 1629 ui.write("%s\n" % hex(node))
1630 1630 chain = node
1631 1631 finally:
1632 1632 f.close()
1633 1633
1634 1634 @command('debugcheckstate', [], '')
1635 1635 def debugcheckstate(ui, repo):
1636 1636 """validate the correctness of the current dirstate"""
1637 1637 parent1, parent2 = repo.dirstate.parents()
1638 1638 m1 = repo[parent1].manifest()
1639 1639 m2 = repo[parent2].manifest()
1640 1640 errors = 0
1641 1641 for f in repo.dirstate:
1642 1642 state = repo.dirstate[f]
1643 1643 if state in "nr" and f not in m1:
1644 1644 ui.warn(_("%s in state %s, but not in manifest1\n") % (f, state))
1645 1645 errors += 1
1646 1646 if state in "a" and f in m1:
1647 1647 ui.warn(_("%s in state %s, but also in manifest1\n") % (f, state))
1648 1648 errors += 1
1649 1649 if state in "m" and f not in m1 and f not in m2:
1650 1650 ui.warn(_("%s in state %s, but not in either manifest\n") %
1651 1651 (f, state))
1652 1652 errors += 1
1653 1653 for f in m1:
1654 1654 state = repo.dirstate[f]
1655 1655 if state not in "nrm":
1656 1656 ui.warn(_("%s in manifest1, but listed as state %s") % (f, state))
1657 1657 errors += 1
1658 1658 if errors:
1659 1659 error = _(".hg/dirstate inconsistent with current parent's manifest")
1660 1660 raise util.Abort(error)
1661 1661
1662 1662 @command('debugcommands', [], _('[COMMAND]'))
1663 1663 def debugcommands(ui, cmd='', *args):
1664 1664 """list all available commands and options"""
1665 1665 for cmd, vals in sorted(table.iteritems()):
1666 1666 cmd = cmd.split('|')[0].strip('^')
1667 1667 opts = ', '.join([i[1] for i in vals[1]])
1668 1668 ui.write('%s: %s\n' % (cmd, opts))
1669 1669
1670 1670 @command('debugcomplete',
1671 1671 [('o', 'options', None, _('show the command options'))],
1672 1672 _('[-o] CMD'))
1673 1673 def debugcomplete(ui, cmd='', **opts):
1674 1674 """returns the completion list associated with the given command"""
1675 1675
1676 1676 if opts.get('options'):
1677 1677 options = []
1678 1678 otables = [globalopts]
1679 1679 if cmd:
1680 1680 aliases, entry = cmdutil.findcmd(cmd, table, False)
1681 1681 otables.append(entry[1])
1682 1682 for t in otables:
1683 1683 for o in t:
1684 1684 if "(DEPRECATED)" in o[3]:
1685 1685 continue
1686 1686 if o[0]:
1687 1687 options.append('-%s' % o[0])
1688 1688 options.append('--%s' % o[1])
1689 1689 ui.write("%s\n" % "\n".join(options))
1690 1690 return
1691 1691
1692 1692 cmdlist = cmdutil.findpossible(cmd, table)
1693 1693 if ui.verbose:
1694 1694 cmdlist = [' '.join(c[0]) for c in cmdlist.values()]
1695 1695 ui.write("%s\n" % "\n".join(sorted(cmdlist)))
1696 1696
1697 1697 @command('debugdag',
1698 1698 [('t', 'tags', None, _('use tags as labels')),
1699 1699 ('b', 'branches', None, _('annotate with branch names')),
1700 1700 ('', 'dots', None, _('use dots for runs')),
1701 1701 ('s', 'spaces', None, _('separate elements by spaces'))],
1702 1702 _('[OPTION]... [FILE [REV]...]'))
1703 1703 def debugdag(ui, repo, file_=None, *revs, **opts):
1704 1704 """format the changelog or an index DAG as a concise textual description
1705 1705
1706 1706 If you pass a revlog index, the revlog's DAG is emitted. If you list
1707 1707 revision numbers, they get labeled in the output as rN.
1708 1708
1709 1709 Otherwise, the changelog DAG of the current repo is emitted.
1710 1710 """
1711 1711 spaces = opts.get('spaces')
1712 1712 dots = opts.get('dots')
1713 1713 if file_:
1714 1714 rlog = revlog.revlog(scmutil.opener(os.getcwd(), audit=False), file_)
1715 1715 revs = set((int(r) for r in revs))
1716 1716 def events():
1717 1717 for r in rlog:
1718 1718 yield 'n', (r, list(set(p for p in rlog.parentrevs(r)
1719 1719 if p != -1)))
1720 1720 if r in revs:
1721 1721 yield 'l', (r, "r%i" % r)
1722 1722 elif repo:
1723 1723 cl = repo.changelog
1724 1724 tags = opts.get('tags')
1725 1725 branches = opts.get('branches')
1726 1726 if tags:
1727 1727 labels = {}
1728 1728 for l, n in repo.tags().items():
1729 1729 labels.setdefault(cl.rev(n), []).append(l)
1730 1730 def events():
1731 1731 b = "default"
1732 1732 for r in cl:
1733 1733 if branches:
1734 1734 newb = cl.read(cl.node(r))[5]['branch']
1735 1735 if newb != b:
1736 1736 yield 'a', newb
1737 1737 b = newb
1738 1738 yield 'n', (r, list(set(p for p in cl.parentrevs(r)
1739 1739 if p != -1)))
1740 1740 if tags:
1741 1741 ls = labels.get(r)
1742 1742 if ls:
1743 1743 for l in ls:
1744 1744 yield 'l', (r, l)
1745 1745 else:
1746 1746 raise util.Abort(_('need repo for changelog dag'))
1747 1747
1748 1748 for line in dagparser.dagtextlines(events(),
1749 1749 addspaces=spaces,
1750 1750 wraplabels=True,
1751 1751 wrapannotations=True,
1752 1752 wrapnonlinear=dots,
1753 1753 usedots=dots,
1754 1754 maxlinewidth=70):
1755 1755 ui.write(line)
1756 1756 ui.write("\n")
1757 1757
1758 1758 @command('debugdata',
1759 1759 [('c', 'changelog', False, _('open changelog')),
1760 1760 ('m', 'manifest', False, _('open manifest'))],
1761 1761 _('-c|-m|FILE REV'))
1762 1762 def debugdata(ui, repo, file_, rev = None, **opts):
1763 1763 """dump the contents of a data file revision"""
1764 1764 if opts.get('changelog') or opts.get('manifest'):
1765 1765 file_, rev = None, file_
1766 1766 elif rev is None:
1767 1767 raise error.CommandError('debugdata', _('invalid arguments'))
1768 1768 r = cmdutil.openrevlog(repo, 'debugdata', file_, opts)
1769 1769 try:
1770 1770 ui.write(r.revision(r.lookup(rev)))
1771 1771 except KeyError:
1772 1772 raise util.Abort(_('invalid revision identifier %s') % rev)
1773 1773
1774 1774 @command('debugdate',
1775 1775 [('e', 'extended', None, _('try extended date formats'))],
1776 1776 _('[-e] DATE [RANGE]'))
1777 1777 def debugdate(ui, date, range=None, **opts):
1778 1778 """parse and display a date"""
1779 1779 if opts["extended"]:
1780 1780 d = util.parsedate(date, util.extendeddateformats)
1781 1781 else:
1782 1782 d = util.parsedate(date)
1783 1783 ui.write(("internal: %s %s\n") % d)
1784 1784 ui.write(("standard: %s\n") % util.datestr(d))
1785 1785 if range:
1786 1786 m = util.matchdate(range)
1787 1787 ui.write(("match: %s\n") % m(d[0]))
1788 1788
1789 1789 @command('debugdiscovery',
1790 1790 [('', 'old', None, _('use old-style discovery')),
1791 1791 ('', 'nonheads', None,
1792 1792 _('use old-style discovery with non-heads included')),
1793 1793 ] + remoteopts,
1794 1794 _('[-l REV] [-r REV] [-b BRANCH]... [OTHER]'))
1795 1795 def debugdiscovery(ui, repo, remoteurl="default", **opts):
1796 1796 """runs the changeset discovery protocol in isolation"""
1797 1797 remoteurl, branches = hg.parseurl(ui.expandpath(remoteurl),
1798 1798 opts.get('branch'))
1799 1799 remote = hg.peer(repo, opts, remoteurl)
1800 1800 ui.status(_('comparing with %s\n') % util.hidepassword(remoteurl))
1801 1801
1802 1802 # make sure tests are repeatable
1803 1803 random.seed(12323)
1804 1804
1805 1805 def doit(localheads, remoteheads, remote=remote):
1806 1806 if opts.get('old'):
1807 1807 if localheads:
1808 1808 raise util.Abort('cannot use localheads with old style '
1809 1809 'discovery')
1810 1810 if not util.safehasattr(remote, 'branches'):
1811 1811 # enable in-client legacy support
1812 1812 remote = localrepo.locallegacypeer(remote.local())
1813 1813 common, _in, hds = treediscovery.findcommonincoming(repo, remote,
1814 1814 force=True)
1815 1815 common = set(common)
1816 1816 if not opts.get('nonheads'):
1817 1817 ui.write(("unpruned common: %s\n") %
1818 1818 " ".join(sorted(short(n) for n in common)))
1819 1819 dag = dagutil.revlogdag(repo.changelog)
1820 1820 all = dag.ancestorset(dag.internalizeall(common))
1821 1821 common = dag.externalizeall(dag.headsetofconnecteds(all))
1822 1822 else:
1823 1823 common, any, hds = setdiscovery.findcommonheads(ui, repo, remote)
1824 1824 common = set(common)
1825 1825 rheads = set(hds)
1826 1826 lheads = set(repo.heads())
1827 1827 ui.write(("common heads: %s\n") %
1828 1828 " ".join(sorted(short(n) for n in common)))
1829 1829 if lheads <= common:
1830 1830 ui.write(("local is subset\n"))
1831 1831 elif rheads <= common:
1832 1832 ui.write(("remote is subset\n"))
1833 1833
1834 1834 serverlogs = opts.get('serverlog')
1835 1835 if serverlogs:
1836 1836 for filename in serverlogs:
1837 1837 logfile = open(filename, 'r')
1838 1838 try:
1839 1839 line = logfile.readline()
1840 1840 while line:
1841 1841 parts = line.strip().split(';')
1842 1842 op = parts[1]
1843 1843 if op == 'cg':
1844 1844 pass
1845 1845 elif op == 'cgss':
1846 1846 doit(parts[2].split(' '), parts[3].split(' '))
1847 1847 elif op == 'unb':
1848 1848 doit(parts[3].split(' '), parts[2].split(' '))
1849 1849 line = logfile.readline()
1850 1850 finally:
1851 1851 logfile.close()
1852 1852
1853 1853 else:
1854 1854 remoterevs, _checkout = hg.addbranchrevs(repo, remote, branches,
1855 1855 opts.get('remote_head'))
1856 1856 localrevs = opts.get('local_head')
1857 1857 doit(localrevs, remoterevs)
1858 1858
1859 1859 @command('debugfileset',
1860 1860 [('r', 'rev', '', _('apply the filespec on this revision'), _('REV'))],
1861 1861 _('[-r REV] FILESPEC'))
1862 1862 def debugfileset(ui, repo, expr, **opts):
1863 1863 '''parse and apply a fileset specification'''
1864 1864 ctx = scmutil.revsingle(repo, opts.get('rev'), None)
1865 1865 if ui.verbose:
1866 1866 tree = fileset.parse(expr)[0]
1867 1867 ui.note(tree, "\n")
1868 1868
1869 1869 for f in fileset.getfileset(ctx, expr):
1870 1870 ui.write("%s\n" % f)
1871 1871
1872 1872 @command('debugfsinfo', [], _('[PATH]'))
1873 1873 def debugfsinfo(ui, path = "."):
1874 1874 """show information detected about current filesystem"""
1875 1875 util.writefile('.debugfsinfo', '')
1876 1876 ui.write(('exec: %s\n') % (util.checkexec(path) and 'yes' or 'no'))
1877 1877 ui.write(('symlink: %s\n') % (util.checklink(path) and 'yes' or 'no'))
1878 1878 ui.write(('case-sensitive: %s\n') % (util.checkcase('.debugfsinfo')
1879 1879 and 'yes' or 'no'))
1880 1880 os.unlink('.debugfsinfo')
1881 1881
1882 1882 @command('debuggetbundle',
1883 1883 [('H', 'head', [], _('id of head node'), _('ID')),
1884 1884 ('C', 'common', [], _('id of common node'), _('ID')),
1885 1885 ('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE'))],
1886 1886 _('REPO FILE [-H|-C ID]...'))
1887 1887 def debuggetbundle(ui, repopath, bundlepath, head=None, common=None, **opts):
1888 1888 """retrieves a bundle from a repo
1889 1889
1890 1890 Every ID must be a full-length hex node id string. Saves the bundle to the
1891 1891 given file.
1892 1892 """
1893 1893 repo = hg.peer(ui, opts, repopath)
1894 1894 if not repo.capable('getbundle'):
1895 1895 raise util.Abort("getbundle() not supported by target repository")
1896 1896 args = {}
1897 1897 if common:
1898 1898 args['common'] = [bin(s) for s in common]
1899 1899 if head:
1900 1900 args['heads'] = [bin(s) for s in head]
1901 1901 bundle = repo.getbundle('debug', **args)
1902 1902
1903 1903 bundletype = opts.get('type', 'bzip2').lower()
1904 1904 btypes = {'none': 'HG10UN', 'bzip2': 'HG10BZ', 'gzip': 'HG10GZ'}
1905 1905 bundletype = btypes.get(bundletype)
1906 1906 if bundletype not in changegroup.bundletypes:
1907 1907 raise util.Abort(_('unknown bundle type specified with --type'))
1908 1908 changegroup.writebundle(bundle, bundlepath, bundletype)
1909 1909
1910 1910 @command('debugignore', [], '')
1911 1911 def debugignore(ui, repo, *values, **opts):
1912 1912 """display the combined ignore pattern"""
1913 1913 ignore = repo.dirstate._ignore
1914 1914 includepat = getattr(ignore, 'includepat', None)
1915 1915 if includepat is not None:
1916 1916 ui.write("%s\n" % includepat)
1917 1917 else:
1918 1918 raise util.Abort(_("no ignore patterns found"))
1919 1919
1920 1920 @command('debugindex',
1921 1921 [('c', 'changelog', False, _('open changelog')),
1922 1922 ('m', 'manifest', False, _('open manifest')),
1923 1923 ('f', 'format', 0, _('revlog format'), _('FORMAT'))],
1924 1924 _('[-f FORMAT] -c|-m|FILE'))
1925 1925 def debugindex(ui, repo, file_ = None, **opts):
1926 1926 """dump the contents of an index file"""
1927 1927 r = cmdutil.openrevlog(repo, 'debugindex', file_, opts)
1928 1928 format = opts.get('format', 0)
1929 1929 if format not in (0, 1):
1930 1930 raise util.Abort(_("unknown format %d") % format)
1931 1931
1932 1932 generaldelta = r.version & revlog.REVLOGGENERALDELTA
1933 1933 if generaldelta:
1934 1934 basehdr = ' delta'
1935 1935 else:
1936 1936 basehdr = ' base'
1937 1937
1938 1938 if format == 0:
1939 1939 ui.write(" rev offset length " + basehdr + " linkrev"
1940 1940 " nodeid p1 p2\n")
1941 1941 elif format == 1:
1942 1942 ui.write(" rev flag offset length"
1943 1943 " size " + basehdr + " link p1 p2"
1944 1944 " nodeid\n")
1945 1945
1946 1946 for i in r:
1947 1947 node = r.node(i)
1948 1948 if generaldelta:
1949 1949 base = r.deltaparent(i)
1950 1950 else:
1951 1951 base = r.chainbase(i)
1952 1952 if format == 0:
1953 1953 try:
1954 1954 pp = r.parents(node)
1955 1955 except Exception:
1956 1956 pp = [nullid, nullid]
1957 1957 ui.write("% 6d % 9d % 7d % 6d % 7d %s %s %s\n" % (
1958 1958 i, r.start(i), r.length(i), base, r.linkrev(i),
1959 1959 short(node), short(pp[0]), short(pp[1])))
1960 1960 elif format == 1:
1961 1961 pr = r.parentrevs(i)
1962 1962 ui.write("% 6d %04x % 8d % 8d % 8d % 6d % 6d % 6d % 6d %s\n" % (
1963 1963 i, r.flags(i), r.start(i), r.length(i), r.rawsize(i),
1964 1964 base, r.linkrev(i), pr[0], pr[1], short(node)))
1965 1965
1966 1966 @command('debugindexdot', [], _('FILE'))
1967 1967 def debugindexdot(ui, repo, file_):
1968 1968 """dump an index DAG as a graphviz dot file"""
1969 1969 r = None
1970 1970 if repo:
1971 1971 filelog = repo.file(file_)
1972 1972 if len(filelog):
1973 1973 r = filelog
1974 1974 if not r:
1975 1975 r = revlog.revlog(scmutil.opener(os.getcwd(), audit=False), file_)
1976 1976 ui.write(("digraph G {\n"))
1977 1977 for i in r:
1978 1978 node = r.node(i)
1979 1979 pp = r.parents(node)
1980 1980 ui.write("\t%d -> %d\n" % (r.rev(pp[0]), i))
1981 1981 if pp[1] != nullid:
1982 1982 ui.write("\t%d -> %d\n" % (r.rev(pp[1]), i))
1983 1983 ui.write("}\n")
1984 1984
1985 1985 @command('debuginstall', [], '')
1986 1986 def debuginstall(ui):
1987 1987 '''test Mercurial installation
1988 1988
1989 1989 Returns 0 on success.
1990 1990 '''
1991 1991
1992 1992 def writetemp(contents):
1993 1993 (fd, name) = tempfile.mkstemp(prefix="hg-debuginstall-")
1994 1994 f = os.fdopen(fd, "wb")
1995 1995 f.write(contents)
1996 1996 f.close()
1997 1997 return name
1998 1998
1999 1999 problems = 0
2000 2000
2001 2001 # encoding
2002 2002 ui.status(_("checking encoding (%s)...\n") % encoding.encoding)
2003 2003 try:
2004 2004 encoding.fromlocal("test")
2005 2005 except util.Abort, inst:
2006 2006 ui.write(" %s\n" % inst)
2007 2007 ui.write(_(" (check that your locale is properly set)\n"))
2008 2008 problems += 1
2009 2009
2010 2010 # Python lib
2011 2011 ui.status(_("checking Python lib (%s)...\n")
2012 2012 % os.path.dirname(os.__file__))
2013 2013
2014 2014 # compiled modules
2015 2015 ui.status(_("checking installed modules (%s)...\n")
2016 2016 % os.path.dirname(__file__))
2017 2017 try:
2018 2018 import bdiff, mpatch, base85, osutil
2019 2019 dir(bdiff), dir(mpatch), dir(base85), dir(osutil) # quiet pyflakes
2020 2020 except Exception, inst:
2021 2021 ui.write(" %s\n" % inst)
2022 2022 ui.write(_(" One or more extensions could not be found"))
2023 2023 ui.write(_(" (check that you compiled the extensions)\n"))
2024 2024 problems += 1
2025 2025
2026 2026 # templates
2027 2027 import templater
2028 2028 p = templater.templatepath()
2029 2029 ui.status(_("checking templates (%s)...\n") % ' '.join(p))
2030 2030 try:
2031 2031 templater.templater(templater.templatepath("map-cmdline.default"))
2032 2032 except Exception, inst:
2033 2033 ui.write(" %s\n" % inst)
2034 2034 ui.write(_(" (templates seem to have been installed incorrectly)\n"))
2035 2035 problems += 1
2036 2036
2037 2037 # editor
2038 2038 ui.status(_("checking commit editor...\n"))
2039 2039 editor = ui.geteditor()
2040 2040 cmdpath = util.findexe(editor) or util.findexe(editor.split()[0])
2041 2041 if not cmdpath:
2042 2042 if editor == 'vi':
2043 2043 ui.write(_(" No commit editor set and can't find vi in PATH\n"))
2044 2044 ui.write(_(" (specify a commit editor in your configuration"
2045 2045 " file)\n"))
2046 2046 else:
2047 2047 ui.write(_(" Can't find editor '%s' in PATH\n") % editor)
2048 2048 ui.write(_(" (specify a commit editor in your configuration"
2049 2049 " file)\n"))
2050 2050 problems += 1
2051 2051
2052 2052 # check username
2053 2053 ui.status(_("checking username...\n"))
2054 2054 try:
2055 2055 ui.username()
2056 2056 except util.Abort, e:
2057 2057 ui.write(" %s\n" % e)
2058 2058 ui.write(_(" (specify a username in your configuration file)\n"))
2059 2059 problems += 1
2060 2060
2061 2061 if not problems:
2062 2062 ui.status(_("no problems detected\n"))
2063 2063 else:
2064 2064 ui.write(_("%s problems detected,"
2065 2065 " please check your install!\n") % problems)
2066 2066
2067 2067 return problems
2068 2068
2069 2069 @command('debugknown', [], _('REPO ID...'))
2070 2070 def debugknown(ui, repopath, *ids, **opts):
2071 2071 """test whether node ids are known to a repo
2072 2072
2073 2073 Every ID must be a full-length hex node id string. Returns a list of 0s
2074 2074 and 1s indicating unknown/known.
2075 2075 """
2076 2076 repo = hg.peer(ui, opts, repopath)
2077 2077 if not repo.capable('known'):
2078 2078 raise util.Abort("known() not supported by target repository")
2079 2079 flags = repo.known([bin(s) for s in ids])
2080 2080 ui.write("%s\n" % ("".join([f and "1" or "0" for f in flags])))
2081 2081
2082 2082 @command('debuglabelcomplete', [], _('LABEL...'))
2083 2083 def debuglabelcomplete(ui, repo, *args):
2084 2084 '''complete "labels" - tags, open branch names, bookmark names'''
2085 2085
2086 2086 labels = set()
2087 2087 labels.update(t[0] for t in repo.tagslist())
2088 2088 labels.update(repo._bookmarks.keys())
2089 2089 for heads in repo.branchmap().itervalues():
2090 2090 for h in heads:
2091 2091 ctx = repo[h]
2092 2092 if not ctx.closesbranch():
2093 2093 labels.add(ctx.branch())
2094 2094 completions = set()
2095 2095 if not args:
2096 2096 args = ['']
2097 2097 for a in args:
2098 2098 completions.update(l for l in labels if l.startswith(a))
2099 2099 ui.write('\n'.join(sorted(completions)))
2100 2100 ui.write('\n')
2101 2101
2102 2102 @command('debugobsolete',
2103 2103 [('', 'flags', 0, _('markers flag')),
2104 2104 ] + commitopts2,
2105 2105 _('[OBSOLETED [REPLACEMENT] [REPL... ]'))
2106 2106 def debugobsolete(ui, repo, precursor=None, *successors, **opts):
2107 2107 """create arbitrary obsolete marker
2108 2108
2109 2109 With no arguments, displays the list of obsolescence markers."""
2110 2110 def parsenodeid(s):
2111 2111 try:
2112 2112 # We do not use revsingle/revrange functions here to accept
2113 2113 # arbitrary node identifiers, possibly not present in the
2114 2114 # local repository.
2115 2115 n = bin(s)
2116 2116 if len(n) != len(nullid):
2117 2117 raise TypeError()
2118 2118 return n
2119 2119 except TypeError:
2120 2120 raise util.Abort('changeset references must be full hexadecimal '
2121 2121 'node identifiers')
2122 2122
2123 2123 if precursor is not None:
2124 2124 metadata = {}
2125 2125 if 'date' in opts:
2126 2126 metadata['date'] = opts['date']
2127 2127 metadata['user'] = opts['user'] or ui.username()
2128 2128 succs = tuple(parsenodeid(succ) for succ in successors)
2129 2129 l = repo.lock()
2130 2130 try:
2131 2131 tr = repo.transaction('debugobsolete')
2132 2132 try:
2133 2133 repo.obsstore.create(tr, parsenodeid(precursor), succs,
2134 2134 opts['flags'], metadata)
2135 2135 tr.close()
2136 2136 finally:
2137 2137 tr.release()
2138 2138 finally:
2139 2139 l.release()
2140 2140 else:
2141 2141 for m in obsolete.allmarkers(repo):
2142 2142 ui.write(hex(m.precnode()))
2143 2143 for repl in m.succnodes():
2144 2144 ui.write(' ')
2145 2145 ui.write(hex(repl))
2146 2146 ui.write(' %X ' % m._data[2])
2147 2147 ui.write('{%s}' % (', '.join('%r: %r' % t for t in
2148 2148 sorted(m.metadata().items()))))
2149 2149 ui.write('\n')
2150 2150
2151 2151 @command('debugpathcomplete',
2152 2152 [('f', 'full', None, _('complete an entire path')),
2153 2153 ('n', 'normal', None, _('show only normal files')),
2154 2154 ('a', 'added', None, _('show only added files')),
2155 2155 ('r', 'removed', None, _('show only removed files'))],
2156 2156 _('FILESPEC...'))
2157 2157 def debugpathcomplete(ui, repo, *specs, **opts):
2158 2158 '''complete part or all of a tracked path
2159 2159
2160 2160 This command supports shells that offer path name completion. It
2161 2161 currently completes only files already known to the dirstate.
2162 2162
2163 2163 Completion extends only to the next path segment unless
2164 2164 --full is specified, in which case entire paths are used.'''
2165 2165
2166 2166 def complete(path, acceptable):
2167 2167 dirstate = repo.dirstate
2168 2168 spec = os.path.normpath(os.path.join(os.getcwd(), path))
2169 2169 rootdir = repo.root + os.sep
2170 2170 if spec != repo.root and not spec.startswith(rootdir):
2171 2171 return [], []
2172 2172 if os.path.isdir(spec):
2173 2173 spec += '/'
2174 2174 spec = spec[len(rootdir):]
2175 2175 fixpaths = os.sep != '/'
2176 2176 if fixpaths:
2177 2177 spec = spec.replace(os.sep, '/')
2178 2178 speclen = len(spec)
2179 2179 fullpaths = opts['full']
2180 2180 files, dirs = set(), set()
2181 2181 adddir, addfile = dirs.add, files.add
2182 2182 for f, st in dirstate.iteritems():
2183 2183 if f.startswith(spec) and st[0] in acceptable:
2184 2184 if fixpaths:
2185 2185 f = f.replace('/', os.sep)
2186 2186 if fullpaths:
2187 2187 addfile(f)
2188 2188 continue
2189 2189 s = f.find(os.sep, speclen)
2190 2190 if s >= 0:
2191 2191 adddir(f[:s + 1])
2192 2192 else:
2193 2193 addfile(f)
2194 2194 return files, dirs
2195 2195
2196 2196 acceptable = ''
2197 2197 if opts['normal']:
2198 2198 acceptable += 'nm'
2199 2199 if opts['added']:
2200 2200 acceptable += 'a'
2201 2201 if opts['removed']:
2202 2202 acceptable += 'r'
2203 2203 cwd = repo.getcwd()
2204 2204 if not specs:
2205 2205 specs = ['.']
2206 2206
2207 2207 files, dirs = set(), set()
2208 2208 for spec in specs:
2209 2209 f, d = complete(spec, acceptable or 'nmar')
2210 2210 files.update(f)
2211 2211 dirs.update(d)
2212 2212 if not files and len(dirs) == 1:
2213 2213 # force the shell to consider a completion that matches one
2214 2214 # directory and zero files to be ambiguous
2215 2215 dirs.add(iter(dirs).next() + '.')
2216 2216 files.update(dirs)
2217 2217 ui.write('\n'.join(repo.pathto(p, cwd) for p in sorted(files)))
2218 2218 ui.write('\n')
2219 2219
2220 2220 @command('debugpushkey', [], _('REPO NAMESPACE [KEY OLD NEW]'))
2221 2221 def debugpushkey(ui, repopath, namespace, *keyinfo, **opts):
2222 2222 '''access the pushkey key/value protocol
2223 2223
2224 2224 With two args, list the keys in the given namespace.
2225 2225
2226 2226 With five args, set a key to new if it currently is set to old.
2227 2227 Reports success or failure.
2228 2228 '''
2229 2229
2230 2230 target = hg.peer(ui, {}, repopath)
2231 2231 if keyinfo:
2232 2232 key, old, new = keyinfo
2233 2233 r = target.pushkey(namespace, key, old, new)
2234 2234 ui.status(str(r) + '\n')
2235 2235 return not r
2236 2236 else:
2237 2237 for k, v in sorted(target.listkeys(namespace).iteritems()):
2238 2238 ui.write("%s\t%s\n" % (k.encode('string-escape'),
2239 2239 v.encode('string-escape')))
2240 2240
2241 2241 @command('debugpvec', [], _('A B'))
2242 2242 def debugpvec(ui, repo, a, b=None):
2243 2243 ca = scmutil.revsingle(repo, a)
2244 2244 cb = scmutil.revsingle(repo, b)
2245 2245 pa = pvec.ctxpvec(ca)
2246 2246 pb = pvec.ctxpvec(cb)
2247 2247 if pa == pb:
2248 2248 rel = "="
2249 2249 elif pa > pb:
2250 2250 rel = ">"
2251 2251 elif pa < pb:
2252 2252 rel = "<"
2253 2253 elif pa | pb:
2254 2254 rel = "|"
2255 2255 ui.write(_("a: %s\n") % pa)
2256 2256 ui.write(_("b: %s\n") % pb)
2257 2257 ui.write(_("depth(a): %d depth(b): %d\n") % (pa._depth, pb._depth))
2258 2258 ui.write(_("delta: %d hdist: %d distance: %d relation: %s\n") %
2259 2259 (abs(pa._depth - pb._depth), pvec._hamming(pa._vec, pb._vec),
2260 2260 pa.distance(pb), rel))
2261 2261
2262 2262 @command('debugrebuilddirstate|debugrebuildstate',
2263 2263 [('r', 'rev', '', _('revision to rebuild to'), _('REV'))],
2264 2264 _('[-r REV]'))
2265 2265 def debugrebuilddirstate(ui, repo, rev):
2266 2266 """rebuild the dirstate as it would look like for the given revision
2267 2267
2268 2268 If no revision is specified the first current parent will be used.
2269 2269
2270 2270 The dirstate will be set to the files of the given revision.
2271 2271 The actual working directory content or existing dirstate
2272 2272 information such as adds or removes is not considered.
2273 2273
2274 2274 One use of this command is to make the next :hg:`status` invocation
2275 2275 check the actual file content.
2276 2276 """
2277 2277 ctx = scmutil.revsingle(repo, rev)
2278 2278 wlock = repo.wlock()
2279 2279 try:
2280 2280 repo.dirstate.rebuild(ctx.node(), ctx.manifest())
2281 2281 finally:
2282 2282 wlock.release()
2283 2283
2284 2284 @command('debugrename',
2285 2285 [('r', 'rev', '', _('revision to debug'), _('REV'))],
2286 2286 _('[-r REV] FILE'))
2287 2287 def debugrename(ui, repo, file1, *pats, **opts):
2288 2288 """dump rename information"""
2289 2289
2290 2290 ctx = scmutil.revsingle(repo, opts.get('rev'))
2291 2291 m = scmutil.match(ctx, (file1,) + pats, opts)
2292 2292 for abs in ctx.walk(m):
2293 2293 fctx = ctx[abs]
2294 2294 o = fctx.filelog().renamed(fctx.filenode())
2295 2295 rel = m.rel(abs)
2296 2296 if o:
2297 2297 ui.write(_("%s renamed from %s:%s\n") % (rel, o[0], hex(o[1])))
2298 2298 else:
2299 2299 ui.write(_("%s not renamed\n") % rel)
2300 2300
2301 2301 @command('debugrevlog',
2302 2302 [('c', 'changelog', False, _('open changelog')),
2303 2303 ('m', 'manifest', False, _('open manifest')),
2304 2304 ('d', 'dump', False, _('dump index data'))],
2305 2305 _('-c|-m|FILE'))
2306 2306 def debugrevlog(ui, repo, file_ = None, **opts):
2307 2307 """show data and statistics about a revlog"""
2308 2308 r = cmdutil.openrevlog(repo, 'debugrevlog', file_, opts)
2309 2309
2310 2310 if opts.get("dump"):
2311 2311 numrevs = len(r)
2312 2312 ui.write("# rev p1rev p2rev start end deltastart base p1 p2"
2313 2313 " rawsize totalsize compression heads\n")
2314 2314 ts = 0
2315 2315 heads = set()
2316 2316 for rev in xrange(numrevs):
2317 2317 dbase = r.deltaparent(rev)
2318 2318 if dbase == -1:
2319 2319 dbase = rev
2320 2320 cbase = r.chainbase(rev)
2321 2321 p1, p2 = r.parentrevs(rev)
2322 2322 rs = r.rawsize(rev)
2323 2323 ts = ts + rs
2324 2324 heads -= set(r.parentrevs(rev))
2325 2325 heads.add(rev)
2326 2326 ui.write("%d %d %d %d %d %d %d %d %d %d %d %d %d\n" %
2327 2327 (rev, p1, p2, r.start(rev), r.end(rev),
2328 2328 r.start(dbase), r.start(cbase),
2329 2329 r.start(p1), r.start(p2),
2330 2330 rs, ts, ts / r.end(rev), len(heads)))
2331 2331 return 0
2332 2332
2333 2333 v = r.version
2334 2334 format = v & 0xFFFF
2335 2335 flags = []
2336 2336 gdelta = False
2337 2337 if v & revlog.REVLOGNGINLINEDATA:
2338 2338 flags.append('inline')
2339 2339 if v & revlog.REVLOGGENERALDELTA:
2340 2340 gdelta = True
2341 2341 flags.append('generaldelta')
2342 2342 if not flags:
2343 2343 flags = ['(none)']
2344 2344
2345 2345 nummerges = 0
2346 2346 numfull = 0
2347 2347 numprev = 0
2348 2348 nump1 = 0
2349 2349 nump2 = 0
2350 2350 numother = 0
2351 2351 nump1prev = 0
2352 2352 nump2prev = 0
2353 2353 chainlengths = []
2354 2354
2355 2355 datasize = [None, 0, 0L]
2356 2356 fullsize = [None, 0, 0L]
2357 2357 deltasize = [None, 0, 0L]
2358 2358
2359 2359 def addsize(size, l):
2360 2360 if l[0] is None or size < l[0]:
2361 2361 l[0] = size
2362 2362 if size > l[1]:
2363 2363 l[1] = size
2364 2364 l[2] += size
2365 2365
2366 2366 numrevs = len(r)
2367 2367 for rev in xrange(numrevs):
2368 2368 p1, p2 = r.parentrevs(rev)
2369 2369 delta = r.deltaparent(rev)
2370 2370 if format > 0:
2371 2371 addsize(r.rawsize(rev), datasize)
2372 2372 if p2 != nullrev:
2373 2373 nummerges += 1
2374 2374 size = r.length(rev)
2375 2375 if delta == nullrev:
2376 2376 chainlengths.append(0)
2377 2377 numfull += 1
2378 2378 addsize(size, fullsize)
2379 2379 else:
2380 2380 chainlengths.append(chainlengths[delta] + 1)
2381 2381 addsize(size, deltasize)
2382 2382 if delta == rev - 1:
2383 2383 numprev += 1
2384 2384 if delta == p1:
2385 2385 nump1prev += 1
2386 2386 elif delta == p2:
2387 2387 nump2prev += 1
2388 2388 elif delta == p1:
2389 2389 nump1 += 1
2390 2390 elif delta == p2:
2391 2391 nump2 += 1
2392 2392 elif delta != nullrev:
2393 2393 numother += 1
2394 2394
2395 2395 # Adjust size min value for empty cases
2396 2396 for size in (datasize, fullsize, deltasize):
2397 2397 if size[0] is None:
2398 2398 size[0] = 0
2399 2399
2400 2400 numdeltas = numrevs - numfull
2401 2401 numoprev = numprev - nump1prev - nump2prev
2402 2402 totalrawsize = datasize[2]
2403 2403 datasize[2] /= numrevs
2404 2404 fulltotal = fullsize[2]
2405 2405 fullsize[2] /= numfull
2406 2406 deltatotal = deltasize[2]
2407 2407 if numrevs - numfull > 0:
2408 2408 deltasize[2] /= numrevs - numfull
2409 2409 totalsize = fulltotal + deltatotal
2410 2410 avgchainlen = sum(chainlengths) / numrevs
2411 2411 compratio = totalrawsize / totalsize
2412 2412
2413 2413 basedfmtstr = '%%%dd\n'
2414 2414 basepcfmtstr = '%%%dd %s(%%5.2f%%%%)\n'
2415 2415
2416 2416 def dfmtstr(max):
2417 2417 return basedfmtstr % len(str(max))
2418 2418 def pcfmtstr(max, padding=0):
2419 2419 return basepcfmtstr % (len(str(max)), ' ' * padding)
2420 2420
2421 2421 def pcfmt(value, total):
2422 2422 return (value, 100 * float(value) / total)
2423 2423
2424 2424 ui.write(('format : %d\n') % format)
2425 2425 ui.write(('flags : %s\n') % ', '.join(flags))
2426 2426
2427 2427 ui.write('\n')
2428 2428 fmt = pcfmtstr(totalsize)
2429 2429 fmt2 = dfmtstr(totalsize)
2430 2430 ui.write(('revisions : ') + fmt2 % numrevs)
2431 2431 ui.write((' merges : ') + fmt % pcfmt(nummerges, numrevs))
2432 2432 ui.write((' normal : ') + fmt % pcfmt(numrevs - nummerges, numrevs))
2433 2433 ui.write(('revisions : ') + fmt2 % numrevs)
2434 2434 ui.write((' full : ') + fmt % pcfmt(numfull, numrevs))
2435 2435 ui.write((' deltas : ') + fmt % pcfmt(numdeltas, numrevs))
2436 2436 ui.write(('revision size : ') + fmt2 % totalsize)
2437 2437 ui.write((' full : ') + fmt % pcfmt(fulltotal, totalsize))
2438 2438 ui.write((' deltas : ') + fmt % pcfmt(deltatotal, totalsize))
2439 2439
2440 2440 ui.write('\n')
2441 2441 fmt = dfmtstr(max(avgchainlen, compratio))
2442 2442 ui.write(('avg chain length : ') + fmt % avgchainlen)
2443 2443 ui.write(('compression ratio : ') + fmt % compratio)
2444 2444
2445 2445 if format > 0:
2446 2446 ui.write('\n')
2447 2447 ui.write(('uncompressed data size (min/max/avg) : %d / %d / %d\n')
2448 2448 % tuple(datasize))
2449 2449 ui.write(('full revision size (min/max/avg) : %d / %d / %d\n')
2450 2450 % tuple(fullsize))
2451 2451 ui.write(('delta size (min/max/avg) : %d / %d / %d\n')
2452 2452 % tuple(deltasize))
2453 2453
2454 2454 if numdeltas > 0:
2455 2455 ui.write('\n')
2456 2456 fmt = pcfmtstr(numdeltas)
2457 2457 fmt2 = pcfmtstr(numdeltas, 4)
2458 2458 ui.write(('deltas against prev : ') + fmt % pcfmt(numprev, numdeltas))
2459 2459 if numprev > 0:
2460 2460 ui.write((' where prev = p1 : ') + fmt2 % pcfmt(nump1prev,
2461 2461 numprev))
2462 2462 ui.write((' where prev = p2 : ') + fmt2 % pcfmt(nump2prev,
2463 2463 numprev))
2464 2464 ui.write((' other : ') + fmt2 % pcfmt(numoprev,
2465 2465 numprev))
2466 2466 if gdelta:
2467 2467 ui.write(('deltas against p1 : ')
2468 2468 + fmt % pcfmt(nump1, numdeltas))
2469 2469 ui.write(('deltas against p2 : ')
2470 2470 + fmt % pcfmt(nump2, numdeltas))
2471 2471 ui.write(('deltas against other : ') + fmt % pcfmt(numother,
2472 2472 numdeltas))
2473 2473
2474 2474 @command('debugrevspec', [], ('REVSPEC'))
2475 2475 def debugrevspec(ui, repo, expr):
2476 2476 """parse and apply a revision specification
2477 2477
2478 2478 Use --verbose to print the parsed tree before and after aliases
2479 2479 expansion.
2480 2480 """
2481 2481 if ui.verbose:
2482 2482 tree = revset.parse(expr)[0]
2483 2483 ui.note(revset.prettyformat(tree), "\n")
2484 2484 newtree = revset.findaliases(ui, tree)
2485 2485 if newtree != tree:
2486 2486 ui.note(revset.prettyformat(newtree), "\n")
2487 2487 func = revset.match(ui, expr)
2488 2488 for c in func(repo, range(len(repo))):
2489 2489 ui.write("%s\n" % c)
2490 2490
2491 2491 @command('debugsetparents', [], _('REV1 [REV2]'))
2492 2492 def debugsetparents(ui, repo, rev1, rev2=None):
2493 2493 """manually set the parents of the current working directory
2494 2494
2495 2495 This is useful for writing repository conversion tools, but should
2496 2496 be used with care.
2497 2497
2498 2498 Returns 0 on success.
2499 2499 """
2500 2500
2501 2501 r1 = scmutil.revsingle(repo, rev1).node()
2502 2502 r2 = scmutil.revsingle(repo, rev2, 'null').node()
2503 2503
2504 2504 wlock = repo.wlock()
2505 2505 try:
2506 2506 repo.setparents(r1, r2)
2507 2507 finally:
2508 2508 wlock.release()
2509 2509
2510 2510 @command('debugdirstate|debugstate',
2511 2511 [('', 'nodates', None, _('do not display the saved mtime')),
2512 2512 ('', 'datesort', None, _('sort by saved mtime'))],
2513 2513 _('[OPTION]...'))
2514 2514 def debugstate(ui, repo, nodates=None, datesort=None):
2515 2515 """show the contents of the current dirstate"""
2516 2516 timestr = ""
2517 2517 showdate = not nodates
2518 2518 if datesort:
2519 2519 keyfunc = lambda x: (x[1][3], x[0]) # sort by mtime, then by filename
2520 2520 else:
2521 2521 keyfunc = None # sort by filename
2522 2522 for file_, ent in sorted(repo.dirstate._map.iteritems(), key=keyfunc):
2523 2523 if showdate:
2524 2524 if ent[3] == -1:
2525 2525 # Pad or slice to locale representation
2526 2526 locale_len = len(time.strftime("%Y-%m-%d %H:%M:%S ",
2527 2527 time.localtime(0)))
2528 2528 timestr = 'unset'
2529 2529 timestr = (timestr[:locale_len] +
2530 2530 ' ' * (locale_len - len(timestr)))
2531 2531 else:
2532 2532 timestr = time.strftime("%Y-%m-%d %H:%M:%S ",
2533 2533 time.localtime(ent[3]))
2534 2534 if ent[1] & 020000:
2535 2535 mode = 'lnk'
2536 2536 else:
2537 2537 mode = '%3o' % (ent[1] & 0777 & ~util.umask)
2538 2538 ui.write("%c %s %10d %s%s\n" % (ent[0], mode, ent[2], timestr, file_))
2539 2539 for f in repo.dirstate.copies():
2540 2540 ui.write(_("copy: %s -> %s\n") % (repo.dirstate.copied(f), f))
2541 2541
2542 2542 @command('debugsub',
2543 2543 [('r', 'rev', '',
2544 2544 _('revision to check'), _('REV'))],
2545 2545 _('[-r REV] [REV]'))
2546 2546 def debugsub(ui, repo, rev=None):
2547 2547 ctx = scmutil.revsingle(repo, rev, None)
2548 2548 for k, v in sorted(ctx.substate.items()):
2549 2549 ui.write(('path %s\n') % k)
2550 2550 ui.write((' source %s\n') % v[0])
2551 2551 ui.write((' revision %s\n') % v[1])
2552 2552
2553 2553 @command('debugsuccessorssets',
2554 2554 [],
2555 2555 _('[REV]'))
2556 2556 def debugsuccessorssets(ui, repo, *revs):
2557 2557 """show set of successors for revision
2558 2558
2559 2559 A successors set of changeset A is a consistent group of revisions that
2560 2560 succeed A. It contains non-obsolete changesets only.
2561 2561
2562 2562 In most cases a changeset A has a single successors set containing a single
2563 2563 successor (changeset A replaced by A').
2564 2564
2565 2565 A changeset that is made obsolete with no successors are called "pruned".
2566 2566 Such changesets have no successors sets at all.
2567 2567
2568 2568 A changeset that has been "split" will have a successors set containing
2569 2569 more than one successor.
2570 2570
2571 2571 A changeset that has been rewritten in multiple different ways is called
2572 2572 "divergent". Such changesets have multiple successor sets (each of which
2573 2573 may also be split, i.e. have multiple successors).
2574 2574
2575 2575 Results are displayed as follows::
2576 2576
2577 2577 <rev1>
2578 2578 <successors-1A>
2579 2579 <rev2>
2580 2580 <successors-2A>
2581 2581 <successors-2B1> <successors-2B2> <successors-2B3>
2582 2582
2583 2583 Here rev2 has two possible (i.e. divergent) successors sets. The first
2584 2584 holds one element, whereas the second holds three (i.e. the changeset has
2585 2585 been split).
2586 2586 """
2587 2587 # passed to successorssets caching computation from one call to another
2588 2588 cache = {}
2589 2589 ctx2str = str
2590 2590 node2str = short
2591 2591 if ui.debug():
2592 2592 def ctx2str(ctx):
2593 2593 return ctx.hex()
2594 2594 node2str = hex
2595 2595 for rev in scmutil.revrange(repo, revs):
2596 2596 ctx = repo[rev]
2597 2597 ui.write('%s\n'% ctx2str(ctx))
2598 2598 for succsset in obsolete.successorssets(repo, ctx.node(), cache):
2599 2599 if succsset:
2600 2600 ui.write(' ')
2601 2601 ui.write(node2str(succsset[0]))
2602 2602 for node in succsset[1:]:
2603 2603 ui.write(' ')
2604 2604 ui.write(node2str(node))
2605 2605 ui.write('\n')
2606 2606
2607 2607 @command('debugwalk', walkopts, _('[OPTION]... [FILE]...'))
2608 2608 def debugwalk(ui, repo, *pats, **opts):
2609 2609 """show how files match on given patterns"""
2610 2610 m = scmutil.match(repo[None], pats, opts)
2611 2611 items = list(repo.walk(m))
2612 2612 if not items:
2613 2613 return
2614 2614 f = lambda fn: fn
2615 2615 if ui.configbool('ui', 'slash') and os.sep != '/':
2616 2616 f = lambda fn: util.normpath(fn)
2617 2617 fmt = 'f %%-%ds %%-%ds %%s' % (
2618 2618 max([len(abs) for abs in items]),
2619 2619 max([len(m.rel(abs)) for abs in items]))
2620 2620 for abs in items:
2621 2621 line = fmt % (abs, f(m.rel(abs)), m.exact(abs) and 'exact' or '')
2622 2622 ui.write("%s\n" % line.rstrip())
2623 2623
2624 2624 @command('debugwireargs',
2625 2625 [('', 'three', '', 'three'),
2626 2626 ('', 'four', '', 'four'),
2627 2627 ('', 'five', '', 'five'),
2628 2628 ] + remoteopts,
2629 2629 _('REPO [OPTIONS]... [ONE [TWO]]'))
2630 2630 def debugwireargs(ui, repopath, *vals, **opts):
2631 2631 repo = hg.peer(ui, opts, repopath)
2632 2632 for opt in remoteopts:
2633 2633 del opts[opt[1]]
2634 2634 args = {}
2635 2635 for k, v in opts.iteritems():
2636 2636 if v:
2637 2637 args[k] = v
2638 2638 # run twice to check that we don't mess up the stream for the next command
2639 2639 res1 = repo.debugwireargs(*vals, **args)
2640 2640 res2 = repo.debugwireargs(*vals, **args)
2641 2641 ui.write("%s\n" % res1)
2642 2642 if res1 != res2:
2643 2643 ui.warn("%s\n" % res2)
2644 2644
2645 2645 @command('^diff',
2646 2646 [('r', 'rev', [], _('revision'), _('REV')),
2647 2647 ('c', 'change', '', _('change made by revision'), _('REV'))
2648 2648 ] + diffopts + diffopts2 + walkopts + subrepoopts,
2649 2649 _('[OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...'))
2650 2650 def diff(ui, repo, *pats, **opts):
2651 2651 """diff repository (or selected files)
2652 2652
2653 2653 Show differences between revisions for the specified files.
2654 2654
2655 2655 Differences between files are shown using the unified diff format.
2656 2656
2657 2657 .. note::
2658 2658 diff may generate unexpected results for merges, as it will
2659 2659 default to comparing against the working directory's first
2660 2660 parent changeset if no revisions are specified.
2661 2661
2662 2662 When two revision arguments are given, then changes are shown
2663 2663 between those revisions. If only one revision is specified then
2664 2664 that revision is compared to the working directory, and, when no
2665 2665 revisions are specified, the working directory files are compared
2666 2666 to its parent.
2667 2667
2668 2668 Alternatively you can specify -c/--change with a revision to see
2669 2669 the changes in that changeset relative to its first parent.
2670 2670
2671 2671 Without the -a/--text option, diff will avoid generating diffs of
2672 2672 files it detects as binary. With -a, diff will generate a diff
2673 2673 anyway, probably with undesirable results.
2674 2674
2675 2675 Use the -g/--git option to generate diffs in the git extended diff
2676 2676 format. For more information, read :hg:`help diffs`.
2677 2677
2678 2678 .. container:: verbose
2679 2679
2680 2680 Examples:
2681 2681
2682 2682 - compare a file in the current working directory to its parent::
2683 2683
2684 2684 hg diff foo.c
2685 2685
2686 2686 - compare two historical versions of a directory, with rename info::
2687 2687
2688 2688 hg diff --git -r 1.0:1.2 lib/
2689 2689
2690 2690 - get change stats relative to the last change on some date::
2691 2691
2692 2692 hg diff --stat -r "date('may 2')"
2693 2693
2694 2694 - diff all newly-added files that contain a keyword::
2695 2695
2696 2696 hg diff "set:added() and grep(GNU)"
2697 2697
2698 2698 - compare a revision and its parents::
2699 2699
2700 2700 hg diff -c 9353 # compare against first parent
2701 2701 hg diff -r 9353^:9353 # same using revset syntax
2702 2702 hg diff -r 9353^2:9353 # compare against the second parent
2703 2703
2704 2704 Returns 0 on success.
2705 2705 """
2706 2706
2707 2707 revs = opts.get('rev')
2708 2708 change = opts.get('change')
2709 2709 stat = opts.get('stat')
2710 2710 reverse = opts.get('reverse')
2711 2711
2712 2712 if revs and change:
2713 2713 msg = _('cannot specify --rev and --change at the same time')
2714 2714 raise util.Abort(msg)
2715 2715 elif change:
2716 2716 node2 = scmutil.revsingle(repo, change, None).node()
2717 2717 node1 = repo[node2].p1().node()
2718 2718 else:
2719 2719 node1, node2 = scmutil.revpair(repo, revs)
2720 2720
2721 2721 if reverse:
2722 2722 node1, node2 = node2, node1
2723 2723
2724 2724 diffopts = patch.diffopts(ui, opts)
2725 2725 m = scmutil.match(repo[node2], pats, opts)
2726 2726 cmdutil.diffordiffstat(ui, repo, diffopts, node1, node2, m, stat=stat,
2727 2727 listsubrepos=opts.get('subrepos'))
2728 2728
2729 2729 @command('^export',
2730 2730 [('o', 'output', '',
2731 2731 _('print output to file with formatted name'), _('FORMAT')),
2732 2732 ('', 'switch-parent', None, _('diff against the second parent')),
2733 2733 ('r', 'rev', [], _('revisions to export'), _('REV')),
2734 2734 ] + diffopts,
2735 2735 _('[OPTION]... [-o OUTFILESPEC] [-r] [REV]...'))
2736 2736 def export(ui, repo, *changesets, **opts):
2737 2737 """dump the header and diffs for one or more changesets
2738 2738
2739 2739 Print the changeset header and diffs for one or more revisions.
2740 2740 If no revision is given, the parent of the working directory is used.
2741 2741
2742 2742 The information shown in the changeset header is: author, date,
2743 2743 branch name (if non-default), changeset hash, parent(s) and commit
2744 2744 comment.
2745 2745
2746 2746 .. note::
2747 2747 export may generate unexpected diff output for merge
2748 2748 changesets, as it will compare the merge changeset against its
2749 2749 first parent only.
2750 2750
2751 2751 Output may be to a file, in which case the name of the file is
2752 2752 given using a format string. The formatting rules are as follows:
2753 2753
2754 2754 :``%%``: literal "%" character
2755 2755 :``%H``: changeset hash (40 hexadecimal digits)
2756 2756 :``%N``: number of patches being generated
2757 2757 :``%R``: changeset revision number
2758 2758 :``%b``: basename of the exporting repository
2759 2759 :``%h``: short-form changeset hash (12 hexadecimal digits)
2760 2760 :``%m``: first line of the commit message (only alphanumeric characters)
2761 2761 :``%n``: zero-padded sequence number, starting at 1
2762 2762 :``%r``: zero-padded changeset revision number
2763 2763
2764 2764 Without the -a/--text option, export will avoid generating diffs
2765 2765 of files it detects as binary. With -a, export will generate a
2766 2766 diff anyway, probably with undesirable results.
2767 2767
2768 2768 Use the -g/--git option to generate diffs in the git extended diff
2769 2769 format. See :hg:`help diffs` for more information.
2770 2770
2771 2771 With the --switch-parent option, the diff will be against the
2772 2772 second parent. It can be useful to review a merge.
2773 2773
2774 2774 .. container:: verbose
2775 2775
2776 2776 Examples:
2777 2777
2778 2778 - use export and import to transplant a bugfix to the current
2779 2779 branch::
2780 2780
2781 2781 hg export -r 9353 | hg import -
2782 2782
2783 2783 - export all the changesets between two revisions to a file with
2784 2784 rename information::
2785 2785
2786 2786 hg export --git -r 123:150 > changes.txt
2787 2787
2788 2788 - split outgoing changes into a series of patches with
2789 2789 descriptive names::
2790 2790
2791 2791 hg export -r "outgoing()" -o "%n-%m.patch"
2792 2792
2793 2793 Returns 0 on success.
2794 2794 """
2795 2795 changesets += tuple(opts.get('rev', []))
2796 2796 if not changesets:
2797 2797 changesets = ['.']
2798 2798 revs = scmutil.revrange(repo, changesets)
2799 2799 if not revs:
2800 2800 raise util.Abort(_("export requires at least one changeset"))
2801 2801 if len(revs) > 1:
2802 2802 ui.note(_('exporting patches:\n'))
2803 2803 else:
2804 2804 ui.note(_('exporting patch:\n'))
2805 2805 cmdutil.export(repo, revs, template=opts.get('output'),
2806 2806 switch_parent=opts.get('switch_parent'),
2807 2807 opts=patch.diffopts(ui, opts))
2808 2808
2809 2809 @command('^forget', walkopts, _('[OPTION]... FILE...'))
2810 2810 def forget(ui, repo, *pats, **opts):
2811 2811 """forget the specified files on the next commit
2812 2812
2813 2813 Mark the specified files so they will no longer be tracked
2814 2814 after the next commit.
2815 2815
2816 2816 This only removes files from the current branch, not from the
2817 2817 entire project history, and it does not delete them from the
2818 2818 working directory.
2819 2819
2820 2820 To undo a forget before the next commit, see :hg:`add`.
2821 2821
2822 2822 .. container:: verbose
2823 2823
2824 2824 Examples:
2825 2825
2826 2826 - forget newly-added binary files::
2827 2827
2828 2828 hg forget "set:added() and binary()"
2829 2829
2830 2830 - forget files that would be excluded by .hgignore::
2831 2831
2832 2832 hg forget "set:hgignore()"
2833 2833
2834 2834 Returns 0 on success.
2835 2835 """
2836 2836
2837 2837 if not pats:
2838 2838 raise util.Abort(_('no files specified'))
2839 2839
2840 2840 m = scmutil.match(repo[None], pats, opts)
2841 2841 rejected = cmdutil.forget(ui, repo, m, prefix="", explicitonly=False)[0]
2842 2842 return rejected and 1 or 0
2843 2843
2844 2844 @command(
2845 2845 'graft',
2846 2846 [('r', 'rev', [], _('revisions to graft'), _('REV')),
2847 2847 ('c', 'continue', False, _('resume interrupted graft')),
2848 2848 ('e', 'edit', False, _('invoke editor on commit messages')),
2849 2849 ('', 'log', None, _('append graft info to log message')),
2850 2850 ('D', 'currentdate', False,
2851 2851 _('record the current date as commit date')),
2852 2852 ('U', 'currentuser', False,
2853 2853 _('record the current user as committer'), _('DATE'))]
2854 2854 + commitopts2 + mergetoolopts + dryrunopts,
2855 2855 _('[OPTION]... [-r] REV...'))
2856 2856 def graft(ui, repo, *revs, **opts):
2857 2857 '''copy changes from other branches onto the current branch
2858 2858
2859 2859 This command uses Mercurial's merge logic to copy individual
2860 2860 changes from other branches without merging branches in the
2861 2861 history graph. This is sometimes known as 'backporting' or
2862 2862 'cherry-picking'. By default, graft will copy user, date, and
2863 2863 description from the source changesets.
2864 2864
2865 2865 Changesets that are ancestors of the current revision, that have
2866 2866 already been grafted, or that are merges will be skipped.
2867 2867
2868 2868 If --log is specified, log messages will have a comment appended
2869 2869 of the form::
2870 2870
2871 2871 (grafted from CHANGESETHASH)
2872 2872
2873 2873 If a graft merge results in conflicts, the graft process is
2874 2874 interrupted so that the current merge can be manually resolved.
2875 2875 Once all conflicts are addressed, the graft process can be
2876 2876 continued with the -c/--continue option.
2877 2877
2878 2878 .. note::
2879 2879 The -c/--continue option does not reapply earlier options.
2880 2880
2881 2881 .. container:: verbose
2882 2882
2883 2883 Examples:
2884 2884
2885 2885 - copy a single change to the stable branch and edit its description::
2886 2886
2887 2887 hg update stable
2888 2888 hg graft --edit 9393
2889 2889
2890 2890 - graft a range of changesets with one exception, updating dates::
2891 2891
2892 2892 hg graft -D "2085::2093 and not 2091"
2893 2893
2894 2894 - continue a graft after resolving conflicts::
2895 2895
2896 2896 hg graft -c
2897 2897
2898 2898 - show the source of a grafted changeset::
2899 2899
2900 2900 hg log --debug -r tip
2901 2901
2902 2902 Returns 0 on successful completion.
2903 2903 '''
2904 2904
2905 2905 revs = list(revs)
2906 2906 revs.extend(opts['rev'])
2907 2907
2908 2908 if not opts.get('user') and opts.get('currentuser'):
2909 2909 opts['user'] = ui.username()
2910 2910 if not opts.get('date') and opts.get('currentdate'):
2911 2911 opts['date'] = "%d %d" % util.makedate()
2912 2912
2913 2913 editor = None
2914 2914 if opts.get('edit'):
2915 2915 editor = cmdutil.commitforceeditor
2916 2916
2917 2917 cont = False
2918 2918 if opts['continue']:
2919 2919 cont = True
2920 2920 if revs:
2921 2921 raise util.Abort(_("can't specify --continue and revisions"))
2922 2922 # read in unfinished revisions
2923 2923 try:
2924 2924 nodes = repo.opener.read('graftstate').splitlines()
2925 2925 revs = [repo[node].rev() for node in nodes]
2926 2926 except IOError, inst:
2927 2927 if inst.errno != errno.ENOENT:
2928 2928 raise
2929 2929 raise util.Abort(_("no graft state found, can't continue"))
2930 2930 else:
2931 2931 cmdutil.bailifchanged(repo)
2932 2932 if not revs:
2933 2933 raise util.Abort(_('no revisions specified'))
2934 2934 revs = scmutil.revrange(repo, revs)
2935 2935
2936 2936 # check for merges
2937 2937 for rev in repo.revs('%ld and merge()', revs):
2938 2938 ui.warn(_('skipping ungraftable merge revision %s\n') % rev)
2939 2939 revs.remove(rev)
2940 2940 if not revs:
2941 2941 return -1
2942 2942
2943 2943 # check for ancestors of dest branch
2944 2944 crev = repo['.'].rev()
2945 2945 ancestors = repo.changelog.ancestors([crev], inclusive=True)
2946 2946 # don't mutate while iterating, create a copy
2947 2947 for rev in list(revs):
2948 2948 if rev in ancestors:
2949 2949 ui.warn(_('skipping ancestor revision %s\n') % rev)
2950 2950 revs.remove(rev)
2951 2951 if not revs:
2952 2952 return -1
2953 2953
2954 2954 # analyze revs for earlier grafts
2955 2955 ids = {}
2956 2956 for ctx in repo.set("%ld", revs):
2957 2957 ids[ctx.hex()] = ctx.rev()
2958 2958 n = ctx.extra().get('source')
2959 2959 if n:
2960 2960 ids[n] = ctx.rev()
2961 2961
2962 2962 # check ancestors for earlier grafts
2963 2963 ui.debug('scanning for duplicate grafts\n')
2964 2964
2965 2965 for rev in repo.changelog.findmissingrevs(revs, [crev]):
2966 2966 ctx = repo[rev]
2967 2967 n = ctx.extra().get('source')
2968 2968 if n in ids:
2969 2969 r = repo[n].rev()
2970 2970 if r in revs:
2971 2971 ui.warn(_('skipping already grafted revision %s\n') % r)
2972 2972 revs.remove(r)
2973 2973 elif ids[n] in revs:
2974 2974 ui.warn(_('skipping already grafted revision %s '
2975 2975 '(same origin %d)\n') % (ids[n], r))
2976 2976 revs.remove(ids[n])
2977 2977 elif ctx.hex() in ids:
2978 2978 r = ids[ctx.hex()]
2979 2979 ui.warn(_('skipping already grafted revision %s '
2980 2980 '(was grafted from %d)\n') % (r, rev))
2981 2981 revs.remove(r)
2982 2982 if not revs:
2983 2983 return -1
2984 2984
2985 2985 wlock = repo.wlock()
2986 2986 try:
2987 2987 current = repo['.']
2988 2988 for pos, ctx in enumerate(repo.set("%ld", revs)):
2989 2989
2990 2990 ui.status(_('grafting revision %s\n') % ctx.rev())
2991 2991 if opts.get('dry_run'):
2992 2992 continue
2993 2993
2994 2994 source = ctx.extra().get('source')
2995 2995 if not source:
2996 2996 source = ctx.hex()
2997 2997 extra = {'source': source}
2998 2998 user = ctx.user()
2999 2999 if opts.get('user'):
3000 3000 user = opts['user']
3001 3001 date = ctx.date()
3002 3002 if opts.get('date'):
3003 3003 date = opts['date']
3004 3004 message = ctx.description()
3005 3005 if opts.get('log'):
3006 3006 message += '\n(grafted from %s)' % ctx.hex()
3007 3007
3008 3008 # we don't merge the first commit when continuing
3009 3009 if not cont:
3010 3010 # perform the graft merge with p1(rev) as 'ancestor'
3011 3011 try:
3012 3012 # ui.forcemerge is an internal variable, do not document
3013 3013 repo.ui.setconfig('ui', 'forcemerge', opts.get('tool', ''))
3014 3014 stats = mergemod.update(repo, ctx.node(), True, True, False,
3015 3015 ctx.p1().node())
3016 3016 finally:
3017 3017 repo.ui.setconfig('ui', 'forcemerge', '')
3018 3018 # report any conflicts
3019 3019 if stats and stats[3] > 0:
3020 3020 # write out state for --continue
3021 3021 nodelines = [repo[rev].hex() + "\n" for rev in revs[pos:]]
3022 3022 repo.opener.write('graftstate', ''.join(nodelines))
3023 3023 raise util.Abort(
3024 3024 _("unresolved conflicts, can't continue"),
3025 3025 hint=_('use hg resolve and hg graft --continue'))
3026 3026 else:
3027 3027 cont = False
3028 3028
3029 3029 # drop the second merge parent
3030 3030 repo.setparents(current.node(), nullid)
3031 3031 repo.dirstate.write()
3032 3032 # fix up dirstate for copies and renames
3033 3033 cmdutil.duplicatecopies(repo, ctx.rev(), ctx.p1().rev())
3034 3034
3035 3035 # commit
3036 3036 node = repo.commit(text=message, user=user,
3037 3037 date=date, extra=extra, editor=editor)
3038 3038 if node is None:
3039 3039 ui.status(_('graft for revision %s is empty\n') % ctx.rev())
3040 3040 else:
3041 3041 current = repo[node]
3042 3042 finally:
3043 3043 wlock.release()
3044 3044
3045 3045 # remove state when we complete successfully
3046 3046 if not opts.get('dry_run'):
3047 3047 util.unlinkpath(repo.join('graftstate'), ignoremissing=True)
3048 3048
3049 3049 return 0
3050 3050
3051 3051 @command('grep',
3052 3052 [('0', 'print0', None, _('end fields with NUL')),
3053 3053 ('', 'all', None, _('print all revisions that match')),
3054 3054 ('a', 'text', None, _('treat all files as text')),
3055 3055 ('f', 'follow', None,
3056 3056 _('follow changeset history,'
3057 3057 ' or file history across copies and renames')),
3058 3058 ('i', 'ignore-case', None, _('ignore case when matching')),
3059 3059 ('l', 'files-with-matches', None,
3060 3060 _('print only filenames and revisions that match')),
3061 3061 ('n', 'line-number', None, _('print matching line numbers')),
3062 3062 ('r', 'rev', [],
3063 3063 _('only search files changed within revision range'), _('REV')),
3064 3064 ('u', 'user', None, _('list the author (long with -v)')),
3065 3065 ('d', 'date', None, _('list the date (short with -q)')),
3066 3066 ] + walkopts,
3067 3067 _('[OPTION]... PATTERN [FILE]...'))
3068 3068 def grep(ui, repo, pattern, *pats, **opts):
3069 3069 """search for a pattern in specified files and revisions
3070 3070
3071 3071 Search revisions of files for a regular expression.
3072 3072
3073 3073 This command behaves differently than Unix grep. It only accepts
3074 3074 Python/Perl regexps. It searches repository history, not the
3075 3075 working directory. It always prints the revision number in which a
3076 3076 match appears.
3077 3077
3078 3078 By default, grep only prints output for the first revision of a
3079 3079 file in which it finds a match. To get it to print every revision
3080 3080 that contains a change in match status ("-" for a match that
3081 3081 becomes a non-match, or "+" for a non-match that becomes a match),
3082 3082 use the --all flag.
3083 3083
3084 3084 Returns 0 if a match is found, 1 otherwise.
3085 3085 """
3086 3086 reflags = re.M
3087 3087 if opts.get('ignore_case'):
3088 3088 reflags |= re.I
3089 3089 try:
3090 3090 regexp = util.compilere(pattern, reflags)
3091 3091 except re.error, inst:
3092 3092 ui.warn(_("grep: invalid match pattern: %s\n") % inst)
3093 3093 return 1
3094 3094 sep, eol = ':', '\n'
3095 3095 if opts.get('print0'):
3096 3096 sep = eol = '\0'
3097 3097
3098 3098 getfile = util.lrucachefunc(repo.file)
3099 3099
3100 3100 def matchlines(body):
3101 3101 begin = 0
3102 3102 linenum = 0
3103 3103 while begin < len(body):
3104 3104 match = regexp.search(body, begin)
3105 3105 if not match:
3106 3106 break
3107 3107 mstart, mend = match.span()
3108 3108 linenum += body.count('\n', begin, mstart) + 1
3109 3109 lstart = body.rfind('\n', begin, mstart) + 1 or begin
3110 3110 begin = body.find('\n', mend) + 1 or len(body) + 1
3111 3111 lend = begin - 1
3112 3112 yield linenum, mstart - lstart, mend - lstart, body[lstart:lend]
3113 3113
3114 3114 class linestate(object):
3115 3115 def __init__(self, line, linenum, colstart, colend):
3116 3116 self.line = line
3117 3117 self.linenum = linenum
3118 3118 self.colstart = colstart
3119 3119 self.colend = colend
3120 3120
3121 3121 def __hash__(self):
3122 3122 return hash((self.linenum, self.line))
3123 3123
3124 3124 def __eq__(self, other):
3125 3125 return self.line == other.line
3126 3126
3127 3127 matches = {}
3128 3128 copies = {}
3129 3129 def grepbody(fn, rev, body):
3130 3130 matches[rev].setdefault(fn, [])
3131 3131 m = matches[rev][fn]
3132 3132 for lnum, cstart, cend, line in matchlines(body):
3133 3133 s = linestate(line, lnum, cstart, cend)
3134 3134 m.append(s)
3135 3135
3136 3136 def difflinestates(a, b):
3137 3137 sm = difflib.SequenceMatcher(None, a, b)
3138 3138 for tag, alo, ahi, blo, bhi in sm.get_opcodes():
3139 3139 if tag == 'insert':
3140 3140 for i in xrange(blo, bhi):
3141 3141 yield ('+', b[i])
3142 3142 elif tag == 'delete':
3143 3143 for i in xrange(alo, ahi):
3144 3144 yield ('-', a[i])
3145 3145 elif tag == 'replace':
3146 3146 for i in xrange(alo, ahi):
3147 3147 yield ('-', a[i])
3148 3148 for i in xrange(blo, bhi):
3149 3149 yield ('+', b[i])
3150 3150
3151 3151 def display(fn, ctx, pstates, states):
3152 3152 rev = ctx.rev()
3153 3153 datefunc = ui.quiet and util.shortdate or util.datestr
3154 3154 found = False
3155 3155 filerevmatches = {}
3156 3156 def binary():
3157 3157 flog = getfile(fn)
3158 3158 return util.binary(flog.read(ctx.filenode(fn)))
3159 3159
3160 3160 if opts.get('all'):
3161 3161 iter = difflinestates(pstates, states)
3162 3162 else:
3163 3163 iter = [('', l) for l in states]
3164 3164 for change, l in iter:
3165 3165 cols = [(fn, 'grep.filename'), (str(rev), 'grep.rev')]
3166 3166 before, match, after = None, None, None
3167 3167
3168 3168 if opts.get('line_number'):
3169 3169 cols.append((str(l.linenum), 'grep.linenumber'))
3170 3170 if opts.get('all'):
3171 3171 cols.append((change, 'grep.change'))
3172 3172 if opts.get('user'):
3173 3173 cols.append((ui.shortuser(ctx.user()), 'grep.user'))
3174 3174 if opts.get('date'):
3175 3175 cols.append((datefunc(ctx.date()), 'grep.date'))
3176 3176 if opts.get('files_with_matches'):
3177 3177 c = (fn, rev)
3178 3178 if c in filerevmatches:
3179 3179 continue
3180 3180 filerevmatches[c] = 1
3181 3181 else:
3182 3182 before = l.line[:l.colstart]
3183 3183 match = l.line[l.colstart:l.colend]
3184 3184 after = l.line[l.colend:]
3185 3185 for col, label in cols[:-1]:
3186 3186 ui.write(col, label=label)
3187 3187 ui.write(sep, label='grep.sep')
3188 3188 ui.write(cols[-1][0], label=cols[-1][1])
3189 3189 if before is not None:
3190 3190 ui.write(sep, label='grep.sep')
3191 3191 if not opts.get('text') and binary():
3192 3192 ui.write(" Binary file matches")
3193 3193 else:
3194 3194 ui.write(before)
3195 3195 ui.write(match, label='grep.match')
3196 3196 ui.write(after)
3197 3197 ui.write(eol)
3198 3198 found = True
3199 3199 return found
3200 3200
3201 3201 skip = {}
3202 3202 revfiles = {}
3203 3203 matchfn = scmutil.match(repo[None], pats, opts)
3204 3204 found = False
3205 3205 follow = opts.get('follow')
3206 3206
3207 3207 def prep(ctx, fns):
3208 3208 rev = ctx.rev()
3209 3209 pctx = ctx.p1()
3210 3210 parent = pctx.rev()
3211 3211 matches.setdefault(rev, {})
3212 3212 matches.setdefault(parent, {})
3213 3213 files = revfiles.setdefault(rev, [])
3214 3214 for fn in fns:
3215 3215 flog = getfile(fn)
3216 3216 try:
3217 3217 fnode = ctx.filenode(fn)
3218 3218 except error.LookupError:
3219 3219 continue
3220 3220
3221 3221 copied = flog.renamed(fnode)
3222 3222 copy = follow and copied and copied[0]
3223 3223 if copy:
3224 3224 copies.setdefault(rev, {})[fn] = copy
3225 3225 if fn in skip:
3226 3226 if copy:
3227 3227 skip[copy] = True
3228 3228 continue
3229 3229 files.append(fn)
3230 3230
3231 3231 if fn not in matches[rev]:
3232 3232 grepbody(fn, rev, flog.read(fnode))
3233 3233
3234 3234 pfn = copy or fn
3235 3235 if pfn not in matches[parent]:
3236 3236 try:
3237 3237 fnode = pctx.filenode(pfn)
3238 3238 grepbody(pfn, parent, flog.read(fnode))
3239 3239 except error.LookupError:
3240 3240 pass
3241 3241
3242 3242 for ctx in cmdutil.walkchangerevs(repo, matchfn, opts, prep):
3243 3243 rev = ctx.rev()
3244 3244 parent = ctx.p1().rev()
3245 3245 for fn in sorted(revfiles.get(rev, [])):
3246 3246 states = matches[rev][fn]
3247 3247 copy = copies.get(rev, {}).get(fn)
3248 3248 if fn in skip:
3249 3249 if copy:
3250 3250 skip[copy] = True
3251 3251 continue
3252 3252 pstates = matches.get(parent, {}).get(copy or fn, [])
3253 3253 if pstates or states:
3254 3254 r = display(fn, ctx, pstates, states)
3255 3255 found = found or r
3256 3256 if r and not opts.get('all'):
3257 3257 skip[fn] = True
3258 3258 if copy:
3259 3259 skip[copy] = True
3260 3260 del matches[rev]
3261 3261 del revfiles[rev]
3262 3262
3263 3263 return not found
3264 3264
3265 3265 @command('heads',
3266 3266 [('r', 'rev', '',
3267 3267 _('show only heads which are descendants of STARTREV'), _('STARTREV')),
3268 3268 ('t', 'topo', False, _('show topological heads only')),
3269 3269 ('a', 'active', False, _('show active branchheads only (DEPRECATED)')),
3270 3270 ('c', 'closed', False, _('show normal and closed branch heads')),
3271 3271 ] + templateopts,
3272 3272 _('[-ct] [-r STARTREV] [REV]...'))
3273 3273 def heads(ui, repo, *branchrevs, **opts):
3274 3274 """show current repository heads or show branch heads
3275 3275
3276 3276 With no arguments, show all repository branch heads.
3277 3277
3278 3278 Repository "heads" are changesets with no child changesets. They are
3279 3279 where development generally takes place and are the usual targets
3280 3280 for update and merge operations. Branch heads are changesets that have
3281 3281 no child changeset on the same branch.
3282 3282
3283 3283 If one or more REVs are given, only branch heads on the branches
3284 3284 associated with the specified changesets are shown. This means
3285 3285 that you can use :hg:`heads foo` to see the heads on a branch
3286 3286 named ``foo``.
3287 3287
3288 3288 If -c/--closed is specified, also show branch heads marked closed
3289 3289 (see :hg:`commit --close-branch`).
3290 3290
3291 3291 If STARTREV is specified, only those heads that are descendants of
3292 3292 STARTREV will be displayed.
3293 3293
3294 3294 If -t/--topo is specified, named branch mechanics will be ignored and only
3295 3295 changesets without children will be shown.
3296 3296
3297 3297 Returns 0 if matching heads are found, 1 if not.
3298 3298 """
3299 3299
3300 3300 start = None
3301 3301 if 'rev' in opts:
3302 3302 start = scmutil.revsingle(repo, opts['rev'], None).node()
3303 3303
3304 3304 if opts.get('topo'):
3305 3305 heads = [repo[h] for h in repo.heads(start)]
3306 3306 else:
3307 3307 heads = []
3308 3308 for branch in repo.branchmap():
3309 3309 heads += repo.branchheads(branch, start, opts.get('closed'))
3310 3310 heads = [repo[h] for h in heads]
3311 3311
3312 3312 if branchrevs:
3313 3313 branches = set(repo[br].branch() for br in branchrevs)
3314 3314 heads = [h for h in heads if h.branch() in branches]
3315 3315
3316 3316 if opts.get('active') and branchrevs:
3317 3317 dagheads = repo.heads(start)
3318 3318 heads = [h for h in heads if h.node() in dagheads]
3319 3319
3320 3320 if branchrevs:
3321 3321 haveheads = set(h.branch() for h in heads)
3322 3322 if branches - haveheads:
3323 3323 headless = ', '.join(b for b in branches - haveheads)
3324 3324 msg = _('no open branch heads found on branches %s')
3325 3325 if opts.get('rev'):
3326 3326 msg += _(' (started at %s)') % opts['rev']
3327 3327 ui.warn((msg + '\n') % headless)
3328 3328
3329 3329 if not heads:
3330 3330 return 1
3331 3331
3332 3332 heads = sorted(heads, key=lambda x: -x.rev())
3333 3333 displayer = cmdutil.show_changeset(ui, repo, opts)
3334 3334 for ctx in heads:
3335 3335 displayer.show(ctx)
3336 3336 displayer.close()
3337 3337
3338 3338 @command('help',
3339 3339 [('e', 'extension', None, _('show only help for extensions')),
3340 3340 ('c', 'command', None, _('show only help for commands')),
3341 3341 ('k', 'keyword', '', _('show topics matching keyword')),
3342 3342 ],
3343 3343 _('[-ec] [TOPIC]'))
3344 3344 def help_(ui, name=None, **opts):
3345 3345 """show help for a given topic or a help overview
3346 3346
3347 3347 With no arguments, print a list of commands with short help messages.
3348 3348
3349 3349 Given a topic, extension, or command name, print help for that
3350 3350 topic.
3351 3351
3352 3352 Returns 0 if successful.
3353 3353 """
3354 3354
3355 3355 textwidth = min(ui.termwidth(), 80) - 2
3356 3356
3357 3357 keep = ui.verbose and ['verbose'] or []
3358 3358 text = help.help_(ui, name, **opts)
3359 3359
3360 3360 formatted, pruned = minirst.format(text, textwidth, keep=keep)
3361 3361 if 'verbose' in pruned:
3362 3362 keep.append('omitted')
3363 3363 else:
3364 3364 keep.append('notomitted')
3365 3365 formatted, pruned = minirst.format(text, textwidth, keep=keep)
3366 3366 ui.write(formatted)
3367 3367
3368 3368
3369 3369 @command('identify|id',
3370 3370 [('r', 'rev', '',
3371 3371 _('identify the specified revision'), _('REV')),
3372 3372 ('n', 'num', None, _('show local revision number')),
3373 3373 ('i', 'id', None, _('show global revision id')),
3374 3374 ('b', 'branch', None, _('show branch')),
3375 3375 ('t', 'tags', None, _('show tags')),
3376 3376 ('B', 'bookmarks', None, _('show bookmarks')),
3377 3377 ] + remoteopts,
3378 3378 _('[-nibtB] [-r REV] [SOURCE]'))
3379 3379 def identify(ui, repo, source=None, rev=None,
3380 3380 num=None, id=None, branch=None, tags=None, bookmarks=None, **opts):
3381 3381 """identify the working copy or specified revision
3382 3382
3383 3383 Print a summary identifying the repository state at REV using one or
3384 3384 two parent hash identifiers, followed by a "+" if the working
3385 3385 directory has uncommitted changes, the branch name (if not default),
3386 3386 a list of tags, and a list of bookmarks.
3387 3387
3388 3388 When REV is not given, print a summary of the current state of the
3389 3389 repository.
3390 3390
3391 3391 Specifying a path to a repository root or Mercurial bundle will
3392 3392 cause lookup to operate on that repository/bundle.
3393 3393
3394 3394 .. container:: verbose
3395 3395
3396 3396 Examples:
3397 3397
3398 3398 - generate a build identifier for the working directory::
3399 3399
3400 3400 hg id --id > build-id.dat
3401 3401
3402 3402 - find the revision corresponding to a tag::
3403 3403
3404 3404 hg id -n -r 1.3
3405 3405
3406 3406 - check the most recent revision of a remote repository::
3407 3407
3408 3408 hg id -r tip http://selenic.com/hg/
3409 3409
3410 3410 Returns 0 if successful.
3411 3411 """
3412 3412
3413 3413 if not repo and not source:
3414 3414 raise util.Abort(_("there is no Mercurial repository here "
3415 3415 "(.hg not found)"))
3416 3416
3417 3417 hexfunc = ui.debugflag and hex or short
3418 3418 default = not (num or id or branch or tags or bookmarks)
3419 3419 output = []
3420 3420 revs = []
3421 3421
3422 3422 if source:
3423 3423 source, branches = hg.parseurl(ui.expandpath(source))
3424 3424 peer = hg.peer(repo or ui, opts, source) # only pass ui when no repo
3425 3425 repo = peer.local()
3426 3426 revs, checkout = hg.addbranchrevs(repo, peer, branches, None)
3427 3427
3428 3428 if not repo:
3429 3429 if num or branch or tags:
3430 3430 raise util.Abort(
3431 3431 _("can't query remote revision number, branch, or tags"))
3432 3432 if not rev and revs:
3433 3433 rev = revs[0]
3434 3434 if not rev:
3435 3435 rev = "tip"
3436 3436
3437 3437 remoterev = peer.lookup(rev)
3438 3438 if default or id:
3439 3439 output = [hexfunc(remoterev)]
3440 3440
3441 3441 def getbms():
3442 3442 bms = []
3443 3443
3444 3444 if 'bookmarks' in peer.listkeys('namespaces'):
3445 3445 hexremoterev = hex(remoterev)
3446 3446 bms = [bm for bm, bmr in peer.listkeys('bookmarks').iteritems()
3447 3447 if bmr == hexremoterev]
3448 3448
3449 3449 return sorted(bms)
3450 3450
3451 3451 if bookmarks:
3452 3452 output.extend(getbms())
3453 3453 elif default and not ui.quiet:
3454 3454 # multiple bookmarks for a single parent separated by '/'
3455 3455 bm = '/'.join(getbms())
3456 3456 if bm:
3457 3457 output.append(bm)
3458 3458 else:
3459 3459 if not rev:
3460 3460 ctx = repo[None]
3461 3461 parents = ctx.parents()
3462 3462 changed = ""
3463 3463 if default or id or num:
3464 3464 if (util.any(repo.status())
3465 3465 or util.any(ctx.sub(s).dirty() for s in ctx.substate)):
3466 3466 changed = '+'
3467 3467 if default or id:
3468 3468 output = ["%s%s" %
3469 3469 ('+'.join([hexfunc(p.node()) for p in parents]), changed)]
3470 3470 if num:
3471 3471 output.append("%s%s" %
3472 3472 ('+'.join([str(p.rev()) for p in parents]), changed))
3473 3473 else:
3474 3474 ctx = scmutil.revsingle(repo, rev)
3475 3475 if default or id:
3476 3476 output = [hexfunc(ctx.node())]
3477 3477 if num:
3478 3478 output.append(str(ctx.rev()))
3479 3479
3480 3480 if default and not ui.quiet:
3481 3481 b = ctx.branch()
3482 3482 if b != 'default':
3483 3483 output.append("(%s)" % b)
3484 3484
3485 3485 # multiple tags for a single parent separated by '/'
3486 3486 t = '/'.join(ctx.tags())
3487 3487 if t:
3488 3488 output.append(t)
3489 3489
3490 3490 # multiple bookmarks for a single parent separated by '/'
3491 3491 bm = '/'.join(ctx.bookmarks())
3492 3492 if bm:
3493 3493 output.append(bm)
3494 3494 else:
3495 3495 if branch:
3496 3496 output.append(ctx.branch())
3497 3497
3498 3498 if tags:
3499 3499 output.extend(ctx.tags())
3500 3500
3501 3501 if bookmarks:
3502 3502 output.extend(ctx.bookmarks())
3503 3503
3504 3504 ui.write("%s\n" % ' '.join(output))
3505 3505
3506 3506 @command('import|patch',
3507 3507 [('p', 'strip', 1,
3508 3508 _('directory strip option for patch. This has the same '
3509 3509 'meaning as the corresponding patch option'), _('NUM')),
3510 3510 ('b', 'base', '', _('base path (DEPRECATED)'), _('PATH')),
3511 3511 ('e', 'edit', False, _('invoke editor on commit messages')),
3512 3512 ('f', 'force', None, _('skip check for outstanding uncommitted changes')),
3513 3513 ('', 'no-commit', None,
3514 3514 _("don't commit, just update the working directory")),
3515 3515 ('', 'bypass', None,
3516 3516 _("apply patch without touching the working directory")),
3517 3517 ('', 'exact', None,
3518 3518 _('apply patch to the nodes from which it was generated')),
3519 3519 ('', 'import-branch', None,
3520 3520 _('use any branch information in patch (implied by --exact)'))] +
3521 3521 commitopts + commitopts2 + similarityopts,
3522 3522 _('[OPTION]... PATCH...'))
3523 3523 def import_(ui, repo, patch1=None, *patches, **opts):
3524 3524 """import an ordered set of patches
3525 3525
3526 3526 Import a list of patches and commit them individually (unless
3527 3527 --no-commit is specified).
3528 3528
3529 3529 If there are outstanding changes in the working directory, import
3530 3530 will abort unless given the -f/--force flag.
3531 3531
3532 3532 You can import a patch straight from a mail message. Even patches
3533 3533 as attachments work (to use the body part, it must have type
3534 3534 text/plain or text/x-patch). From and Subject headers of email
3535 3535 message are used as default committer and commit message. All
3536 3536 text/plain body parts before first diff are added to commit
3537 3537 message.
3538 3538
3539 3539 If the imported patch was generated by :hg:`export`, user and
3540 3540 description from patch override values from message headers and
3541 3541 body. Values given on command line with -m/--message and -u/--user
3542 3542 override these.
3543 3543
3544 3544 If --exact is specified, import will set the working directory to
3545 3545 the parent of each patch before applying it, and will abort if the
3546 3546 resulting changeset has a different ID than the one recorded in
3547 3547 the patch. This may happen due to character set problems or other
3548 3548 deficiencies in the text patch format.
3549 3549
3550 3550 Use --bypass to apply and commit patches directly to the
3551 3551 repository, not touching the working directory. Without --exact,
3552 3552 patches will be applied on top of the working directory parent
3553 3553 revision.
3554 3554
3555 3555 With -s/--similarity, hg will attempt to discover renames and
3556 3556 copies in the patch in the same way as :hg:`addremove`.
3557 3557
3558 3558 To read a patch from standard input, use "-" as the patch name. If
3559 3559 a URL is specified, the patch will be downloaded from it.
3560 3560 See :hg:`help dates` for a list of formats valid for -d/--date.
3561 3561
3562 3562 .. container:: verbose
3563 3563
3564 3564 Examples:
3565 3565
3566 3566 - import a traditional patch from a website and detect renames::
3567 3567
3568 3568 hg import -s 80 http://example.com/bugfix.patch
3569 3569
3570 3570 - import a changeset from an hgweb server::
3571 3571
3572 3572 hg import http://www.selenic.com/hg/rev/5ca8c111e9aa
3573 3573
3574 3574 - import all the patches in an Unix-style mbox::
3575 3575
3576 3576 hg import incoming-patches.mbox
3577 3577
3578 3578 - attempt to exactly restore an exported changeset (not always
3579 3579 possible)::
3580 3580
3581 3581 hg import --exact proposed-fix.patch
3582 3582
3583 3583 Returns 0 on success.
3584 3584 """
3585 3585
3586 3586 if not patch1:
3587 3587 raise util.Abort(_('need at least one patch to import'))
3588 3588
3589 3589 patches = (patch1,) + patches
3590 3590
3591 3591 date = opts.get('date')
3592 3592 if date:
3593 3593 opts['date'] = util.parsedate(date)
3594 3594
3595 3595 editor = cmdutil.commiteditor
3596 3596 if opts.get('edit'):
3597 3597 editor = cmdutil.commitforceeditor
3598 3598
3599 3599 update = not opts.get('bypass')
3600 3600 if not update and opts.get('no_commit'):
3601 3601 raise util.Abort(_('cannot use --no-commit with --bypass'))
3602 3602 try:
3603 3603 sim = float(opts.get('similarity') or 0)
3604 3604 except ValueError:
3605 3605 raise util.Abort(_('similarity must be a number'))
3606 3606 if sim < 0 or sim > 100:
3607 3607 raise util.Abort(_('similarity must be between 0 and 100'))
3608 3608 if sim and not update:
3609 3609 raise util.Abort(_('cannot use --similarity with --bypass'))
3610 3610
3611 3611 if (opts.get('exact') or not opts.get('force')) and update:
3612 3612 cmdutil.bailifchanged(repo)
3613 3613
3614 3614 base = opts["base"]
3615 3615 strip = opts["strip"]
3616 3616 wlock = lock = tr = None
3617 3617 msgs = []
3618 3618
3619 3619 def tryone(ui, hunk, parents):
3620 3620 tmpname, message, user, date, branch, nodeid, p1, p2 = \
3621 3621 patch.extract(ui, hunk)
3622 3622
3623 3623 if not tmpname:
3624 3624 return (None, None)
3625 3625 msg = _('applied to working directory')
3626 3626
3627 3627 try:
3628 3628 cmdline_message = cmdutil.logmessage(ui, opts)
3629 3629 if cmdline_message:
3630 3630 # pickup the cmdline msg
3631 3631 message = cmdline_message
3632 3632 elif message:
3633 3633 # pickup the patch msg
3634 3634 message = message.strip()
3635 3635 else:
3636 3636 # launch the editor
3637 3637 message = None
3638 3638 ui.debug('message:\n%s\n' % message)
3639 3639
3640 3640 if len(parents) == 1:
3641 3641 parents.append(repo[nullid])
3642 3642 if opts.get('exact'):
3643 3643 if not nodeid or not p1:
3644 3644 raise util.Abort(_('not a Mercurial patch'))
3645 3645 p1 = repo[p1]
3646 3646 p2 = repo[p2 or nullid]
3647 3647 elif p2:
3648 3648 try:
3649 3649 p1 = repo[p1]
3650 3650 p2 = repo[p2]
3651 3651 # Without any options, consider p2 only if the
3652 3652 # patch is being applied on top of the recorded
3653 3653 # first parent.
3654 3654 if p1 != parents[0]:
3655 3655 p1 = parents[0]
3656 3656 p2 = repo[nullid]
3657 3657 except error.RepoError:
3658 3658 p1, p2 = parents
3659 3659 else:
3660 3660 p1, p2 = parents
3661 3661
3662 3662 n = None
3663 3663 if update:
3664 3664 if p1 != parents[0]:
3665 3665 hg.clean(repo, p1.node())
3666 3666 if p2 != parents[1]:
3667 3667 repo.setparents(p1.node(), p2.node())
3668 3668
3669 3669 if opts.get('exact') or opts.get('import_branch'):
3670 3670 repo.dirstate.setbranch(branch or 'default')
3671 3671
3672 3672 files = set()
3673 3673 patch.patch(ui, repo, tmpname, strip=strip, files=files,
3674 3674 eolmode=None, similarity=sim / 100.0)
3675 3675 files = list(files)
3676 3676 if opts.get('no_commit'):
3677 3677 if message:
3678 3678 msgs.append(message)
3679 3679 else:
3680 3680 if opts.get('exact') or p2:
3681 3681 # If you got here, you either use --force and know what
3682 3682 # you are doing or used --exact or a merge patch while
3683 3683 # being updated to its first parent.
3684 3684 m = None
3685 3685 else:
3686 3686 m = scmutil.matchfiles(repo, files or [])
3687 3687 n = repo.commit(message, opts.get('user') or user,
3688 3688 opts.get('date') or date, match=m,
3689 3689 editor=editor)
3690 3690 else:
3691 3691 if opts.get('exact') or opts.get('import_branch'):
3692 3692 branch = branch or 'default'
3693 3693 else:
3694 3694 branch = p1.branch()
3695 3695 store = patch.filestore()
3696 3696 try:
3697 3697 files = set()
3698 3698 try:
3699 3699 patch.patchrepo(ui, repo, p1, store, tmpname, strip,
3700 3700 files, eolmode=None)
3701 3701 except patch.PatchError, e:
3702 3702 raise util.Abort(str(e))
3703 3703 memctx = patch.makememctx(repo, (p1.node(), p2.node()),
3704 3704 message,
3705 3705 opts.get('user') or user,
3706 3706 opts.get('date') or date,
3707 3707 branch, files, store,
3708 3708 editor=cmdutil.commiteditor)
3709 3709 repo.savecommitmessage(memctx.description())
3710 3710 n = memctx.commit()
3711 3711 finally:
3712 3712 store.close()
3713 3713 if opts.get('exact') and hex(n) != nodeid:
3714 3714 raise util.Abort(_('patch is damaged or loses information'))
3715 3715 if n:
3716 3716 # i18n: refers to a short changeset id
3717 3717 msg = _('created %s') % short(n)
3718 3718 return (msg, n)
3719 3719 finally:
3720 3720 os.unlink(tmpname)
3721 3721
3722 3722 try:
3723 3723 try:
3724 3724 wlock = repo.wlock()
3725 3725 if not opts.get('no_commit'):
3726 3726 lock = repo.lock()
3727 3727 tr = repo.transaction('import')
3728 3728 parents = repo.parents()
3729 3729 for patchurl in patches:
3730 3730 if patchurl == '-':
3731 3731 ui.status(_('applying patch from stdin\n'))
3732 3732 patchfile = ui.fin
3733 3733 patchurl = 'stdin' # for error message
3734 3734 else:
3735 3735 patchurl = os.path.join(base, patchurl)
3736 3736 ui.status(_('applying %s\n') % patchurl)
3737 3737 patchfile = hg.openpath(ui, patchurl)
3738 3738
3739 3739 haspatch = False
3740 3740 for hunk in patch.split(patchfile):
3741 3741 (msg, node) = tryone(ui, hunk, parents)
3742 3742 if msg:
3743 3743 haspatch = True
3744 3744 ui.note(msg + '\n')
3745 3745 if update or opts.get('exact'):
3746 3746 parents = repo.parents()
3747 3747 else:
3748 3748 parents = [repo[node]]
3749 3749
3750 3750 if not haspatch:
3751 3751 raise util.Abort(_('%s: no diffs found') % patchurl)
3752 3752
3753 3753 if tr:
3754 3754 tr.close()
3755 3755 if msgs:
3756 3756 repo.savecommitmessage('\n* * *\n'.join(msgs))
3757 3757 except: # re-raises
3758 3758 # wlock.release() indirectly calls dirstate.write(): since
3759 3759 # we're crashing, we do not want to change the working dir
3760 3760 # parent after all, so make sure it writes nothing
3761 3761 repo.dirstate.invalidate()
3762 3762 raise
3763 3763 finally:
3764 3764 if tr:
3765 3765 tr.release()
3766 3766 release(lock, wlock)
3767 3767
3768 3768 @command('incoming|in',
3769 3769 [('f', 'force', None,
3770 3770 _('run even if remote repository is unrelated')),
3771 3771 ('n', 'newest-first', None, _('show newest record first')),
3772 3772 ('', 'bundle', '',
3773 3773 _('file to store the bundles into'), _('FILE')),
3774 3774 ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
3775 3775 ('B', 'bookmarks', False, _("compare bookmarks")),
3776 3776 ('b', 'branch', [],
3777 3777 _('a specific branch you would like to pull'), _('BRANCH')),
3778 3778 ] + logopts + remoteopts + subrepoopts,
3779 3779 _('[-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]'))
3780 3780 def incoming(ui, repo, source="default", **opts):
3781 3781 """show new changesets found in source
3782 3782
3783 3783 Show new changesets found in the specified path/URL or the default
3784 3784 pull location. These are the changesets that would have been pulled
3785 3785 if a pull at the time you issued this command.
3786 3786
3787 3787 For remote repository, using --bundle avoids downloading the
3788 3788 changesets twice if the incoming is followed by a pull.
3789 3789
3790 3790 See pull for valid source format details.
3791 3791
3792 3792 Returns 0 if there are incoming changes, 1 otherwise.
3793 3793 """
3794 3794 if opts.get('graph'):
3795 3795 cmdutil.checkunsupportedgraphflags([], opts)
3796 3796 def display(other, chlist, displayer):
3797 3797 revdag = cmdutil.graphrevs(other, chlist, opts)
3798 3798 showparents = [ctx.node() for ctx in repo[None].parents()]
3799 3799 cmdutil.displaygraph(ui, revdag, displayer, showparents,
3800 3800 graphmod.asciiedges)
3801 3801
3802 3802 hg._incoming(display, lambda: 1, ui, repo, source, opts, buffered=True)
3803 3803 return 0
3804 3804
3805 3805 if opts.get('bundle') and opts.get('subrepos'):
3806 3806 raise util.Abort(_('cannot combine --bundle and --subrepos'))
3807 3807
3808 3808 if opts.get('bookmarks'):
3809 3809 source, branches = hg.parseurl(ui.expandpath(source),
3810 3810 opts.get('branch'))
3811 3811 other = hg.peer(repo, opts, source)
3812 3812 if 'bookmarks' not in other.listkeys('namespaces'):
3813 3813 ui.warn(_("remote doesn't support bookmarks\n"))
3814 3814 return 0
3815 3815 ui.status(_('comparing with %s\n') % util.hidepassword(source))
3816 3816 return bookmarks.diff(ui, repo, other)
3817 3817
3818 3818 repo._subtoppath = ui.expandpath(source)
3819 3819 try:
3820 3820 return hg.incoming(ui, repo, source, opts)
3821 3821 finally:
3822 3822 del repo._subtoppath
3823 3823
3824 3824
3825 3825 @command('^init', remoteopts, _('[-e CMD] [--remotecmd CMD] [DEST]'))
3826 3826 def init(ui, dest=".", **opts):
3827 3827 """create a new repository in the given directory
3828 3828
3829 3829 Initialize a new repository in the given directory. If the given
3830 3830 directory does not exist, it will be created.
3831 3831
3832 3832 If no directory is given, the current directory is used.
3833 3833
3834 3834 It is possible to specify an ``ssh://`` URL as the destination.
3835 3835 See :hg:`help urls` for more information.
3836 3836
3837 3837 Returns 0 on success.
3838 3838 """
3839 3839 hg.peer(ui, opts, ui.expandpath(dest), create=True)
3840 3840
3841 3841 @command('locate',
3842 3842 [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
3843 3843 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
3844 3844 ('f', 'fullpath', None, _('print complete paths from the filesystem root')),
3845 3845 ] + walkopts,
3846 3846 _('[OPTION]... [PATTERN]...'))
3847 3847 def locate(ui, repo, *pats, **opts):
3848 3848 """locate files matching specific patterns
3849 3849
3850 3850 Print files under Mercurial control in the working directory whose
3851 3851 names match the given patterns.
3852 3852
3853 3853 By default, this command searches all directories in the working
3854 3854 directory. To search just the current directory and its
3855 3855 subdirectories, use "--include .".
3856 3856
3857 3857 If no patterns are given to match, this command prints the names
3858 3858 of all files under Mercurial control in the working directory.
3859 3859
3860 3860 If you want to feed the output of this command into the "xargs"
3861 3861 command, use the -0 option to both this command and "xargs". This
3862 3862 will avoid the problem of "xargs" treating single filenames that
3863 3863 contain whitespace as multiple filenames.
3864 3864
3865 3865 Returns 0 if a match is found, 1 otherwise.
3866 3866 """
3867 3867 end = opts.get('print0') and '\0' or '\n'
3868 3868 rev = scmutil.revsingle(repo, opts.get('rev'), None).node()
3869 3869
3870 3870 ret = 1
3871 3871 m = scmutil.match(repo[rev], pats, opts, default='relglob')
3872 3872 m.bad = lambda x, y: False
3873 3873 for abs in repo[rev].walk(m):
3874 3874 if not rev and abs not in repo.dirstate:
3875 3875 continue
3876 3876 if opts.get('fullpath'):
3877 3877 ui.write(repo.wjoin(abs), end)
3878 3878 else:
3879 3879 ui.write(((pats and m.rel(abs)) or abs), end)
3880 3880 ret = 0
3881 3881
3882 3882 return ret
3883 3883
3884 3884 @command('^log|history',
3885 3885 [('f', 'follow', None,
3886 3886 _('follow changeset history, or file history across copies and renames')),
3887 3887 ('', 'follow-first', None,
3888 3888 _('only follow the first parent of merge changesets (DEPRECATED)')),
3889 3889 ('d', 'date', '', _('show revisions matching date spec'), _('DATE')),
3890 3890 ('C', 'copies', None, _('show copied files')),
3891 3891 ('k', 'keyword', [],
3892 3892 _('do case-insensitive search for a given text'), _('TEXT')),
3893 3893 ('r', 'rev', [], _('show the specified revision or range'), _('REV')),
3894 3894 ('', 'removed', None, _('include revisions where files were removed')),
3895 3895 ('m', 'only-merges', None, _('show only merges (DEPRECATED)')),
3896 3896 ('u', 'user', [], _('revisions committed by user'), _('USER')),
3897 3897 ('', 'only-branch', [],
3898 3898 _('show only changesets within the given named branch (DEPRECATED)'),
3899 3899 _('BRANCH')),
3900 3900 ('b', 'branch', [],
3901 3901 _('show changesets within the given named branch'), _('BRANCH')),
3902 3902 ('P', 'prune', [],
3903 3903 _('do not display revision or any of its ancestors'), _('REV')),
3904 3904 ] + logopts + walkopts,
3905 3905 _('[OPTION]... [FILE]'))
3906 3906 def log(ui, repo, *pats, **opts):
3907 3907 """show revision history of entire repository or files
3908 3908
3909 3909 Print the revision history of the specified files or the entire
3910 3910 project.
3911 3911
3912 3912 If no revision range is specified, the default is ``tip:0`` unless
3913 3913 --follow is set, in which case the working directory parent is
3914 3914 used as the starting revision.
3915 3915
3916 3916 File history is shown without following rename or copy history of
3917 3917 files. Use -f/--follow with a filename to follow history across
3918 3918 renames and copies. --follow without a filename will only show
3919 3919 ancestors or descendants of the starting revision.
3920 3920
3921 3921 By default this command prints revision number and changeset id,
3922 3922 tags, non-trivial parents, user, date and time, and a summary for
3923 3923 each commit. When the -v/--verbose switch is used, the list of
3924 3924 changed files and full commit message are shown.
3925 3925
3926 3926 .. note::
3927 3927 log -p/--patch may generate unexpected diff output for merge
3928 3928 changesets, as it will only compare the merge changeset against
3929 3929 its first parent. Also, only files different from BOTH parents
3930 3930 will appear in files:.
3931 3931
3932 3932 .. note::
3933 3933 for performance reasons, log FILE may omit duplicate changes
3934 3934 made on branches and will not show deletions. To see all
3935 3935 changes including duplicates and deletions, use the --removed
3936 3936 switch.
3937 3937
3938 3938 .. container:: verbose
3939 3939
3940 3940 Some examples:
3941 3941
3942 3942 - changesets with full descriptions and file lists::
3943 3943
3944 3944 hg log -v
3945 3945
3946 3946 - changesets ancestral to the working directory::
3947 3947
3948 3948 hg log -f
3949 3949
3950 3950 - last 10 commits on the current branch::
3951 3951
3952 3952 hg log -l 10 -b .
3953 3953
3954 3954 - changesets showing all modifications of a file, including removals::
3955 3955
3956 3956 hg log --removed file.c
3957 3957
3958 3958 - all changesets that touch a directory, with diffs, excluding merges::
3959 3959
3960 3960 hg log -Mp lib/
3961 3961
3962 3962 - all revision numbers that match a keyword::
3963 3963
3964 3964 hg log -k bug --template "{rev}\\n"
3965 3965
3966 3966 - check if a given changeset is included is a tagged release::
3967 3967
3968 3968 hg log -r "a21ccf and ancestor(1.9)"
3969 3969
3970 3970 - find all changesets by some user in a date range::
3971 3971
3972 3972 hg log -k alice -d "may 2008 to jul 2008"
3973 3973
3974 3974 - summary of all changesets after the last tag::
3975 3975
3976 3976 hg log -r "last(tagged())::" --template "{desc|firstline}\\n"
3977 3977
3978 3978 See :hg:`help dates` for a list of formats valid for -d/--date.
3979 3979
3980 3980 See :hg:`help revisions` and :hg:`help revsets` for more about
3981 3981 specifying revisions.
3982 3982
3983 3983 See :hg:`help templates` for more about pre-packaged styles and
3984 3984 specifying custom templates.
3985 3985
3986 3986 Returns 0 on success.
3987 3987 """
3988 3988 if opts.get('graph'):
3989 3989 return cmdutil.graphlog(ui, repo, *pats, **opts)
3990 3990
3991 3991 matchfn = scmutil.match(repo[None], pats, opts)
3992 3992 limit = cmdutil.loglimit(opts)
3993 3993 count = 0
3994 3994
3995 3995 getrenamed, endrev = None, None
3996 3996 if opts.get('copies'):
3997 3997 if opts.get('rev'):
3998 3998 endrev = max(scmutil.revrange(repo, opts.get('rev'))) + 1
3999 3999 getrenamed = templatekw.getrenamedfn(repo, endrev=endrev)
4000 4000
4001 4001 df = False
4002 4002 if opts.get("date"):
4003 4003 df = util.matchdate(opts["date"])
4004 4004
4005 4005 branches = opts.get('branch', []) + opts.get('only_branch', [])
4006 4006 opts['branch'] = [repo.lookupbranch(b) for b in branches]
4007 4007
4008 4008 displayer = cmdutil.show_changeset(ui, repo, opts, True)
4009 4009 def prep(ctx, fns):
4010 4010 rev = ctx.rev()
4011 4011 parents = [p for p in repo.changelog.parentrevs(rev)
4012 4012 if p != nullrev]
4013 4013 if opts.get('no_merges') and len(parents) == 2:
4014 4014 return
4015 4015 if opts.get('only_merges') and len(parents) != 2:
4016 4016 return
4017 4017 if opts.get('branch') and ctx.branch() not in opts['branch']:
4018 4018 return
4019 4019 if df and not df(ctx.date()[0]):
4020 4020 return
4021 4021
4022 4022 lower = encoding.lower
4023 4023 if opts.get('user'):
4024 4024 luser = lower(ctx.user())
4025 4025 for k in [lower(x) for x in opts['user']]:
4026 4026 if (k in luser):
4027 4027 break
4028 4028 else:
4029 4029 return
4030 4030 if opts.get('keyword'):
4031 4031 luser = lower(ctx.user())
4032 4032 ldesc = lower(ctx.description())
4033 4033 lfiles = lower(" ".join(ctx.files()))
4034 4034 for k in [lower(x) for x in opts['keyword']]:
4035 4035 if (k in luser or k in ldesc or k in lfiles):
4036 4036 break
4037 4037 else:
4038 4038 return
4039 4039
4040 4040 copies = None
4041 4041 if getrenamed is not None and rev:
4042 4042 copies = []
4043 4043 for fn in ctx.files():
4044 4044 rename = getrenamed(fn, rev)
4045 4045 if rename:
4046 4046 copies.append((fn, rename[0]))
4047 4047
4048 4048 revmatchfn = None
4049 4049 if opts.get('patch') or opts.get('stat'):
4050 4050 if opts.get('follow') or opts.get('follow_first'):
4051 4051 # note: this might be wrong when following through merges
4052 4052 revmatchfn = scmutil.match(repo[None], fns, default='path')
4053 4053 else:
4054 4054 revmatchfn = matchfn
4055 4055
4056 4056 displayer.show(ctx, copies=copies, matchfn=revmatchfn)
4057 4057
4058 4058 for ctx in cmdutil.walkchangerevs(repo, matchfn, opts, prep):
4059 4059 if displayer.flush(ctx.rev()):
4060 4060 count += 1
4061 4061 if count == limit:
4062 4062 break
4063 4063 displayer.close()
4064 4064
4065 4065 @command('manifest',
4066 4066 [('r', 'rev', '', _('revision to display'), _('REV')),
4067 4067 ('', 'all', False, _("list files from all revisions"))],
4068 4068 _('[-r REV]'))
4069 4069 def manifest(ui, repo, node=None, rev=None, **opts):
4070 4070 """output the current or given revision of the project manifest
4071 4071
4072 4072 Print a list of version controlled files for the given revision.
4073 4073 If no revision is given, the first parent of the working directory
4074 4074 is used, or the null revision if no revision is checked out.
4075 4075
4076 4076 With -v, print file permissions, symlink and executable bits.
4077 4077 With --debug, print file revision hashes.
4078 4078
4079 4079 If option --all is specified, the list of all files from all revisions
4080 4080 is printed. This includes deleted and renamed files.
4081 4081
4082 4082 Returns 0 on success.
4083 4083 """
4084 4084
4085 4085 fm = ui.formatter('manifest', opts)
4086 4086
4087 4087 if opts.get('all'):
4088 4088 if rev or node:
4089 4089 raise util.Abort(_("can't specify a revision with --all"))
4090 4090
4091 4091 res = []
4092 4092 prefix = "data/"
4093 4093 suffix = ".i"
4094 4094 plen = len(prefix)
4095 4095 slen = len(suffix)
4096 4096 lock = repo.lock()
4097 4097 try:
4098 4098 for fn, b, size in repo.store.datafiles():
4099 4099 if size != 0 and fn[-slen:] == suffix and fn[:plen] == prefix:
4100 4100 res.append(fn[plen:-slen])
4101 4101 finally:
4102 4102 lock.release()
4103 4103 for f in res:
4104 4104 fm.startitem()
4105 4105 fm.write("path", '%s\n', f)
4106 4106 fm.end()
4107 4107 return
4108 4108
4109 4109 if rev and node:
4110 4110 raise util.Abort(_("please specify just one revision"))
4111 4111
4112 4112 if not node:
4113 4113 node = rev
4114 4114
4115 4115 char = {'l': '@', 'x': '*', '': ''}
4116 4116 mode = {'l': '644', 'x': '755', '': '644'}
4117 4117 ctx = scmutil.revsingle(repo, node)
4118 4118 mf = ctx.manifest()
4119 4119 for f in ctx:
4120 4120 fm.startitem()
4121 4121 fl = ctx[f].flags()
4122 4122 fm.condwrite(ui.debugflag, 'hash', '%s ', hex(mf[f]))
4123 4123 fm.condwrite(ui.verbose, 'mode type', '%s %1s ', mode[fl], char[fl])
4124 4124 fm.write('path', '%s\n', f)
4125 4125 fm.end()
4126 4126
4127 4127 @command('^merge',
4128 4128 [('f', 'force', None, _('force a merge with outstanding changes')),
4129 4129 ('r', 'rev', '', _('revision to merge'), _('REV')),
4130 4130 ('P', 'preview', None,
4131 4131 _('review revisions to merge (no merge is performed)'))
4132 4132 ] + mergetoolopts,
4133 4133 _('[-P] [-f] [[-r] REV]'))
4134 4134 def merge(ui, repo, node=None, **opts):
4135 4135 """merge working directory with another revision
4136 4136
4137 4137 The current working directory is updated with all changes made in
4138 4138 the requested revision since the last common predecessor revision.
4139 4139
4140 4140 Files that changed between either parent are marked as changed for
4141 4141 the next commit and a commit must be performed before any further
4142 4142 updates to the repository are allowed. The next commit will have
4143 4143 two parents.
4144 4144
4145 4145 ``--tool`` can be used to specify the merge tool used for file
4146 4146 merges. It overrides the HGMERGE environment variable and your
4147 4147 configuration files. See :hg:`help merge-tools` for options.
4148 4148
4149 4149 If no revision is specified, the working directory's parent is a
4150 4150 head revision, and the current branch contains exactly one other
4151 4151 head, the other head is merged with by default. Otherwise, an
4152 4152 explicit revision with which to merge with must be provided.
4153 4153
4154 4154 :hg:`resolve` must be used to resolve unresolved files.
4155 4155
4156 4156 To undo an uncommitted merge, use :hg:`update --clean .` which
4157 4157 will check out a clean copy of the original merge parent, losing
4158 4158 all changes.
4159 4159
4160 4160 Returns 0 on success, 1 if there are unresolved files.
4161 4161 """
4162 4162
4163 4163 if opts.get('rev') and node:
4164 4164 raise util.Abort(_("please specify just one revision"))
4165 4165 if not node:
4166 4166 node = opts.get('rev')
4167 4167
4168 4168 if node:
4169 4169 node = scmutil.revsingle(repo, node).node()
4170 4170
4171 4171 if not node and repo._bookmarkcurrent:
4172 4172 bmheads = repo.bookmarkheads(repo._bookmarkcurrent)
4173 4173 curhead = repo[repo._bookmarkcurrent].node()
4174 4174 if len(bmheads) == 2:
4175 4175 if curhead == bmheads[0]:
4176 4176 node = bmheads[1]
4177 4177 else:
4178 4178 node = bmheads[0]
4179 4179 elif len(bmheads) > 2:
4180 4180 raise util.Abort(_("multiple matching bookmarks to merge - "
4181 4181 "please merge with an explicit rev or bookmark"),
4182 4182 hint=_("run 'hg heads' to see all heads"))
4183 4183 elif len(bmheads) <= 1:
4184 4184 raise util.Abort(_("no matching bookmark to merge - "
4185 4185 "please merge with an explicit rev or bookmark"),
4186 4186 hint=_("run 'hg heads' to see all heads"))
4187 4187
4188 4188 if not node and not repo._bookmarkcurrent:
4189 4189 branch = repo[None].branch()
4190 4190 bheads = repo.branchheads(branch)
4191 4191 nbhs = [bh for bh in bheads if not repo[bh].bookmarks()]
4192 4192
4193 4193 if len(nbhs) > 2:
4194 4194 raise util.Abort(_("branch '%s' has %d heads - "
4195 4195 "please merge with an explicit rev")
4196 4196 % (branch, len(bheads)),
4197 4197 hint=_("run 'hg heads .' to see heads"))
4198 4198
4199 4199 parent = repo.dirstate.p1()
4200 4200 if len(nbhs) <= 1:
4201 4201 if len(bheads) > 1:
4202 4202 raise util.Abort(_("heads are bookmarked - "
4203 4203 "please merge with an explicit rev"),
4204 4204 hint=_("run 'hg heads' to see all heads"))
4205 4205 if len(repo.heads()) > 1:
4206 4206 raise util.Abort(_("branch '%s' has one head - "
4207 4207 "please merge with an explicit rev")
4208 4208 % branch,
4209 4209 hint=_("run 'hg heads' to see all heads"))
4210 4210 msg, hint = _('nothing to merge'), None
4211 4211 if parent != repo.lookup(branch):
4212 4212 hint = _("use 'hg update' instead")
4213 4213 raise util.Abort(msg, hint=hint)
4214 4214
4215 4215 if parent not in bheads:
4216 4216 raise util.Abort(_('working directory not at a head revision'),
4217 4217 hint=_("use 'hg update' or merge with an "
4218 4218 "explicit revision"))
4219 4219 if parent == nbhs[0]:
4220 4220 node = nbhs[-1]
4221 4221 else:
4222 4222 node = nbhs[0]
4223 4223
4224 4224 if opts.get('preview'):
4225 4225 # find nodes that are ancestors of p2 but not of p1
4226 4226 p1 = repo.lookup('.')
4227 4227 p2 = repo.lookup(node)
4228 4228 nodes = repo.changelog.findmissing(common=[p1], heads=[p2])
4229 4229
4230 4230 displayer = cmdutil.show_changeset(ui, repo, opts)
4231 4231 for node in nodes:
4232 4232 displayer.show(repo[node])
4233 4233 displayer.close()
4234 4234 return 0
4235 4235
4236 4236 try:
4237 4237 # ui.forcemerge is an internal variable, do not document
4238 4238 repo.ui.setconfig('ui', 'forcemerge', opts.get('tool', ''))
4239 4239 return hg.merge(repo, node, force=opts.get('force'))
4240 4240 finally:
4241 4241 ui.setconfig('ui', 'forcemerge', '')
4242 4242
4243 4243 @command('outgoing|out',
4244 4244 [('f', 'force', None, _('run even when the destination is unrelated')),
4245 4245 ('r', 'rev', [],
4246 4246 _('a changeset intended to be included in the destination'), _('REV')),
4247 4247 ('n', 'newest-first', None, _('show newest record first')),
4248 4248 ('B', 'bookmarks', False, _('compare bookmarks')),
4249 4249 ('b', 'branch', [], _('a specific branch you would like to push'),
4250 4250 _('BRANCH')),
4251 4251 ] + logopts + remoteopts + subrepoopts,
4252 4252 _('[-M] [-p] [-n] [-f] [-r REV]... [DEST]'))
4253 4253 def outgoing(ui, repo, dest=None, **opts):
4254 4254 """show changesets not found in the destination
4255 4255
4256 4256 Show changesets not found in the specified destination repository
4257 4257 or the default push location. These are the changesets that would
4258 4258 be pushed if a push was requested.
4259 4259
4260 4260 See pull for details of valid destination formats.
4261 4261
4262 4262 Returns 0 if there are outgoing changes, 1 otherwise.
4263 4263 """
4264 4264 if opts.get('graph'):
4265 4265 cmdutil.checkunsupportedgraphflags([], opts)
4266 4266 o = hg._outgoing(ui, repo, dest, opts)
4267 4267 if o is None:
4268 4268 return
4269 4269
4270 4270 revdag = cmdutil.graphrevs(repo, o, opts)
4271 4271 displayer = cmdutil.show_changeset(ui, repo, opts, buffered=True)
4272 4272 showparents = [ctx.node() for ctx in repo[None].parents()]
4273 4273 cmdutil.displaygraph(ui, revdag, displayer, showparents,
4274 4274 graphmod.asciiedges)
4275 4275 return 0
4276 4276
4277 4277 if opts.get('bookmarks'):
4278 4278 dest = ui.expandpath(dest or 'default-push', dest or 'default')
4279 4279 dest, branches = hg.parseurl(dest, opts.get('branch'))
4280 4280 other = hg.peer(repo, opts, dest)
4281 4281 if 'bookmarks' not in other.listkeys('namespaces'):
4282 4282 ui.warn(_("remote doesn't support bookmarks\n"))
4283 4283 return 0
4284 4284 ui.status(_('comparing with %s\n') % util.hidepassword(dest))
4285 4285 return bookmarks.diff(ui, other, repo)
4286 4286
4287 4287 repo._subtoppath = ui.expandpath(dest or 'default-push', dest or 'default')
4288 4288 try:
4289 4289 return hg.outgoing(ui, repo, dest, opts)
4290 4290 finally:
4291 4291 del repo._subtoppath
4292 4292
4293 4293 @command('parents',
4294 4294 [('r', 'rev', '', _('show parents of the specified revision'), _('REV')),
4295 4295 ] + templateopts,
4296 4296 _('[-r REV] [FILE]'))
4297 4297 def parents(ui, repo, file_=None, **opts):
4298 4298 """show the parents of the working directory or revision
4299 4299
4300 4300 Print the working directory's parent revisions. If a revision is
4301 4301 given via -r/--rev, the parent of that revision will be printed.
4302 4302 If a file argument is given, the revision in which the file was
4303 4303 last changed (before the working directory revision or the
4304 4304 argument to --rev if given) is printed.
4305 4305
4306 4306 Returns 0 on success.
4307 4307 """
4308 4308
4309 4309 ctx = scmutil.revsingle(repo, opts.get('rev'), None)
4310 4310
4311 4311 if file_:
4312 4312 m = scmutil.match(ctx, (file_,), opts)
4313 4313 if m.anypats() or len(m.files()) != 1:
4314 4314 raise util.Abort(_('can only specify an explicit filename'))
4315 4315 file_ = m.files()[0]
4316 4316 filenodes = []
4317 4317 for cp in ctx.parents():
4318 4318 if not cp:
4319 4319 continue
4320 4320 try:
4321 4321 filenodes.append(cp.filenode(file_))
4322 4322 except error.LookupError:
4323 4323 pass
4324 4324 if not filenodes:
4325 4325 raise util.Abort(_("'%s' not found in manifest!") % file_)
4326 4326 fl = repo.file(file_)
4327 4327 p = [repo.lookup(fl.linkrev(fl.rev(fn))) for fn in filenodes]
4328 4328 else:
4329 4329 p = [cp.node() for cp in ctx.parents()]
4330 4330
4331 4331 displayer = cmdutil.show_changeset(ui, repo, opts)
4332 4332 for n in p:
4333 4333 if n != nullid:
4334 4334 displayer.show(repo[n])
4335 4335 displayer.close()
4336 4336
4337 4337 @command('paths', [], _('[NAME]'))
4338 4338 def paths(ui, repo, search=None):
4339 4339 """show aliases for remote repositories
4340 4340
4341 4341 Show definition of symbolic path name NAME. If no name is given,
4342 4342 show definition of all available names.
4343 4343
4344 4344 Option -q/--quiet suppresses all output when searching for NAME
4345 4345 and shows only the path names when listing all definitions.
4346 4346
4347 4347 Path names are defined in the [paths] section of your
4348 4348 configuration file and in ``/etc/mercurial/hgrc``. If run inside a
4349 4349 repository, ``.hg/hgrc`` is used, too.
4350 4350
4351 4351 The path names ``default`` and ``default-push`` have a special
4352 4352 meaning. When performing a push or pull operation, they are used
4353 4353 as fallbacks if no location is specified on the command-line.
4354 4354 When ``default-push`` is set, it will be used for push and
4355 4355 ``default`` will be used for pull; otherwise ``default`` is used
4356 4356 as the fallback for both. When cloning a repository, the clone
4357 4357 source is written as ``default`` in ``.hg/hgrc``. Note that
4358 4358 ``default`` and ``default-push`` apply to all inbound (e.g.
4359 4359 :hg:`incoming`) and outbound (e.g. :hg:`outgoing`, :hg:`email` and
4360 4360 :hg:`bundle`) operations.
4361 4361
4362 4362 See :hg:`help urls` for more information.
4363 4363
4364 4364 Returns 0 on success.
4365 4365 """
4366 4366 if search:
4367 4367 for name, path in ui.configitems("paths"):
4368 4368 if name == search:
4369 4369 ui.status("%s\n" % util.hidepassword(path))
4370 4370 return
4371 4371 if not ui.quiet:
4372 4372 ui.warn(_("not found!\n"))
4373 4373 return 1
4374 4374 else:
4375 4375 for name, path in ui.configitems("paths"):
4376 4376 if ui.quiet:
4377 4377 ui.write("%s\n" % name)
4378 4378 else:
4379 4379 ui.write("%s = %s\n" % (name, util.hidepassword(path)))
4380 4380
4381 4381 @command('phase',
4382 4382 [('p', 'public', False, _('set changeset phase to public')),
4383 4383 ('d', 'draft', False, _('set changeset phase to draft')),
4384 4384 ('s', 'secret', False, _('set changeset phase to secret')),
4385 4385 ('f', 'force', False, _('allow to move boundary backward')),
4386 4386 ('r', 'rev', [], _('target revision'), _('REV')),
4387 4387 ],
4388 4388 _('[-p|-d|-s] [-f] [-r] REV...'))
4389 4389 def phase(ui, repo, *revs, **opts):
4390 4390 """set or show the current phase name
4391 4391
4392 4392 With no argument, show the phase name of specified revisions.
4393 4393
4394 4394 With one of -p/--public, -d/--draft or -s/--secret, change the
4395 4395 phase value of the specified revisions.
4396 4396
4397 4397 Unless -f/--force is specified, :hg:`phase` won't move changeset from a
4398 4398 lower phase to an higher phase. Phases are ordered as follows::
4399 4399
4400 4400 public < draft < secret
4401 4401
4402 4402 Return 0 on success, 1 if no phases were changed or some could not
4403 4403 be changed.
4404 4404 """
4405 4405 # search for a unique phase argument
4406 4406 targetphase = None
4407 4407 for idx, name in enumerate(phases.phasenames):
4408 4408 if opts[name]:
4409 4409 if targetphase is not None:
4410 4410 raise util.Abort(_('only one phase can be specified'))
4411 4411 targetphase = idx
4412 4412
4413 4413 # look for specified revision
4414 4414 revs = list(revs)
4415 4415 revs.extend(opts['rev'])
4416 4416 if not revs:
4417 4417 raise util.Abort(_('no revisions specified'))
4418 4418
4419 4419 revs = scmutil.revrange(repo, revs)
4420 4420
4421 4421 lock = None
4422 4422 ret = 0
4423 4423 if targetphase is None:
4424 4424 # display
4425 4425 for r in revs:
4426 4426 ctx = repo[r]
4427 4427 ui.write('%i: %s\n' % (ctx.rev(), ctx.phasestr()))
4428 4428 else:
4429 4429 lock = repo.lock()
4430 4430 try:
4431 4431 # set phase
4432 4432 if not revs:
4433 4433 raise util.Abort(_('empty revision set'))
4434 4434 nodes = [repo[r].node() for r in revs]
4435 4435 olddata = repo._phasecache.getphaserevs(repo)[:]
4436 4436 phases.advanceboundary(repo, targetphase, nodes)
4437 4437 if opts['force']:
4438 4438 phases.retractboundary(repo, targetphase, nodes)
4439 4439 finally:
4440 4440 lock.release()
4441 4441 # moving revision from public to draft may hide them
4442 4442 # We have to check result on an unfiltered repository
4443 4443 unfi = repo.unfiltered()
4444 4444 newdata = repo._phasecache.getphaserevs(unfi)
4445 4445 changes = sum(o != newdata[i] for i, o in enumerate(olddata))
4446 4446 cl = unfi.changelog
4447 4447 rejected = [n for n in nodes
4448 4448 if newdata[cl.rev(n)] < targetphase]
4449 4449 if rejected:
4450 4450 ui.warn(_('cannot move %i changesets to a more permissive '
4451 4451 'phase, use --force\n') % len(rejected))
4452 4452 ret = 1
4453 4453 if changes:
4454 4454 msg = _('phase changed for %i changesets\n') % changes
4455 4455 if ret:
4456 4456 ui.status(msg)
4457 4457 else:
4458 4458 ui.note(msg)
4459 4459 else:
4460 4460 ui.warn(_('no phases changed\n'))
4461 4461 ret = 1
4462 4462 return ret
4463 4463
4464 4464 def postincoming(ui, repo, modheads, optupdate, checkout):
4465 4465 if modheads == 0:
4466 4466 return
4467 4467 if optupdate:
4468 4468 movemarkfrom = repo['.'].node()
4469 4469 try:
4470 4470 ret = hg.update(repo, checkout)
4471 4471 except util.Abort, inst:
4472 4472 ui.warn(_("not updating: %s\n") % str(inst))
4473 4473 return 0
4474 4474 if not ret and not checkout:
4475 4475 if bookmarks.update(repo, [movemarkfrom], repo['.'].node()):
4476 4476 ui.status(_("updating bookmark %s\n") % repo._bookmarkcurrent)
4477 4477 return ret
4478 4478 if modheads > 1:
4479 4479 currentbranchheads = len(repo.branchheads())
4480 4480 if currentbranchheads == modheads:
4481 4481 ui.status(_("(run 'hg heads' to see heads, 'hg merge' to merge)\n"))
4482 4482 elif currentbranchheads > 1:
4483 4483 ui.status(_("(run 'hg heads .' to see heads, 'hg merge' to "
4484 4484 "merge)\n"))
4485 4485 else:
4486 4486 ui.status(_("(run 'hg heads' to see heads)\n"))
4487 4487 else:
4488 4488 ui.status(_("(run 'hg update' to get a working copy)\n"))
4489 4489
4490 4490 @command('^pull',
4491 4491 [('u', 'update', None,
4492 4492 _('update to new branch head if changesets were pulled')),
4493 4493 ('f', 'force', None, _('run even when remote repository is unrelated')),
4494 4494 ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
4495 4495 ('B', 'bookmark', [], _("bookmark to pull"), _('BOOKMARK')),
4496 4496 ('b', 'branch', [], _('a specific branch you would like to pull'),
4497 4497 _('BRANCH')),
4498 4498 ] + remoteopts,
4499 4499 _('[-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]'))
4500 4500 def pull(ui, repo, source="default", **opts):
4501 4501 """pull changes from the specified source
4502 4502
4503 4503 Pull changes from a remote repository to a local one.
4504 4504
4505 4505 This finds all changes from the repository at the specified path
4506 4506 or URL and adds them to a local repository (the current one unless
4507 4507 -R is specified). By default, this does not update the copy of the
4508 4508 project in the working directory.
4509 4509
4510 4510 Use :hg:`incoming` if you want to see what would have been added
4511 4511 by a pull at the time you issued this command. If you then decide
4512 4512 to add those changes to the repository, you should use :hg:`pull
4513 4513 -r X` where ``X`` is the last changeset listed by :hg:`incoming`.
4514 4514
4515 4515 If SOURCE is omitted, the 'default' path will be used.
4516 4516 See :hg:`help urls` for more information.
4517 4517
4518 4518 Returns 0 on success, 1 if an update had unresolved files.
4519 4519 """
4520 4520 source, branches = hg.parseurl(ui.expandpath(source), opts.get('branch'))
4521 4521 other = hg.peer(repo, opts, source)
4522 4522 ui.status(_('pulling from %s\n') % util.hidepassword(source))
4523 4523 revs, checkout = hg.addbranchrevs(repo, other, branches, opts.get('rev'))
4524 4524
4525 4525 remotebookmarks = other.listkeys('bookmarks')
4526 4526
4527 4527 if opts.get('bookmark'):
4528 4528 if not revs:
4529 4529 revs = []
4530 4530 for b in opts['bookmark']:
4531 4531 if b not in remotebookmarks:
4532 4532 raise util.Abort(_('remote bookmark %s not found!') % b)
4533 4533 revs.append(remotebookmarks[b])
4534 4534
4535 4535 if revs:
4536 4536 try:
4537 4537 revs = [other.lookup(rev) for rev in revs]
4538 4538 except error.CapabilityError:
4539 4539 err = _("other repository doesn't support revision lookup, "
4540 4540 "so a rev cannot be specified.")
4541 4541 raise util.Abort(err)
4542 4542
4543 4543 modheads = repo.pull(other, heads=revs, force=opts.get('force'))
4544 4544 bookmarks.updatefromremote(ui, repo, remotebookmarks, source)
4545 4545 if checkout:
4546 4546 checkout = str(repo.changelog.rev(other.lookup(checkout)))
4547 4547 repo._subtoppath = source
4548 4548 try:
4549 4549 ret = postincoming(ui, repo, modheads, opts.get('update'), checkout)
4550 4550
4551 4551 finally:
4552 4552 del repo._subtoppath
4553 4553
4554 4554 # update specified bookmarks
4555 4555 if opts.get('bookmark'):
4556 4556 marks = repo._bookmarks
4557 4557 for b in opts['bookmark']:
4558 4558 # explicit pull overrides local bookmark if any
4559 4559 ui.status(_("importing bookmark %s\n") % b)
4560 4560 marks[b] = repo[remotebookmarks[b]].node()
4561 4561 marks.write()
4562 4562
4563 4563 return ret
4564 4564
4565 4565 @command('^push',
4566 4566 [('f', 'force', None, _('force push')),
4567 4567 ('r', 'rev', [],
4568 4568 _('a changeset intended to be included in the destination'),
4569 4569 _('REV')),
4570 4570 ('B', 'bookmark', [], _("bookmark to push"), _('BOOKMARK')),
4571 4571 ('b', 'branch', [],
4572 4572 _('a specific branch you would like to push'), _('BRANCH')),
4573 4573 ('', 'new-branch', False, _('allow pushing a new branch')),
4574 4574 ] + remoteopts,
4575 4575 _('[-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]'))
4576 4576 def push(ui, repo, dest=None, **opts):
4577 4577 """push changes to the specified destination
4578 4578
4579 4579 Push changesets from the local repository to the specified
4580 4580 destination.
4581 4581
4582 4582 This operation is symmetrical to pull: it is identical to a pull
4583 4583 in the destination repository from the current one.
4584 4584
4585 4585 By default, push will not allow creation of new heads at the
4586 4586 destination, since multiple heads would make it unclear which head
4587 4587 to use. In this situation, it is recommended to pull and merge
4588 4588 before pushing.
4589 4589
4590 4590 Use --new-branch if you want to allow push to create a new named
4591 4591 branch that is not present at the destination. This allows you to
4592 4592 only create a new branch without forcing other changes.
4593 4593
4594 4594 Use -f/--force to override the default behavior and push all
4595 4595 changesets on all branches.
4596 4596
4597 4597 If -r/--rev is used, the specified revision and all its ancestors
4598 4598 will be pushed to the remote repository.
4599 4599
4600 4600 If -B/--bookmark is used, the specified bookmarked revision, its
4601 4601 ancestors, and the bookmark will be pushed to the remote
4602 4602 repository.
4603 4603
4604 4604 Please see :hg:`help urls` for important details about ``ssh://``
4605 4605 URLs. If DESTINATION is omitted, a default path will be used.
4606 4606
4607 4607 Returns 0 if push was successful, 1 if nothing to push.
4608 4608 """
4609 4609
4610 4610 if opts.get('bookmark'):
4611 4611 for b in opts['bookmark']:
4612 4612 # translate -B options to -r so changesets get pushed
4613 4613 if b in repo._bookmarks:
4614 4614 opts.setdefault('rev', []).append(b)
4615 4615 else:
4616 4616 # if we try to push a deleted bookmark, translate it to null
4617 4617 # this lets simultaneous -r, -b options continue working
4618 4618 opts.setdefault('rev', []).append("null")
4619 4619
4620 4620 dest = ui.expandpath(dest or 'default-push', dest or 'default')
4621 4621 dest, branches = hg.parseurl(dest, opts.get('branch'))
4622 4622 ui.status(_('pushing to %s\n') % util.hidepassword(dest))
4623 4623 revs, checkout = hg.addbranchrevs(repo, repo, branches, opts.get('rev'))
4624 4624 other = hg.peer(repo, opts, dest)
4625 4625 if revs:
4626 4626 revs = [repo.lookup(r) for r in scmutil.revrange(repo, revs)]
4627 4627
4628 4628 repo._subtoppath = dest
4629 4629 try:
4630 4630 # push subrepos depth-first for coherent ordering
4631 4631 c = repo['']
4632 4632 subs = c.substate # only repos that are committed
4633 4633 for s in sorted(subs):
4634 4634 if c.sub(s).push(opts) == 0:
4635 4635 return False
4636 4636 finally:
4637 4637 del repo._subtoppath
4638 4638 result = repo.push(other, opts.get('force'), revs=revs,
4639 4639 newbranch=opts.get('new_branch'))
4640 4640
4641 4641 result = not result
4642 4642
4643 4643 if opts.get('bookmark'):
4644 4644 rb = other.listkeys('bookmarks')
4645 4645 for b in opts['bookmark']:
4646 4646 # explicit push overrides remote bookmark if any
4647 4647 if b in repo._bookmarks:
4648 4648 ui.status(_("exporting bookmark %s\n") % b)
4649 4649 new = repo[b].hex()
4650 4650 elif b in rb:
4651 4651 ui.status(_("deleting remote bookmark %s\n") % b)
4652 4652 new = '' # delete
4653 4653 else:
4654 4654 ui.warn(_('bookmark %s does not exist on the local '
4655 4655 'or remote repository!\n') % b)
4656 4656 return 2
4657 4657 old = rb.get(b, '')
4658 4658 r = other.pushkey('bookmarks', b, old, new)
4659 4659 if not r:
4660 4660 ui.warn(_('updating bookmark %s failed!\n') % b)
4661 4661 if not result:
4662 4662 result = 2
4663 4663
4664 4664 return result
4665 4665
4666 4666 @command('recover', [])
4667 4667 def recover(ui, repo):
4668 4668 """roll back an interrupted transaction
4669 4669
4670 4670 Recover from an interrupted commit or pull.
4671 4671
4672 4672 This command tries to fix the repository status after an
4673 4673 interrupted operation. It should only be necessary when Mercurial
4674 4674 suggests it.
4675 4675
4676 4676 Returns 0 if successful, 1 if nothing to recover or verify fails.
4677 4677 """
4678 4678 if repo.recover():
4679 4679 return hg.verify(repo)
4680 4680 return 1
4681 4681
4682 4682 @command('^remove|rm',
4683 4683 [('A', 'after', None, _('record delete for missing files')),
4684 4684 ('f', 'force', None,
4685 4685 _('remove (and delete) file even if added or modified')),
4686 4686 ] + walkopts,
4687 4687 _('[OPTION]... FILE...'))
4688 4688 def remove(ui, repo, *pats, **opts):
4689 4689 """remove the specified files on the next commit
4690 4690
4691 4691 Schedule the indicated files for removal from the current branch.
4692 4692
4693 4693 This command schedules the files to be removed at the next commit.
4694 4694 To undo a remove before that, see :hg:`revert`. To undo added
4695 4695 files, see :hg:`forget`.
4696 4696
4697 4697 .. container:: verbose
4698 4698
4699 4699 -A/--after can be used to remove only files that have already
4700 4700 been deleted, -f/--force can be used to force deletion, and -Af
4701 4701 can be used to remove files from the next revision without
4702 4702 deleting them from the working directory.
4703 4703
4704 4704 The following table details the behavior of remove for different
4705 4705 file states (columns) and option combinations (rows). The file
4706 4706 states are Added [A], Clean [C], Modified [M] and Missing [!]
4707 4707 (as reported by :hg:`status`). The actions are Warn, Remove
4708 4708 (from branch) and Delete (from disk):
4709 4709
4710 4710 ======= == == == ==
4711 4711 A C M !
4712 4712 ======= == == == ==
4713 4713 none W RD W R
4714 4714 -f R RD RD R
4715 4715 -A W W W R
4716 4716 -Af R R R R
4717 4717 ======= == == == ==
4718 4718
4719 4719 Note that remove never deletes files in Added [A] state from the
4720 4720 working directory, not even if option --force is specified.
4721 4721
4722 4722 Returns 0 on success, 1 if any warnings encountered.
4723 4723 """
4724 4724
4725 4725 ret = 0
4726 4726 after, force = opts.get('after'), opts.get('force')
4727 4727 if not pats and not after:
4728 4728 raise util.Abort(_('no files specified'))
4729 4729
4730 4730 m = scmutil.match(repo[None], pats, opts)
4731 4731 s = repo.status(match=m, clean=True)
4732 4732 modified, added, deleted, clean = s[0], s[1], s[3], s[6]
4733 4733
4734 4734 # warn about failure to delete explicit files/dirs
4735 4735 wctx = repo[None]
4736 4736 for f in m.files():
4737 4737 if f in repo.dirstate or f in wctx.dirs():
4738 4738 continue
4739 4739 if os.path.exists(m.rel(f)):
4740 4740 if os.path.isdir(m.rel(f)):
4741 4741 ui.warn(_('not removing %s: no tracked files\n') % m.rel(f))
4742 4742 else:
4743 4743 ui.warn(_('not removing %s: file is untracked\n') % m.rel(f))
4744 4744 # missing files will generate a warning elsewhere
4745 4745 ret = 1
4746 4746
4747 4747 if force:
4748 4748 list = modified + deleted + clean + added
4749 4749 elif after:
4750 4750 list = deleted
4751 4751 for f in modified + added + clean:
4752 4752 ui.warn(_('not removing %s: file still exists\n') % m.rel(f))
4753 4753 ret = 1
4754 4754 else:
4755 4755 list = deleted + clean
4756 4756 for f in modified:
4757 4757 ui.warn(_('not removing %s: file is modified (use -f'
4758 4758 ' to force removal)\n') % m.rel(f))
4759 4759 ret = 1
4760 4760 for f in added:
4761 4761 ui.warn(_('not removing %s: file has been marked for add'
4762 4762 ' (use forget to undo)\n') % m.rel(f))
4763 4763 ret = 1
4764 4764
4765 4765 for f in sorted(list):
4766 4766 if ui.verbose or not m.exact(f):
4767 4767 ui.status(_('removing %s\n') % m.rel(f))
4768 4768
4769 4769 wlock = repo.wlock()
4770 4770 try:
4771 4771 if not after:
4772 4772 for f in list:
4773 4773 if f in added:
4774 4774 continue # we never unlink added files on remove
4775 4775 util.unlinkpath(repo.wjoin(f), ignoremissing=True)
4776 4776 repo[None].forget(list)
4777 4777 finally:
4778 4778 wlock.release()
4779 4779
4780 4780 return ret
4781 4781
4782 4782 @command('rename|move|mv',
4783 4783 [('A', 'after', None, _('record a rename that has already occurred')),
4784 4784 ('f', 'force', None, _('forcibly copy over an existing managed file')),
4785 4785 ] + walkopts + dryrunopts,
4786 4786 _('[OPTION]... SOURCE... DEST'))
4787 4787 def rename(ui, repo, *pats, **opts):
4788 4788 """rename files; equivalent of copy + remove
4789 4789
4790 4790 Mark dest as copies of sources; mark sources for deletion. If dest
4791 4791 is a directory, copies are put in that directory. If dest is a
4792 4792 file, there can only be one source.
4793 4793
4794 4794 By default, this command copies the contents of files as they
4795 4795 exist in the working directory. If invoked with -A/--after, the
4796 4796 operation is recorded, but no copying is performed.
4797 4797
4798 4798 This command takes effect at the next commit. To undo a rename
4799 4799 before that, see :hg:`revert`.
4800 4800
4801 4801 Returns 0 on success, 1 if errors are encountered.
4802 4802 """
4803 4803 wlock = repo.wlock(False)
4804 4804 try:
4805 4805 return cmdutil.copy(ui, repo, pats, opts, rename=True)
4806 4806 finally:
4807 4807 wlock.release()
4808 4808
4809 4809 @command('resolve',
4810 4810 [('a', 'all', None, _('select all unresolved files')),
4811 4811 ('l', 'list', None, _('list state of files needing merge')),
4812 4812 ('m', 'mark', None, _('mark files as resolved')),
4813 4813 ('u', 'unmark', None, _('mark files as unresolved')),
4814 4814 ('n', 'no-status', None, _('hide status prefix'))]
4815 4815 + mergetoolopts + walkopts,
4816 4816 _('[OPTION]... [FILE]...'))
4817 4817 def resolve(ui, repo, *pats, **opts):
4818 4818 """redo merges or set/view the merge status of files
4819 4819
4820 4820 Merges with unresolved conflicts are often the result of
4821 4821 non-interactive merging using the ``internal:merge`` configuration
4822 4822 setting, or a command-line merge tool like ``diff3``. The resolve
4823 4823 command is used to manage the files involved in a merge, after
4824 4824 :hg:`merge` has been run, and before :hg:`commit` is run (i.e. the
4825 4825 working directory must have two parents). See :hg:`help
4826 4826 merge-tools` for information on configuring merge tools.
4827 4827
4828 4828 The resolve command can be used in the following ways:
4829 4829
4830 4830 - :hg:`resolve [--tool TOOL] FILE...`: attempt to re-merge the specified
4831 4831 files, discarding any previous merge attempts. Re-merging is not
4832 4832 performed for files already marked as resolved. Use ``--all/-a``
4833 4833 to select all unresolved files. ``--tool`` can be used to specify
4834 4834 the merge tool used for the given files. It overrides the HGMERGE
4835 4835 environment variable and your configuration files. Previous file
4836 4836 contents are saved with a ``.orig`` suffix.
4837 4837
4838 4838 - :hg:`resolve -m [FILE]`: mark a file as having been resolved
4839 4839 (e.g. after having manually fixed-up the files). The default is
4840 4840 to mark all unresolved files.
4841 4841
4842 4842 - :hg:`resolve -u [FILE]...`: mark a file as unresolved. The
4843 4843 default is to mark all resolved files.
4844 4844
4845 4845 - :hg:`resolve -l`: list files which had or still have conflicts.
4846 4846 In the printed list, ``U`` = unresolved and ``R`` = resolved.
4847 4847
4848 4848 Note that Mercurial will not let you commit files with unresolved
4849 4849 merge conflicts. You must use :hg:`resolve -m ...` before you can
4850 4850 commit after a conflicting merge.
4851 4851
4852 4852 Returns 0 on success, 1 if any files fail a resolve attempt.
4853 4853 """
4854 4854
4855 4855 all, mark, unmark, show, nostatus = \
4856 4856 [opts.get(o) for o in 'all mark unmark list no_status'.split()]
4857 4857
4858 4858 if (show and (mark or unmark)) or (mark and unmark):
4859 4859 raise util.Abort(_("too many options specified"))
4860 4860 if pats and all:
4861 4861 raise util.Abort(_("can't specify --all and patterns"))
4862 4862 if not (all or pats or show or mark or unmark):
4863 4863 raise util.Abort(_('no files or directories specified; '
4864 4864 'use --all to remerge all files'))
4865 4865
4866 4866 ms = mergemod.mergestate(repo)
4867 4867 m = scmutil.match(repo[None], pats, opts)
4868 4868 ret = 0
4869 4869
4870 4870 for f in ms:
4871 4871 if m(f):
4872 4872 if show:
4873 4873 if nostatus:
4874 4874 ui.write("%s\n" % f)
4875 4875 else:
4876 4876 ui.write("%s %s\n" % (ms[f].upper(), f),
4877 4877 label='resolve.' +
4878 4878 {'u': 'unresolved', 'r': 'resolved'}[ms[f]])
4879 4879 elif mark:
4880 4880 ms.mark(f, "r")
4881 4881 elif unmark:
4882 4882 ms.mark(f, "u")
4883 4883 else:
4884 4884 wctx = repo[None]
4885 4885 mctx = wctx.parents()[-1]
4886 4886
4887 4887 # backup pre-resolve (merge uses .orig for its own purposes)
4888 4888 a = repo.wjoin(f)
4889 4889 util.copyfile(a, a + ".resolve")
4890 4890
4891 4891 try:
4892 4892 # resolve file
4893 4893 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''))
4894 4894 if ms.resolve(f, wctx, mctx):
4895 4895 ret = 1
4896 4896 finally:
4897 4897 ui.setconfig('ui', 'forcemerge', '')
4898 4898 ms.commit()
4899 4899
4900 4900 # replace filemerge's .orig file with our resolve file
4901 4901 util.rename(a + ".resolve", a + ".orig")
4902 4902
4903 4903 ms.commit()
4904 4904 return ret
4905 4905
4906 4906 @command('revert',
4907 4907 [('a', 'all', None, _('revert all changes when no arguments given')),
4908 4908 ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
4909 4909 ('r', 'rev', '', _('revert to the specified revision'), _('REV')),
4910 4910 ('C', 'no-backup', None, _('do not save backup copies of files')),
4911 4911 ] + walkopts + dryrunopts,
4912 4912 _('[OPTION]... [-r REV] [NAME]...'))
4913 4913 def revert(ui, repo, *pats, **opts):
4914 4914 """restore files to their checkout state
4915 4915
4916 4916 .. note::
4917 4917
4918 4918 To check out earlier revisions, you should use :hg:`update REV`.
4919 4919 To cancel an uncommitted merge (and lose your changes), use
4920 4920 :hg:`update --clean .`.
4921 4921
4922 4922 With no revision specified, revert the specified files or directories
4923 4923 to the contents they had in the parent of the working directory.
4924 4924 This restores the contents of files to an unmodified
4925 4925 state and unschedules adds, removes, copies, and renames. If the
4926 4926 working directory has two parents, you must explicitly specify a
4927 4927 revision.
4928 4928
4929 4929 Using the -r/--rev or -d/--date options, revert the given files or
4930 4930 directories to their states as of a specific revision. Because
4931 4931 revert does not change the working directory parents, this will
4932 4932 cause these files to appear modified. This can be helpful to "back
4933 4933 out" some or all of an earlier change. See :hg:`backout` for a
4934 4934 related method.
4935 4935
4936 4936 Modified files are saved with a .orig suffix before reverting.
4937 4937 To disable these backups, use --no-backup.
4938 4938
4939 4939 See :hg:`help dates` for a list of formats valid for -d/--date.
4940 4940
4941 4941 Returns 0 on success.
4942 4942 """
4943 4943
4944 4944 if opts.get("date"):
4945 4945 if opts.get("rev"):
4946 4946 raise util.Abort(_("you can't specify a revision and a date"))
4947 4947 opts["rev"] = cmdutil.finddate(ui, repo, opts["date"])
4948 4948
4949 4949 parent, p2 = repo.dirstate.parents()
4950 4950 if not opts.get('rev') and p2 != nullid:
4951 4951 # revert after merge is a trap for new users (issue2915)
4952 4952 raise util.Abort(_('uncommitted merge with no revision specified'),
4953 4953 hint=_('use "hg update" or see "hg help revert"'))
4954 4954
4955 4955 ctx = scmutil.revsingle(repo, opts.get('rev'))
4956 4956
4957 4957 if not pats and not opts.get('all'):
4958 4958 msg = _("no files or directories specified")
4959 4959 if p2 != nullid:
4960 4960 hint = _("uncommitted merge, use --all to discard all changes,"
4961 4961 " or 'hg update -C .' to abort the merge")
4962 4962 raise util.Abort(msg, hint=hint)
4963 4963 dirty = util.any(repo.status())
4964 4964 node = ctx.node()
4965 4965 if node != parent:
4966 4966 if dirty:
4967 4967 hint = _("uncommitted changes, use --all to discard all"
4968 4968 " changes, or 'hg update %s' to update") % ctx.rev()
4969 4969 else:
4970 4970 hint = _("use --all to revert all files,"
4971 4971 " or 'hg update %s' to update") % ctx.rev()
4972 4972 elif dirty:
4973 4973 hint = _("uncommitted changes, use --all to discard all changes")
4974 4974 else:
4975 4975 hint = _("use --all to revert all files")
4976 4976 raise util.Abort(msg, hint=hint)
4977 4977
4978 4978 return cmdutil.revert(ui, repo, ctx, (parent, p2), *pats, **opts)
4979 4979
4980 4980 @command('rollback', dryrunopts +
4981 4981 [('f', 'force', False, _('ignore safety measures'))])
4982 4982 def rollback(ui, repo, **opts):
4983 4983 """roll back the last transaction (dangerous)
4984 4984
4985 4985 This command should be used with care. There is only one level of
4986 4986 rollback, and there is no way to undo a rollback. It will also
4987 4987 restore the dirstate at the time of the last transaction, losing
4988 4988 any dirstate changes since that time. This command does not alter
4989 4989 the working directory.
4990 4990
4991 4991 Transactions are used to encapsulate the effects of all commands
4992 4992 that create new changesets or propagate existing changesets into a
4993 4993 repository.
4994 4994
4995 4995 .. container:: verbose
4996 4996
4997 4997 For example, the following commands are transactional, and their
4998 4998 effects can be rolled back:
4999 4999
5000 5000 - commit
5001 5001 - import
5002 5002 - pull
5003 5003 - push (with this repository as the destination)
5004 5004 - unbundle
5005 5005
5006 5006 To avoid permanent data loss, rollback will refuse to rollback a
5007 5007 commit transaction if it isn't checked out. Use --force to
5008 5008 override this protection.
5009 5009
5010 5010 This command is not intended for use on public repositories. Once
5011 5011 changes are visible for pull by other users, rolling a transaction
5012 5012 back locally is ineffective (someone else may already have pulled
5013 5013 the changes). Furthermore, a race is possible with readers of the
5014 5014 repository; for example an in-progress pull from the repository
5015 5015 may fail if a rollback is performed.
5016 5016
5017 5017 Returns 0 on success, 1 if no rollback data is available.
5018 5018 """
5019 5019 return repo.rollback(dryrun=opts.get('dry_run'),
5020 5020 force=opts.get('force'))
5021 5021
5022 5022 @command('root', [])
5023 5023 def root(ui, repo):
5024 5024 """print the root (top) of the current working directory
5025 5025
5026 5026 Print the root directory of the current repository.
5027 5027
5028 5028 Returns 0 on success.
5029 5029 """
5030 5030 ui.write(repo.root + "\n")
5031 5031
5032 5032 @command('^serve',
5033 5033 [('A', 'accesslog', '', _('name of access log file to write to'),
5034 5034 _('FILE')),
5035 5035 ('d', 'daemon', None, _('run server in background')),
5036 5036 ('', 'daemon-pipefds', '', _('used internally by daemon mode'), _('NUM')),
5037 5037 ('E', 'errorlog', '', _('name of error log file to write to'), _('FILE')),
5038 5038 # use string type, then we can check if something was passed
5039 5039 ('p', 'port', '', _('port to listen on (default: 8000)'), _('PORT')),
5040 5040 ('a', 'address', '', _('address to listen on (default: all interfaces)'),
5041 5041 _('ADDR')),
5042 5042 ('', 'prefix', '', _('prefix path to serve from (default: server root)'),
5043 5043 _('PREFIX')),
5044 5044 ('n', 'name', '',
5045 5045 _('name to show in web pages (default: working directory)'), _('NAME')),
5046 5046 ('', 'web-conf', '',
5047 5047 _('name of the hgweb config file (see "hg help hgweb")'), _('FILE')),
5048 5048 ('', 'webdir-conf', '', _('name of the hgweb config file (DEPRECATED)'),
5049 5049 _('FILE')),
5050 5050 ('', 'pid-file', '', _('name of file to write process ID to'), _('FILE')),
5051 5051 ('', 'stdio', None, _('for remote clients')),
5052 5052 ('', 'cmdserver', '', _('for remote clients'), _('MODE')),
5053 5053 ('t', 'templates', '', _('web templates to use'), _('TEMPLATE')),
5054 5054 ('', 'style', '', _('template style to use'), _('STYLE')),
5055 5055 ('6', 'ipv6', None, _('use IPv6 in addition to IPv4')),
5056 5056 ('', 'certificate', '', _('SSL certificate file'), _('FILE'))],
5057 5057 _('[OPTION]...'))
5058 5058 def serve(ui, repo, **opts):
5059 5059 """start stand-alone webserver
5060 5060
5061 5061 Start a local HTTP repository browser and pull server. You can use
5062 5062 this for ad-hoc sharing and browsing of repositories. It is
5063 5063 recommended to use a real web server to serve a repository for
5064 5064 longer periods of time.
5065 5065
5066 5066 Please note that the server does not implement access control.
5067 5067 This means that, by default, anybody can read from the server and
5068 5068 nobody can write to it by default. Set the ``web.allow_push``
5069 5069 option to ``*`` to allow everybody to push to the server. You
5070 5070 should use a real web server if you need to authenticate users.
5071 5071
5072 5072 By default, the server logs accesses to stdout and errors to
5073 5073 stderr. Use the -A/--accesslog and -E/--errorlog options to log to
5074 5074 files.
5075 5075
5076 5076 To have the server choose a free port number to listen on, specify
5077 5077 a port number of 0; in this case, the server will print the port
5078 5078 number it uses.
5079 5079
5080 5080 Returns 0 on success.
5081 5081 """
5082 5082
5083 5083 if opts["stdio"] and opts["cmdserver"]:
5084 5084 raise util.Abort(_("cannot use --stdio with --cmdserver"))
5085 5085
5086 5086 def checkrepo():
5087 5087 if repo is None:
5088 5088 raise error.RepoError(_("there is no Mercurial repository here"
5089 5089 " (.hg not found)"))
5090 5090
5091 5091 if opts["stdio"]:
5092 5092 checkrepo()
5093 5093 s = sshserver.sshserver(ui, repo)
5094 5094 s.serve_forever()
5095 5095
5096 5096 if opts["cmdserver"]:
5097 5097 checkrepo()
5098 5098 s = commandserver.server(ui, repo, opts["cmdserver"])
5099 5099 return s.serve()
5100 5100
5101 5101 # this way we can check if something was given in the command-line
5102 5102 if opts.get('port'):
5103 5103 opts['port'] = util.getport(opts.get('port'))
5104 5104
5105 5105 baseui = repo and repo.baseui or ui
5106 5106 optlist = ("name templates style address port prefix ipv6"
5107 5107 " accesslog errorlog certificate encoding")
5108 5108 for o in optlist.split():
5109 5109 val = opts.get(o, '')
5110 5110 if val in (None, ''): # should check against default options instead
5111 5111 continue
5112 5112 baseui.setconfig("web", o, val)
5113 5113 if repo and repo.ui != baseui:
5114 5114 repo.ui.setconfig("web", o, val)
5115 5115
5116 5116 o = opts.get('web_conf') or opts.get('webdir_conf')
5117 5117 if not o:
5118 5118 if not repo:
5119 5119 raise error.RepoError(_("there is no Mercurial repository"
5120 5120 " here (.hg not found)"))
5121 5121 o = repo
5122 5122
5123 5123 app = hgweb.hgweb(o, baseui=baseui)
5124 5124
5125 5125 class service(object):
5126 5126 def init(self):
5127 5127 util.setsignalhandler()
5128 5128 self.httpd = hgweb.server.create_server(ui, app)
5129 5129
5130 5130 if opts['port'] and not ui.verbose:
5131 5131 return
5132 5132
5133 5133 if self.httpd.prefix:
5134 5134 prefix = self.httpd.prefix.strip('/') + '/'
5135 5135 else:
5136 5136 prefix = ''
5137 5137
5138 5138 port = ':%d' % self.httpd.port
5139 5139 if port == ':80':
5140 5140 port = ''
5141 5141
5142 5142 bindaddr = self.httpd.addr
5143 5143 if bindaddr == '0.0.0.0':
5144 5144 bindaddr = '*'
5145 5145 elif ':' in bindaddr: # IPv6
5146 5146 bindaddr = '[%s]' % bindaddr
5147 5147
5148 5148 fqaddr = self.httpd.fqaddr
5149 5149 if ':' in fqaddr:
5150 5150 fqaddr = '[%s]' % fqaddr
5151 5151 if opts['port']:
5152 5152 write = ui.status
5153 5153 else:
5154 5154 write = ui.write
5155 5155 write(_('listening at http://%s%s/%s (bound to %s:%d)\n') %
5156 5156 (fqaddr, port, prefix, bindaddr, self.httpd.port))
5157 5157
5158 5158 def run(self):
5159 5159 self.httpd.serve_forever()
5160 5160
5161 5161 service = service()
5162 5162
5163 5163 cmdutil.service(opts, initfn=service.init, runfn=service.run)
5164 5164
5165 5165 @command('showconfig|debugconfig',
5166 5166 [('u', 'untrusted', None, _('show untrusted configuration options'))],
5167 5167 _('[-u] [NAME]...'))
5168 5168 def showconfig(ui, repo, *values, **opts):
5169 5169 """show combined config settings from all hgrc files
5170 5170
5171 5171 With no arguments, print names and values of all config items.
5172 5172
5173 5173 With one argument of the form section.name, print just the value
5174 5174 of that config item.
5175 5175
5176 5176 With multiple arguments, print names and values of all config
5177 5177 items with matching section names.
5178 5178
5179 5179 With --debug, the source (filename and line number) is printed
5180 5180 for each config item.
5181 5181
5182 5182 Returns 0 on success.
5183 5183 """
5184 5184
5185 5185 for f in scmutil.rcpath():
5186 5186 ui.debug('read config from: %s\n' % f)
5187 5187 untrusted = bool(opts.get('untrusted'))
5188 5188 if values:
5189 5189 sections = [v for v in values if '.' not in v]
5190 5190 items = [v for v in values if '.' in v]
5191 5191 if len(items) > 1 or items and sections:
5192 5192 raise util.Abort(_('only one config item permitted'))
5193 5193 for section, name, value in ui.walkconfig(untrusted=untrusted):
5194 5194 value = str(value).replace('\n', '\\n')
5195 5195 sectname = section + '.' + name
5196 5196 if values:
5197 5197 for v in values:
5198 5198 if v == section:
5199 5199 ui.debug('%s: ' %
5200 5200 ui.configsource(section, name, untrusted))
5201 5201 ui.write('%s=%s\n' % (sectname, value))
5202 5202 elif v == sectname:
5203 5203 ui.debug('%s: ' %
5204 5204 ui.configsource(section, name, untrusted))
5205 5205 ui.write(value, '\n')
5206 5206 else:
5207 5207 ui.debug('%s: ' %
5208 5208 ui.configsource(section, name, untrusted))
5209 5209 ui.write('%s=%s\n' % (sectname, value))
5210 5210
5211 5211 @command('^status|st',
5212 5212 [('A', 'all', None, _('show status of all files')),
5213 5213 ('m', 'modified', None, _('show only modified files')),
5214 5214 ('a', 'added', None, _('show only added files')),
5215 5215 ('r', 'removed', None, _('show only removed files')),
5216 5216 ('d', 'deleted', None, _('show only deleted (but tracked) files')),
5217 5217 ('c', 'clean', None, _('show only files without changes')),
5218 5218 ('u', 'unknown', None, _('show only unknown (not tracked) files')),
5219 5219 ('i', 'ignored', None, _('show only ignored files')),
5220 5220 ('n', 'no-status', None, _('hide status prefix')),
5221 5221 ('C', 'copies', None, _('show source of copied files')),
5222 5222 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
5223 5223 ('', 'rev', [], _('show difference from revision'), _('REV')),
5224 5224 ('', 'change', '', _('list the changed files of a revision'), _('REV')),
5225 5225 ] + walkopts + subrepoopts,
5226 5226 _('[OPTION]... [FILE]...'))
5227 5227 def status(ui, repo, *pats, **opts):
5228 5228 """show changed files in the working directory
5229 5229
5230 5230 Show status of files in the repository. If names are given, only
5231 5231 files that match are shown. Files that are clean or ignored or
5232 5232 the source of a copy/move operation, are not listed unless
5233 5233 -c/--clean, -i/--ignored, -C/--copies or -A/--all are given.
5234 5234 Unless options described with "show only ..." are given, the
5235 5235 options -mardu are used.
5236 5236
5237 5237 Option -q/--quiet hides untracked (unknown and ignored) files
5238 5238 unless explicitly requested with -u/--unknown or -i/--ignored.
5239 5239
5240 5240 .. note::
5241 5241 status may appear to disagree with diff if permissions have
5242 5242 changed or a merge has occurred. The standard diff format does
5243 5243 not report permission changes and diff only reports changes
5244 5244 relative to one merge parent.
5245 5245
5246 5246 If one revision is given, it is used as the base revision.
5247 5247 If two revisions are given, the differences between them are
5248 5248 shown. The --change option can also be used as a shortcut to list
5249 5249 the changed files of a revision from its first parent.
5250 5250
5251 5251 The codes used to show the status of files are::
5252 5252
5253 5253 M = modified
5254 5254 A = added
5255 5255 R = removed
5256 5256 C = clean
5257 5257 ! = missing (deleted by non-hg command, but still tracked)
5258 5258 ? = not tracked
5259 5259 I = ignored
5260 5260 = origin of the previous file listed as A (added)
5261 5261
5262 5262 .. container:: verbose
5263 5263
5264 5264 Examples:
5265 5265
5266 5266 - show changes in the working directory relative to a
5267 5267 changeset::
5268 5268
5269 5269 hg status --rev 9353
5270 5270
5271 5271 - show all changes including copies in an existing changeset::
5272 5272
5273 5273 hg status --copies --change 9353
5274 5274
5275 5275 - get a NUL separated list of added files, suitable for xargs::
5276 5276
5277 5277 hg status -an0
5278 5278
5279 5279 Returns 0 on success.
5280 5280 """
5281 5281
5282 5282 revs = opts.get('rev')
5283 5283 change = opts.get('change')
5284 5284
5285 5285 if revs and change:
5286 5286 msg = _('cannot specify --rev and --change at the same time')
5287 5287 raise util.Abort(msg)
5288 5288 elif change:
5289 5289 node2 = scmutil.revsingle(repo, change, None).node()
5290 5290 node1 = repo[node2].p1().node()
5291 5291 else:
5292 5292 node1, node2 = scmutil.revpair(repo, revs)
5293 5293
5294 5294 cwd = (pats and repo.getcwd()) or ''
5295 5295 end = opts.get('print0') and '\0' or '\n'
5296 5296 copy = {}
5297 5297 states = 'modified added removed deleted unknown ignored clean'.split()
5298 5298 show = [k for k in states if opts.get(k)]
5299 5299 if opts.get('all'):
5300 5300 show += ui.quiet and (states[:4] + ['clean']) or states
5301 5301 if not show:
5302 5302 show = ui.quiet and states[:4] or states[:5]
5303 5303
5304 5304 stat = repo.status(node1, node2, scmutil.match(repo[node2], pats, opts),
5305 5305 'ignored' in show, 'clean' in show, 'unknown' in show,
5306 5306 opts.get('subrepos'))
5307 5307 changestates = zip(states, 'MAR!?IC', stat)
5308 5308
5309 5309 if (opts.get('all') or opts.get('copies')) and not opts.get('no_status'):
5310 5310 copy = copies.pathcopies(repo[node1], repo[node2])
5311 5311
5312 5312 fm = ui.formatter('status', opts)
5313 5313 fmt = '%s' + end
5314 5314 showchar = not opts.get('no_status')
5315 5315
5316 5316 for state, char, files in changestates:
5317 5317 if state in show:
5318 5318 label = 'status.' + state
5319 5319 for f in files:
5320 5320 fm.startitem()
5321 5321 fm.condwrite(showchar, 'status', '%s ', char, label=label)
5322 5322 fm.write('path', fmt, repo.pathto(f, cwd), label=label)
5323 5323 if f in copy:
5324 5324 fm.write("copy", ' %s' + end, repo.pathto(copy[f], cwd),
5325 5325 label='status.copied')
5326 5326 fm.end()
5327 5327
5328 5328 @command('^summary|sum',
5329 5329 [('', 'remote', None, _('check for push and pull'))], '[--remote]')
5330 5330 def summary(ui, repo, **opts):
5331 5331 """summarize working directory state
5332 5332
5333 5333 This generates a brief summary of the working directory state,
5334 5334 including parents, branch, commit status, and available updates.
5335 5335
5336 5336 With the --remote option, this will check the default paths for
5337 5337 incoming and outgoing changes. This can be time-consuming.
5338 5338
5339 5339 Returns 0 on success.
5340 5340 """
5341 5341
5342 5342 ctx = repo[None]
5343 5343 parents = ctx.parents()
5344 5344 pnode = parents[0].node()
5345 5345 marks = []
5346 5346
5347 5347 for p in parents:
5348 5348 # label with log.changeset (instead of log.parent) since this
5349 5349 # shows a working directory parent *changeset*:
5350 5350 # i18n: column positioning for "hg summary"
5351 5351 ui.write(_('parent: %d:%s ') % (p.rev(), str(p)),
5352 5352 label='log.changeset changeset.%s' % p.phasestr())
5353 5353 ui.write(' '.join(p.tags()), label='log.tag')
5354 5354 if p.bookmarks():
5355 5355 marks.extend(p.bookmarks())
5356 5356 if p.rev() == -1:
5357 5357 if not len(repo):
5358 5358 ui.write(_(' (empty repository)'))
5359 5359 else:
5360 5360 ui.write(_(' (no revision checked out)'))
5361 5361 ui.write('\n')
5362 5362 if p.description():
5363 5363 ui.status(' ' + p.description().splitlines()[0].strip() + '\n',
5364 5364 label='log.summary')
5365 5365
5366 5366 branch = ctx.branch()
5367 5367 bheads = repo.branchheads(branch)
5368 5368 # i18n: column positioning for "hg summary"
5369 5369 m = _('branch: %s\n') % branch
5370 5370 if branch != 'default':
5371 5371 ui.write(m, label='log.branch')
5372 5372 else:
5373 5373 ui.status(m, label='log.branch')
5374 5374
5375 5375 if marks:
5376 5376 current = repo._bookmarkcurrent
5377 5377 # i18n: column positioning for "hg summary"
5378 5378 ui.write(_('bookmarks:'), label='log.bookmark')
5379 5379 if current is not None:
5380 5380 if current in marks:
5381 5381 ui.write(' *' + current, label='bookmarks.current')
5382 5382 marks.remove(current)
5383 5383 else:
5384 5384 ui.write(' [%s]' % current, label='bookmarks.current')
5385 5385 for m in marks:
5386 5386 ui.write(' ' + m, label='log.bookmark')
5387 5387 ui.write('\n', label='log.bookmark')
5388 5388
5389 5389 st = list(repo.status(unknown=True))[:6]
5390 5390
5391 5391 c = repo.dirstate.copies()
5392 5392 copied, renamed = [], []
5393 5393 for d, s in c.iteritems():
5394 5394 if s in st[2]:
5395 5395 st[2].remove(s)
5396 5396 renamed.append(d)
5397 5397 else:
5398 5398 copied.append(d)
5399 5399 if d in st[1]:
5400 5400 st[1].remove(d)
5401 5401 st.insert(3, renamed)
5402 5402 st.insert(4, copied)
5403 5403
5404 5404 ms = mergemod.mergestate(repo)
5405 5405 st.append([f for f in ms if ms[f] == 'u'])
5406 5406
5407 5407 subs = [s for s in ctx.substate if ctx.sub(s).dirty()]
5408 5408 st.append(subs)
5409 5409
5410 5410 labels = [ui.label(_('%d modified'), 'status.modified'),
5411 5411 ui.label(_('%d added'), 'status.added'),
5412 5412 ui.label(_('%d removed'), 'status.removed'),
5413 5413 ui.label(_('%d renamed'), 'status.copied'),
5414 5414 ui.label(_('%d copied'), 'status.copied'),
5415 5415 ui.label(_('%d deleted'), 'status.deleted'),
5416 5416 ui.label(_('%d unknown'), 'status.unknown'),
5417 5417 ui.label(_('%d ignored'), 'status.ignored'),
5418 5418 ui.label(_('%d unresolved'), 'resolve.unresolved'),
5419 5419 ui.label(_('%d subrepos'), 'status.modified')]
5420 5420 t = []
5421 5421 for s, l in zip(st, labels):
5422 5422 if s:
5423 5423 t.append(l % len(s))
5424 5424
5425 5425 t = ', '.join(t)
5426 5426 cleanworkdir = False
5427 5427
5428 5428 if len(parents) > 1:
5429 5429 t += _(' (merge)')
5430 5430 elif branch != parents[0].branch():
5431 5431 t += _(' (new branch)')
5432 5432 elif (parents[0].closesbranch() and
5433 5433 pnode in repo.branchheads(branch, closed=True)):
5434 5434 t += _(' (head closed)')
5435 5435 elif not (st[0] or st[1] or st[2] or st[3] or st[4] or st[9]):
5436 5436 t += _(' (clean)')
5437 5437 cleanworkdir = True
5438 5438 elif pnode not in bheads:
5439 5439 t += _(' (new branch head)')
5440 5440
5441 5441 if cleanworkdir:
5442 5442 # i18n: column positioning for "hg summary"
5443 5443 ui.status(_('commit: %s\n') % t.strip())
5444 5444 else:
5445 5445 # i18n: column positioning for "hg summary"
5446 5446 ui.write(_('commit: %s\n') % t.strip())
5447 5447
5448 5448 # all ancestors of branch heads - all ancestors of parent = new csets
5449 5449 new = [0] * len(repo)
5450 5450 cl = repo.changelog
5451 5451 for a in [cl.rev(n) for n in bheads]:
5452 5452 new[a] = 1
5453 5453 for a in cl.ancestors([cl.rev(n) for n in bheads]):
5454 5454 new[a] = 1
5455 5455 for a in [p.rev() for p in parents]:
5456 5456 if a >= 0:
5457 5457 new[a] = 0
5458 5458 for a in cl.ancestors([p.rev() for p in parents]):
5459 5459 new[a] = 0
5460 5460 new = sum(new)
5461 5461
5462 5462 if new == 0:
5463 5463 # i18n: column positioning for "hg summary"
5464 5464 ui.status(_('update: (current)\n'))
5465 5465 elif pnode not in bheads:
5466 5466 # i18n: column positioning for "hg summary"
5467 5467 ui.write(_('update: %d new changesets (update)\n') % new)
5468 5468 else:
5469 5469 # i18n: column positioning for "hg summary"
5470 5470 ui.write(_('update: %d new changesets, %d branch heads (merge)\n') %
5471 5471 (new, len(bheads)))
5472 5472
5473 5473 if opts.get('remote'):
5474 5474 t = []
5475 5475 source, branches = hg.parseurl(ui.expandpath('default'))
5476 5476 sbranch = branches[0]
5477 5477 other = hg.peer(repo, {}, source)
5478 5478 revs, checkout = hg.addbranchrevs(repo, other, branches,
5479 5479 opts.get('rev'))
5480 5480 if revs:
5481 5481 revs = [other.lookup(rev) for rev in revs]
5482 5482 ui.debug('comparing with %s\n' % util.hidepassword(source))
5483 5483 repo.ui.pushbuffer()
5484 5484 commoninc = discovery.findcommonincoming(repo, other, heads=revs)
5485 5485 _common, incoming, _rheads = commoninc
5486 5486 repo.ui.popbuffer()
5487 5487 if incoming:
5488 5488 t.append(_('1 or more incoming'))
5489 5489
5490 5490 dest, branches = hg.parseurl(ui.expandpath('default-push', 'default'))
5491 5491 dbranch = branches[0]
5492 5492 revs, checkout = hg.addbranchrevs(repo, repo, branches, None)
5493 5493 if source != dest:
5494 5494 other = hg.peer(repo, {}, dest)
5495 5495 ui.debug('comparing with %s\n' % util.hidepassword(dest))
5496 5496 if (source != dest or (sbranch is not None and sbranch != dbranch)):
5497 5497 commoninc = None
5498 5498 if revs:
5499 5499 revs = [repo.lookup(rev) for rev in revs]
5500 5500 repo.ui.pushbuffer()
5501 5501 outgoing = discovery.findcommonoutgoing(repo, other, onlyheads=revs,
5502 5502 commoninc=commoninc)
5503 5503 repo.ui.popbuffer()
5504 5504 o = outgoing.missing
5505 5505 if o:
5506 5506 t.append(_('%d outgoing') % len(o))
5507 5507 if 'bookmarks' in other.listkeys('namespaces'):
5508 5508 lmarks = repo.listkeys('bookmarks')
5509 5509 rmarks = other.listkeys('bookmarks')
5510 5510 diff = set(rmarks) - set(lmarks)
5511 5511 if len(diff) > 0:
5512 5512 t.append(_('%d incoming bookmarks') % len(diff))
5513 5513 diff = set(lmarks) - set(rmarks)
5514 5514 if len(diff) > 0:
5515 5515 t.append(_('%d outgoing bookmarks') % len(diff))
5516 5516
5517 5517 if t:
5518 5518 # i18n: column positioning for "hg summary"
5519 5519 ui.write(_('remote: %s\n') % (', '.join(t)))
5520 5520 else:
5521 5521 # i18n: column positioning for "hg summary"
5522 5522 ui.status(_('remote: (synced)\n'))
5523 5523
5524 5524 @command('tag',
5525 5525 [('f', 'force', None, _('force tag')),
5526 5526 ('l', 'local', None, _('make the tag local')),
5527 5527 ('r', 'rev', '', _('revision to tag'), _('REV')),
5528 5528 ('', 'remove', None, _('remove a tag')),
5529 5529 # -l/--local is already there, commitopts cannot be used
5530 5530 ('e', 'edit', None, _('edit commit message')),
5531 5531 ('m', 'message', '', _('use <text> as commit message'), _('TEXT')),
5532 5532 ] + commitopts2,
5533 5533 _('[-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] NAME...'))
5534 5534 def tag(ui, repo, name1, *names, **opts):
5535 5535 """add one or more tags for the current or given revision
5536 5536
5537 5537 Name a particular revision using <name>.
5538 5538
5539 5539 Tags are used to name particular revisions of the repository and are
5540 5540 very useful to compare different revisions, to go back to significant
5541 5541 earlier versions or to mark branch points as releases, etc. Changing
5542 5542 an existing tag is normally disallowed; use -f/--force to override.
5543 5543
5544 5544 If no revision is given, the parent of the working directory is
5545 5545 used, or tip if no revision is checked out.
5546 5546
5547 5547 To facilitate version control, distribution, and merging of tags,
5548 5548 they are stored as a file named ".hgtags" which is managed similarly
5549 5549 to other project files and can be hand-edited if necessary. This
5550 5550 also means that tagging creates a new commit. The file
5551 5551 ".hg/localtags" is used for local tags (not shared among
5552 5552 repositories).
5553 5553
5554 5554 Tag commits are usually made at the head of a branch. If the parent
5555 5555 of the working directory is not a branch head, :hg:`tag` aborts; use
5556 5556 -f/--force to force the tag commit to be based on a non-head
5557 5557 changeset.
5558 5558
5559 5559 See :hg:`help dates` for a list of formats valid for -d/--date.
5560 5560
5561 5561 Since tag names have priority over branch names during revision
5562 5562 lookup, using an existing branch name as a tag name is discouraged.
5563 5563
5564 5564 Returns 0 on success.
5565 5565 """
5566 5566 wlock = lock = None
5567 5567 try:
5568 5568 wlock = repo.wlock()
5569 5569 lock = repo.lock()
5570 5570 rev_ = "."
5571 5571 names = [t.strip() for t in (name1,) + names]
5572 5572 if len(names) != len(set(names)):
5573 5573 raise util.Abort(_('tag names must be unique'))
5574 5574 for n in names:
5575 5575 scmutil.checknewlabel(repo, n, 'tag')
5576 5576 if not n:
5577 5577 raise util.Abort(_('tag names cannot consist entirely of '
5578 5578 'whitespace'))
5579 5579 if opts.get('rev') and opts.get('remove'):
5580 5580 raise util.Abort(_("--rev and --remove are incompatible"))
5581 5581 if opts.get('rev'):
5582 5582 rev_ = opts['rev']
5583 5583 message = opts.get('message')
5584 5584 if opts.get('remove'):
5585 5585 expectedtype = opts.get('local') and 'local' or 'global'
5586 5586 for n in names:
5587 5587 if not repo.tagtype(n):
5588 5588 raise util.Abort(_("tag '%s' does not exist") % n)
5589 5589 if repo.tagtype(n) != expectedtype:
5590 5590 if expectedtype == 'global':
5591 5591 raise util.Abort(_("tag '%s' is not a global tag") % n)
5592 5592 else:
5593 5593 raise util.Abort(_("tag '%s' is not a local tag") % n)
5594 5594 rev_ = nullid
5595 5595 if not message:
5596 5596 # we don't translate commit messages
5597 5597 message = 'Removed tag %s' % ', '.join(names)
5598 5598 elif not opts.get('force'):
5599 5599 for n in names:
5600 5600 if n in repo.tags():
5601 5601 raise util.Abort(_("tag '%s' already exists "
5602 5602 "(use -f to force)") % n)
5603 5603 if not opts.get('local'):
5604 5604 p1, p2 = repo.dirstate.parents()
5605 5605 if p2 != nullid:
5606 5606 raise util.Abort(_('uncommitted merge'))
5607 5607 bheads = repo.branchheads()
5608 5608 if not opts.get('force') and bheads and p1 not in bheads:
5609 5609 raise util.Abort(_('not at a branch head (use -f to force)'))
5610 5610 r = scmutil.revsingle(repo, rev_).node()
5611 5611
5612 5612 if not message:
5613 5613 # we don't translate commit messages
5614 5614 message = ('Added tag %s for changeset %s' %
5615 5615 (', '.join(names), short(r)))
5616 5616
5617 5617 date = opts.get('date')
5618 5618 if date:
5619 5619 date = util.parsedate(date)
5620 5620
5621 5621 if opts.get('edit'):
5622 5622 message = ui.edit(message, ui.username())
5623 5623
5624 5624 # don't allow tagging the null rev
5625 5625 if (not opts.get('remove') and
5626 5626 scmutil.revsingle(repo, rev_).rev() == nullrev):
5627 5627 raise util.Abort(_("cannot tag null revision"))
5628 5628
5629 5629 repo.tag(names, r, message, opts.get('local'), opts.get('user'), date)
5630 5630 finally:
5631 5631 release(lock, wlock)
5632 5632
5633 5633 @command('tags', [], '')
5634 5634 def tags(ui, repo, **opts):
5635 5635 """list repository tags
5636 5636
5637 5637 This lists both regular and local tags. When the -v/--verbose
5638 5638 switch is used, a third column "local" is printed for local tags.
5639 5639
5640 5640 Returns 0 on success.
5641 5641 """
5642 5642
5643 5643 fm = ui.formatter('tags', opts)
5644 5644 hexfunc = ui.debugflag and hex or short
5645 5645 tagtype = ""
5646 5646
5647 5647 for t, n in reversed(repo.tagslist()):
5648 5648 hn = hexfunc(n)
5649 5649 label = 'tags.normal'
5650 5650 tagtype = ''
5651 5651 if repo.tagtype(t) == 'local':
5652 5652 label = 'tags.local'
5653 5653 tagtype = 'local'
5654 5654
5655 5655 fm.startitem()
5656 5656 fm.write('tag', '%s', t, label=label)
5657 5657 fmt = " " * (30 - encoding.colwidth(t)) + ' %5d:%s'
5658 5658 fm.condwrite(not ui.quiet, 'rev id', fmt,
5659 5659 repo.changelog.rev(n), hn, label=label)
5660 5660 fm.condwrite(ui.verbose and tagtype, 'type', ' %s',
5661 5661 tagtype, label=label)
5662 5662 fm.plain('\n')
5663 5663 fm.end()
5664 5664
5665 5665 @command('tip',
5666 5666 [('p', 'patch', None, _('show patch')),
5667 5667 ('g', 'git', None, _('use git extended diff format')),
5668 5668 ] + templateopts,
5669 5669 _('[-p] [-g]'))
5670 5670 def tip(ui, repo, **opts):
5671 5671 """show the tip revision
5672 5672
5673 5673 The tip revision (usually just called the tip) is the changeset
5674 5674 most recently added to the repository (and therefore the most
5675 5675 recently changed head).
5676 5676
5677 5677 If you have just made a commit, that commit will be the tip. If
5678 5678 you have just pulled changes from another repository, the tip of
5679 5679 that repository becomes the current tip. The "tip" tag is special
5680 5680 and cannot be renamed or assigned to a different changeset.
5681 5681
5682 5682 Returns 0 on success.
5683 5683 """
5684 5684 displayer = cmdutil.show_changeset(ui, repo, opts)
5685 5685 displayer.show(repo['tip'])
5686 5686 displayer.close()
5687 5687
5688 5688 @command('unbundle',
5689 5689 [('u', 'update', None,
5690 5690 _('update to new branch head if changesets were unbundled'))],
5691 5691 _('[-u] FILE...'))
5692 5692 def unbundle(ui, repo, fname1, *fnames, **opts):
5693 5693 """apply one or more changegroup files
5694 5694
5695 5695 Apply one or more compressed changegroup files generated by the
5696 5696 bundle command.
5697 5697
5698 5698 Returns 0 on success, 1 if an update has unresolved files.
5699 5699 """
5700 5700 fnames = (fname1,) + fnames
5701 5701
5702 5702 lock = repo.lock()
5703 5703 wc = repo['.']
5704 5704 try:
5705 5705 for fname in fnames:
5706 5706 f = hg.openpath(ui, fname)
5707 5707 gen = changegroup.readbundle(f, fname)
5708 5708 modheads = repo.addchangegroup(gen, 'unbundle', 'bundle:' + fname)
5709 5709 finally:
5710 5710 lock.release()
5711 5711 bookmarks.updatecurrentbookmark(repo, wc.node(), wc.branch())
5712 5712 return postincoming(ui, repo, modheads, opts.get('update'), None)
5713 5713
5714 5714 @command('^update|up|checkout|co',
5715 5715 [('C', 'clean', None, _('discard uncommitted changes (no backup)')),
5716 5716 ('c', 'check', None,
5717 5717 _('update across branches if no uncommitted changes')),
5718 5718 ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
5719 5719 ('r', 'rev', '', _('revision'), _('REV'))],
5720 5720 _('[-c] [-C] [-d DATE] [[-r] REV]'))
5721 5721 def update(ui, repo, node=None, rev=None, clean=False, date=None, check=False):
5722 5722 """update working directory (or switch revisions)
5723 5723
5724 5724 Update the repository's working directory to the specified
5725 5725 changeset. If no changeset is specified, update to the tip of the
5726 5726 current named branch and move the current bookmark (see :hg:`help
5727 5727 bookmarks`).
5728 5728
5729 5729 Update sets the working directory's parent revision to the specified
5730 5730 changeset (see :hg:`help parents`).
5731 5731
5732 5732 If the changeset is not a descendant or ancestor of the working
5733 5733 directory's parent, the update is aborted. With the -c/--check
5734 5734 option, the working directory is checked for uncommitted changes; if
5735 5735 none are found, the working directory is updated to the specified
5736 5736 changeset.
5737 5737
5738 5738 .. container:: verbose
5739 5739
5740 5740 The following rules apply when the working directory contains
5741 5741 uncommitted changes:
5742 5742
5743 5743 1. If neither -c/--check nor -C/--clean is specified, and if
5744 5744 the requested changeset is an ancestor or descendant of
5745 5745 the working directory's parent, the uncommitted changes
5746 5746 are merged into the requested changeset and the merged
5747 5747 result is left uncommitted. If the requested changeset is
5748 5748 not an ancestor or descendant (that is, it is on another
5749 5749 branch), the update is aborted and the uncommitted changes
5750 5750 are preserved.
5751 5751
5752 5752 2. With the -c/--check option, the update is aborted and the
5753 5753 uncommitted changes are preserved.
5754 5754
5755 5755 3. With the -C/--clean option, uncommitted changes are discarded and
5756 5756 the working directory is updated to the requested changeset.
5757 5757
5758 5758 To cancel an uncommitted merge (and lose your changes), use
5759 5759 :hg:`update --clean .`.
5760 5760
5761 5761 Use null as the changeset to remove the working directory (like
5762 5762 :hg:`clone -U`).
5763 5763
5764 5764 If you want to revert just one file to an older revision, use
5765 5765 :hg:`revert [-r REV] NAME`.
5766 5766
5767 5767 See :hg:`help dates` for a list of formats valid for -d/--date.
5768 5768
5769 5769 Returns 0 on success, 1 if there are unresolved files.
5770 5770 """
5771 5771 if rev and node:
5772 5772 raise util.Abort(_("please specify just one revision"))
5773 5773
5774 5774 if rev is None or rev == '':
5775 5775 rev = node
5776 5776
5777 5777 # with no argument, we also move the current bookmark, if any
5778 5778 movemarkfrom = None
5779 5779 if rev is None:
5780 5780 curmark = repo._bookmarkcurrent
5781 5781 if bookmarks.iscurrent(repo):
5782 5782 movemarkfrom = repo['.'].node()
5783 5783 elif curmark:
5784 5784 ui.status(_("updating to active bookmark %s\n") % curmark)
5785 5785 rev = curmark
5786 5786
5787 5787 # if we defined a bookmark, we have to remember the original bookmark name
5788 5788 brev = rev
5789 5789 rev = scmutil.revsingle(repo, rev, rev).rev()
5790 5790
5791 5791 if check and clean:
5792 5792 raise util.Abort(_("cannot specify both -c/--check and -C/--clean"))
5793 5793
5794 5794 if date:
5795 5795 if rev is not None:
5796 5796 raise util.Abort(_("you can't specify a revision and a date"))
5797 5797 rev = cmdutil.finddate(ui, repo, date)
5798 5798
5799 5799 if check:
5800 5800 c = repo[None]
5801 5801 if c.dirty(merge=False, branch=False, missing=True):
5802 5802 raise util.Abort(_("uncommitted local changes"))
5803 5803 if rev is None:
5804 5804 rev = repo[repo[None].branch()].rev()
5805 5805 mergemod._checkunknown(repo, repo[None], repo[rev])
5806 5806
5807 5807 if clean:
5808 5808 ret = hg.clean(repo, rev)
5809 5809 else:
5810 5810 ret = hg.update(repo, rev)
5811 5811
5812 5812 if not ret and movemarkfrom:
5813 5813 if bookmarks.update(repo, [movemarkfrom], repo['.'].node()):
5814 5814 ui.status(_("updating bookmark %s\n") % repo._bookmarkcurrent)
5815 5815 elif brev in repo._bookmarks:
5816 5816 bookmarks.setcurrent(repo, brev)
5817 5817 elif brev:
5818 5818 bookmarks.unsetcurrent(repo)
5819 5819
5820 5820 return ret
5821 5821
5822 5822 @command('verify', [])
5823 5823 def verify(ui, repo):
5824 5824 """verify the integrity of the repository
5825 5825
5826 5826 Verify the integrity of the current repository.
5827 5827
5828 5828 This will perform an extensive check of the repository's
5829 5829 integrity, validating the hashes and checksums of each entry in
5830 5830 the changelog, manifest, and tracked files, as well as the
5831 5831 integrity of their crosslinks and indices.
5832 5832
5833 5833 Please see http://mercurial.selenic.com/wiki/RepositoryCorruption
5834 5834 for more information about recovery from corruption of the
5835 5835 repository.
5836 5836
5837 5837 Returns 0 on success, 1 if errors are encountered.
5838 5838 """
5839 5839 return hg.verify(repo)
5840 5840
5841 5841 @command('version', [])
5842 5842 def version_(ui):
5843 5843 """output version and copyright information"""
5844 5844 ui.write(_("Mercurial Distributed SCM (version %s)\n")
5845 5845 % util.version())
5846 5846 ui.status(_(
5847 5847 "(see http://mercurial.selenic.com for more information)\n"
5848 5848 "\nCopyright (C) 2005-2012 Matt Mackall and others\n"
5849 5849 "This is free software; see the source for copying conditions. "
5850 5850 "There is NO\nwarranty; "
5851 5851 "not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n"
5852 5852 ))
5853 5853
5854 5854 norepo = ("clone init version help debugcommands debugcomplete"
5855 5855 " debugdate debuginstall debugfsinfo debugpushkey debugwireargs"
5856 5856 " debugknown debuggetbundle debugbundle")
5857 5857 optionalrepo = ("identify paths serve showconfig debugancestor debugdag"
5858 5858 " debugdata debugindex debugindexdot debugrevlog")
5859 5859 inferrepo = ("add addremove annotate cat commit diff grep forget log parents"
5860 5860 " remove resolve status debugwalk")
@@ -1,183 +1,188 b''
1 1 $ hg init
2 2
3 3 no bookmarks
4 4
5 5 $ hg bookmarks
6 6 no bookmarks set
7 7
8 8 set bookmark X
9 9
10 10 $ hg bookmark X
11 11
12 12 list bookmarks
13 13
14 14 $ hg bookmark
15 15 * X -1:000000000000
16 16
17 17 list bookmarks with color
18 18
19 19 $ hg --config extensions.color= --config color.mode=ansi \
20 20 > bookmark --color=always
21 21 \x1b[0;32m * X -1:000000000000\x1b[0m (esc)
22 22
23 23 update to bookmark X
24 24
25 25 $ hg update X
26 26 0 files updated, 0 files merged, 0 files removed, 0 files unresolved
27 27
28 28 list bookmarks
29 29
30 30 $ hg bookmarks
31 31 * X -1:000000000000
32 32
33 33 rename
34 34
35 35 $ hg bookmark -m X Z
36 36
37 37 list bookmarks
38 38
39 39 $ cat .hg/bookmarks.current
40 40 Z (no-eol)
41 41 $ cat .hg/bookmarks
42 42 0000000000000000000000000000000000000000 Z
43 43 $ hg bookmarks
44 44 * Z -1:000000000000
45 45
46 46 new bookmark Y
47 47
48 48 $ hg bookmark Y
49 49
50 50 list bookmarks
51 51
52 52 $ hg bookmark
53 53 * Y -1:000000000000
54 54 Z -1:000000000000
55 55
56 56 commit
57 57
58 58 $ echo 'b' > b
59 59 $ hg add b
60 60 $ hg commit -m'test'
61 61
62 62 list bookmarks
63 63
64 64 $ hg bookmark
65 65 * Y 0:719295282060
66 66 Z -1:000000000000
67 67
68 68 Verify that switching to Z updates the current bookmark:
69 69 $ hg update Z
70 70 0 files updated, 0 files merged, 1 files removed, 0 files unresolved
71 71 $ hg bookmark
72 72 Y 0:719295282060
73 73 * Z -1:000000000000
74 74
75 75 Switch back to Y for the remaining tests in this file:
76 76 $ hg update Y
77 77 1 files updated, 0 files merged, 0 files removed, 0 files unresolved
78 78
79 79 delete bookmarks
80 80
81 81 $ hg bookmark -d Y
82 82 $ hg bookmark -d Z
83 83
84 84 list bookmarks
85 85
86 86 $ hg bookmark
87 87 no bookmarks set
88 88
89 89 update to tip
90 90
91 91 $ hg update tip
92 92 0 files updated, 0 files merged, 0 files removed, 0 files unresolved
93 93
94 set bookmark Y using -r .
94 set bookmark Y using -r . but make sure that the active
95 bookmark is not activated
95 96
96 97 $ hg bookmark -r . Y
97 98
98 list bookmarks
99 list bookmarks, Y should not be active
99 100
100 101 $ hg bookmark
101 * Y 0:719295282060
102 Y 0:719295282060
103
104 now, activate Y
105
106 $ hg up -q Y
102 107
103 108 set bookmark Z using -i
104 109
105 110 $ hg bookmark -r . -i Z
106 111 $ hg bookmarks
107 112 * Y 0:719295282060
108 113 Z 0:719295282060
109 114
110 115 deactivate current bookmark using -i
111 116
112 117 $ hg bookmark -i Y
113 118 $ hg bookmarks
114 119 Y 0:719295282060
115 120 Z 0:719295282060
116 121
117 122 $ hg up -q Y
118 123 $ hg bookmark -i
119 124 $ hg bookmarks
120 125 Y 0:719295282060
121 126 Z 0:719295282060
122 127 $ hg bookmark -i
123 128 no active bookmark
124 129 $ hg up -q Y
125 130 $ hg bookmarks
126 131 * Y 0:719295282060
127 132 Z 0:719295282060
128 133
129 134 deactivate current bookmark while renaming
130 135
131 136 $ hg bookmark -i -m Y X
132 137 $ hg bookmarks
133 138 X 0:719295282060
134 139 Z 0:719295282060
135 140
136 141 bare update moves the active bookmark forward and clear the divergent bookmarks
137 142
138 143 $ echo a > a
139 144 $ hg ci -Am1
140 145 adding a
141 146 $ echo b >> a
142 147 $ hg ci -Am2
143 148 $ hg bookmark X@1 -r 1
144 149 $ hg bookmark X@2 -r 2
145 150 $ hg update X
146 151 0 files updated, 0 files merged, 1 files removed, 0 files unresolved
147 152 $ hg bookmarks
148 153 * X 0:719295282060
149 154 X@1 1:cc586d725fbe
150 155 X@2 2:49e1c4e84c58
151 156 Z 0:719295282060
152 157 $ hg update
153 158 1 files updated, 0 files merged, 0 files removed, 0 files unresolved
154 159 updating bookmark X
155 160 $ hg bookmarks
156 161 * X 2:49e1c4e84c58
157 162 Z 0:719295282060
158 163
159 164 test deleting .hg/bookmarks.current when explicitly updating
160 165 to a revision
161 166
162 167 $ echo a >> b
163 168 $ hg ci -m.
164 169 $ hg up -q X
165 170 $ test -f .hg/bookmarks.current
166 171
167 172 try to update to it again to make sure we don't
168 173 set and then unset it
169 174
170 175 $ hg up -q X
171 176 $ test -f .hg/bookmarks.current
172 177
173 178 $ hg up -q 1
174 179 $ test -f .hg/bookmarks.current
175 180 [1]
176 181
177 182 when a bookmark is active, hg up -r . is
178 183 analogus to hg book -i <active bookmark>
179 184
180 185 $ hg up -q X
181 186 $ hg up -q .
182 187 $ test -f .hg/bookmarks.current
183 188 [1]
@@ -1,66 +1,67 b''
1 1 $ echo "[extensions]" >> $HGRCPATH
2 2 $ echo "rebase=" >> $HGRCPATH
3 3
4 4 initialize repository
5 5
6 6 $ hg init
7 7
8 8 $ echo 'a' > a
9 9 $ hg ci -A -m "0"
10 10 adding a
11 11
12 12 $ echo 'b' > b
13 13 $ hg ci -A -m "1"
14 14 adding b
15 15
16 16 $ hg up 0
17 17 0 files updated, 0 files merged, 1 files removed, 0 files unresolved
18 18 $ echo 'c' > c
19 19 $ hg ci -A -m "2"
20 20 adding c
21 21 created new head
22 22
23 23 $ echo 'd' > d
24 24 $ hg ci -A -m "3"
25 25 adding d
26 26
27 27 $ hg bookmark -r 1 one
28 28 $ hg bookmark -r 3 two
29 $ hg up -q two
29 30
30 31 bookmark list
31 32
32 33 $ hg bookmark
33 34 one 1:925d80f479bb
34 35 * two 3:2ae46b1d99a7
35 36
36 37 rebase
37 38
38 39 $ hg rebase -s two -d one
39 40 saved backup bundle to $TESTTMP/.hg/strip-backup/*-backup.hg (glob)
40 41
41 42 $ hg log
42 43 changeset: 3:42e5ed2cdcf4
43 44 bookmark: two
44 45 tag: tip
45 46 parent: 1:925d80f479bb
46 47 user: test
47 48 date: Thu Jan 01 00:00:00 1970 +0000
48 49 summary: 3
49 50
50 51 changeset: 2:db815d6d32e6
51 52 parent: 0:f7b1eb17ad24
52 53 user: test
53 54 date: Thu Jan 01 00:00:00 1970 +0000
54 55 summary: 2
55 56
56 57 changeset: 1:925d80f479bb
57 58 bookmark: one
58 59 user: test
59 60 date: Thu Jan 01 00:00:00 1970 +0000
60 61 summary: 1
61 62
62 63 changeset: 0:f7b1eb17ad24
63 64 user: test
64 65 date: Thu Jan 01 00:00:00 1970 +0000
65 66 summary: 0
66 67
@@ -1,629 +1,630 b''
1 1 $ hg init
2 2
3 3 no bookmarks
4 4
5 5 $ hg bookmarks
6 6 no bookmarks set
7 7
8 8 bookmark rev -1
9 9
10 10 $ hg bookmark X
11 11
12 12 list bookmarks
13 13
14 14 $ hg bookmarks
15 15 * X -1:000000000000
16 16
17 17 list bookmarks with color
18 18
19 19 $ hg --config extensions.color= --config color.mode=ansi \
20 20 > bookmarks --color=always
21 21 \x1b[0;32m * X -1:000000000000\x1b[0m (esc)
22 22
23 23 $ echo a > a
24 24 $ hg add a
25 25 $ hg commit -m 0
26 26
27 27 bookmark X moved to rev 0
28 28
29 29 $ hg bookmarks
30 30 * X 0:f7b1eb17ad24
31 31
32 32 look up bookmark
33 33
34 34 $ hg log -r X
35 35 changeset: 0:f7b1eb17ad24
36 36 bookmark: X
37 37 tag: tip
38 38 user: test
39 39 date: Thu Jan 01 00:00:00 1970 +0000
40 40 summary: 0
41 41
42 42
43 43 second bookmark for rev 0, command should work even with ui.strict on
44 44
45 45 $ hg --config ui.strict=1 bookmark X2
46 46
47 47 bookmark rev -1 again
48 48
49 49 $ hg bookmark -r null Y
50 50
51 51 list bookmarks
52 52
53 53 $ hg bookmarks
54 54 X 0:f7b1eb17ad24
55 55 * X2 0:f7b1eb17ad24
56 56 Y -1:000000000000
57 57
58 58 $ echo b > b
59 59 $ hg add b
60 60 $ hg commit -m 1
61 61
62 62 bookmarks revset
63 63
64 64 $ hg log -r 'bookmark()'
65 65 changeset: 0:f7b1eb17ad24
66 66 bookmark: X
67 67 user: test
68 68 date: Thu Jan 01 00:00:00 1970 +0000
69 69 summary: 0
70 70
71 71 changeset: 1:925d80f479bb
72 72 bookmark: X2
73 73 tag: tip
74 74 user: test
75 75 date: Thu Jan 01 00:00:00 1970 +0000
76 76 summary: 1
77 77
78 78 $ hg log -r 'bookmark(Y)'
79 79 $ hg log -r 'bookmark(X2)'
80 80 changeset: 1:925d80f479bb
81 81 bookmark: X2
82 82 tag: tip
83 83 user: test
84 84 date: Thu Jan 01 00:00:00 1970 +0000
85 85 summary: 1
86 86
87 87 $ hg log -r 'bookmark("re:X")'
88 88 changeset: 0:f7b1eb17ad24
89 89 bookmark: X
90 90 user: test
91 91 date: Thu Jan 01 00:00:00 1970 +0000
92 92 summary: 0
93 93
94 94 changeset: 1:925d80f479bb
95 95 bookmark: X2
96 96 tag: tip
97 97 user: test
98 98 date: Thu Jan 01 00:00:00 1970 +0000
99 99 summary: 1
100 100
101 101 $ hg log -r 'bookmark(unknown)'
102 102 abort: bookmark 'unknown' does not exist
103 103 [255]
104 104
105 105 $ hg help revsets | grep 'bookmark('
106 106 "bookmark([name])"
107 107
108 108 bookmarks X and X2 moved to rev 1, Y at rev -1
109 109
110 110 $ hg bookmarks
111 111 X 0:f7b1eb17ad24
112 112 * X2 1:925d80f479bb
113 113 Y -1:000000000000
114 114
115 115 bookmark rev 0 again
116 116
117 117 $ hg bookmark -r 0 Z
118 118
119 119 $ hg update X
120 120 0 files updated, 0 files merged, 1 files removed, 0 files unresolved
121 121 $ echo c > c
122 122 $ hg add c
123 123 $ hg commit -m 2
124 124 created new head
125 125
126 126 bookmarks X moved to rev 2, Y at rev -1, Z at rev 0
127 127
128 128 $ hg bookmarks
129 129 * X 2:db815d6d32e6
130 130 X2 1:925d80f479bb
131 131 Y -1:000000000000
132 132 Z 0:f7b1eb17ad24
133 133
134 134 rename nonexistent bookmark
135 135
136 136 $ hg bookmark -m A B
137 137 abort: bookmark 'A' does not exist
138 138 [255]
139 139
140 140 rename to existent bookmark
141 141
142 142 $ hg bookmark -m X Y
143 143 abort: bookmark 'Y' already exists (use -f to force)
144 144 [255]
145 145
146 146 force rename to existent bookmark
147 147
148 148 $ hg bookmark -f -m X Y
149 149
150 150 list bookmarks
151 151
152 152 $ hg bookmark
153 153 X2 1:925d80f479bb
154 154 * Y 2:db815d6d32e6
155 155 Z 0:f7b1eb17ad24
156 156
157 157 bookmarks from a revset
158 158 $ hg bookmark -r '.^1' REVSET
159 159 $ hg bookmark -r ':tip' TIP
160 $ hg up -q TIP
160 161 $ hg bookmarks
161 162 REVSET 0:f7b1eb17ad24
162 163 * TIP 2:db815d6d32e6
163 164 X2 1:925d80f479bb
164 165 Y 2:db815d6d32e6
165 166 Z 0:f7b1eb17ad24
166 167
167 168 $ hg bookmark -d REVSET
168 169 $ hg bookmark -d TIP
169 170
170 171 rename without new name
171 172
172 173 $ hg bookmark -m Y
173 174 abort: new bookmark name required
174 175 [255]
175 176
176 177 delete without name
177 178
178 179 $ hg bookmark -d
179 180 abort: bookmark name required
180 181 [255]
181 182
182 183 delete nonexistent bookmark
183 184
184 185 $ hg bookmark -d A
185 186 abort: bookmark 'A' does not exist
186 187 [255]
187 188
188 189 bookmark name with spaces should be stripped
189 190
190 191 $ hg bookmark ' x y '
191 192
192 193 list bookmarks
193 194
194 195 $ hg bookmarks
195 196 X2 1:925d80f479bb
196 197 Y 2:db815d6d32e6
197 198 Z 0:f7b1eb17ad24
198 199 * x y 2:db815d6d32e6
199 200
200 201 look up stripped bookmark name
201 202
202 203 $ hg log -r '"x y"'
203 204 changeset: 2:db815d6d32e6
204 205 bookmark: Y
205 206 bookmark: x y
206 207 tag: tip
207 208 parent: 0:f7b1eb17ad24
208 209 user: test
209 210 date: Thu Jan 01 00:00:00 1970 +0000
210 211 summary: 2
211 212
212 213
213 214 reject bookmark name with newline
214 215
215 216 $ hg bookmark '
216 217 > '
217 218 abort: bookmark names cannot consist entirely of whitespace
218 219 [255]
219 220
220 221 $ hg bookmark -m Z '
221 222 > '
222 223 abort: bookmark names cannot consist entirely of whitespace
223 224 [255]
224 225
225 226 bookmark with reserved name
226 227
227 228 $ hg bookmark tip
228 229 abort: the name 'tip' is reserved
229 230 [255]
230 231
231 232 $ hg bookmark .
232 233 abort: the name '.' is reserved
233 234 [255]
234 235
235 236 $ hg bookmark null
236 237 abort: the name 'null' is reserved
237 238 [255]
238 239
239 240
240 241 bookmark with existing name
241 242
242 243 $ hg bookmark X2
243 244 abort: bookmark 'X2' already exists (use -f to force)
244 245 [255]
245 246
246 247 $ hg bookmark -m Y Z
247 248 abort: bookmark 'Z' already exists (use -f to force)
248 249 [255]
249 250
250 251 bookmark with name of branch
251 252
252 253 $ hg bookmark default
253 254 abort: a bookmark cannot have the name of an existing branch
254 255 [255]
255 256
256 257 $ hg bookmark -m Y default
257 258 abort: a bookmark cannot have the name of an existing branch
258 259 [255]
259 260
260 261 bookmark with integer name
261 262
262 263 $ hg bookmark 10
263 264 abort: cannot use an integer as a name
264 265 [255]
265 266
266 267 incompatible options
267 268
268 269 $ hg bookmark -m Y -d Z
269 270 abort: --delete and --rename are incompatible
270 271 [255]
271 272
272 273 $ hg bookmark -r 1 -d Z
273 274 abort: --rev is incompatible with --delete
274 275 [255]
275 276
276 277 $ hg bookmark -r 1 -m Z Y
277 278 abort: --rev is incompatible with --rename
278 279 [255]
279 280
280 281 force bookmark with existing name
281 282
282 283 $ hg bookmark -f X2
283 284
284 285 force bookmark back to where it was, should deactivate it
285 286
286 287 $ hg bookmark -fr1 X2
287 288 $ hg bookmarks
288 289 X2 1:925d80f479bb
289 290 Y 2:db815d6d32e6
290 291 Z 0:f7b1eb17ad24
291 292 x y 2:db815d6d32e6
292 293
293 294 forward bookmark to descendant without --force
294 295
295 296 $ hg bookmark Z
296 297 moving bookmark 'Z' forward from f7b1eb17ad24
297 298
298 299 list bookmarks
299 300
300 301 $ hg bookmark
301 302 X2 1:925d80f479bb
302 303 Y 2:db815d6d32e6
303 304 * Z 2:db815d6d32e6
304 305 x y 2:db815d6d32e6
305 306
306 307 revision but no bookmark name
307 308
308 309 $ hg bookmark -r .
309 310 abort: bookmark name required
310 311 [255]
311 312
312 313 bookmark name with whitespace only
313 314
314 315 $ hg bookmark ' '
315 316 abort: bookmark names cannot consist entirely of whitespace
316 317 [255]
317 318
318 319 $ hg bookmark -m Y ' '
319 320 abort: bookmark names cannot consist entirely of whitespace
320 321 [255]
321 322
322 323 invalid bookmark
323 324
324 325 $ hg bookmark 'foo:bar'
325 326 abort: ':' cannot be used in a name
326 327 [255]
327 328
328 329 $ hg bookmark 'foo
329 330 > bar'
330 331 abort: '\n' cannot be used in a name
331 332 [255]
332 333
333 334 the bookmark extension should be ignored now that it is part of core
334 335
335 336 $ echo "[extensions]" >> $HGRCPATH
336 337 $ echo "bookmarks=" >> $HGRCPATH
337 338 $ hg bookmarks
338 339 X2 1:925d80f479bb
339 340 Y 2:db815d6d32e6
340 341 * Z 2:db815d6d32e6
341 342 x y 2:db815d6d32e6
342 343
343 344 test summary
344 345
345 346 $ hg summary
346 347 parent: 2:db815d6d32e6 tip
347 348 2
348 349 branch: default
349 350 bookmarks: *Z Y x y
350 351 commit: (clean)
351 352 update: 1 new changesets, 2 branch heads (merge)
352 353
353 354 test id
354 355
355 356 $ hg id
356 357 db815d6d32e6 tip Y/Z/x y
357 358
358 359 test rollback
359 360
360 361 $ echo foo > f1
361 362 $ hg ci -Amr
362 363 adding f1
363 364 $ hg bookmark -f Y -r 1
364 365 $ hg bookmark -f Z -r 1
365 366 $ hg rollback
366 367 repository tip rolled back to revision 2 (undo commit)
367 368 working directory now based on revision 2
368 369 $ hg bookmarks
369 370 X2 1:925d80f479bb
370 371 Y 2:db815d6d32e6
371 372 Z 2:db815d6d32e6
372 373 x y 2:db815d6d32e6
373 374
374 375 activate bookmark on working dir parent without --force
375 376
376 377 $ hg bookmark --inactive Z
377 378 $ hg bookmark Z
378 379
379 380 test clone
380 381
381 382 $ hg bookmark -r 2 -i @
382 383 $ hg bookmark -r 2 -i a@
383 384 $ hg bookmarks
384 385 @ 2:db815d6d32e6
385 386 X2 1:925d80f479bb
386 387 Y 2:db815d6d32e6
387 388 * Z 2:db815d6d32e6
388 389 a@ 2:db815d6d32e6
389 390 x y 2:db815d6d32e6
390 391 $ hg clone . cloned-bookmarks
391 392 updating to bookmark @
392 393 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
393 394 $ hg -R cloned-bookmarks bookmarks
394 395 * @ 2:db815d6d32e6
395 396 X2 1:925d80f479bb
396 397 Y 2:db815d6d32e6
397 398 Z 2:db815d6d32e6
398 399 a@ 2:db815d6d32e6
399 400 x y 2:db815d6d32e6
400 401
401 402 test clone with pull protocol
402 403
403 404 $ hg clone --pull . cloned-bookmarks-pull
404 405 requesting all changes
405 406 adding changesets
406 407 adding manifests
407 408 adding file changes
408 409 added 3 changesets with 3 changes to 3 files (+1 heads)
409 410 updating to bookmark @
410 411 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
411 412 $ hg -R cloned-bookmarks-pull bookmarks
412 413 * @ 2:db815d6d32e6
413 414 X2 1:925d80f479bb
414 415 Y 2:db815d6d32e6
415 416 Z 2:db815d6d32e6
416 417 a@ 2:db815d6d32e6
417 418 x y 2:db815d6d32e6
418 419
419 420 $ hg bookmark -d @
420 421 $ hg bookmark -d a@
421 422
422 423 test clone with a bookmark named "default" (issue3677)
423 424
424 425 $ hg bookmark -r 1 -f -i default
425 426 $ hg clone . cloned-bookmark-default
426 427 updating to branch default
427 428 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
428 429 $ hg -R cloned-bookmark-default bookmarks
429 430 X2 1:925d80f479bb
430 431 Y 2:db815d6d32e6
431 432 Z 2:db815d6d32e6
432 433 default 1:925d80f479bb
433 434 x y 2:db815d6d32e6
434 435 $ hg -R cloned-bookmark-default parents -q
435 436 2:db815d6d32e6
436 437 $ hg bookmark -d default
437 438
438 439 test clone with a specific revision
439 440
440 441 $ hg clone -r 925d80 . cloned-bookmarks-rev
441 442 adding changesets
442 443 adding manifests
443 444 adding file changes
444 445 added 2 changesets with 2 changes to 2 files
445 446 updating to branch default
446 447 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
447 448 $ hg -R cloned-bookmarks-rev bookmarks
448 449 X2 1:925d80f479bb
449 450
450 451 test clone with update to a bookmark
451 452
452 453 $ hg clone -u Z . cloned-bookmarks-update
453 454 updating to branch default
454 455 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
455 456 $ hg -R cloned-bookmarks-update bookmarks
456 457 X2 1:925d80f479bb
457 458 Y 2:db815d6d32e6
458 459 * Z 2:db815d6d32e6
459 460 x y 2:db815d6d32e6
460 461
461 462 create bundle with two heads
462 463
463 464 $ hg clone . tobundle
464 465 updating to branch default
465 466 2 files updated, 0 files merged, 0 files removed, 0 files unresolved
466 467 $ echo x > tobundle/x
467 468 $ hg -R tobundle add tobundle/x
468 469 $ hg -R tobundle commit -m'x'
469 470 $ hg -R tobundle update -r -2
470 471 0 files updated, 0 files merged, 1 files removed, 0 files unresolved
471 472 $ echo y > tobundle/y
472 473 $ hg -R tobundle branch test
473 474 marked working directory as branch test
474 475 (branches are permanent and global, did you want a bookmark?)
475 476 $ hg -R tobundle add tobundle/y
476 477 $ hg -R tobundle commit -m'y'
477 478 $ hg -R tobundle bundle tobundle.hg
478 479 searching for changes
479 480 2 changesets found
480 481 $ hg unbundle tobundle.hg
481 482 adding changesets
482 483 adding manifests
483 484 adding file changes
484 485 added 2 changesets with 2 changes to 2 files (+1 heads)
485 486 (run 'hg heads' to see heads, 'hg merge' to merge)
486 487
487 488 update to current bookmark if it's not the parent
488 489
489 490 $ hg summary
490 491 parent: 2:db815d6d32e6
491 492 2
492 493 branch: default
493 494 bookmarks: [Z] Y x y
494 495 commit: 1 added, 1 unknown (new branch head)
495 496 update: 2 new changesets (update)
496 497 $ hg update
497 498 updating to active bookmark Z
498 499 1 files updated, 0 files merged, 0 files removed, 0 files unresolved
499 500 $ hg bookmarks
500 501 X2 1:925d80f479bb
501 502 Y 2:db815d6d32e6
502 503 * Z 3:125c9a1d6df6
503 504 x y 2:db815d6d32e6
504 505
505 506 test wrongly formated bookmark
506 507
507 508 $ echo '' >> .hg/bookmarks
508 509 $ hg bookmarks
509 510 X2 1:925d80f479bb
510 511 Y 2:db815d6d32e6
511 512 * Z 3:125c9a1d6df6
512 513 x y 2:db815d6d32e6
513 514 $ echo "Ican'thasformatedlines" >> .hg/bookmarks
514 515 $ hg bookmarks
515 516 malformed line in .hg/bookmarks: "Ican'thasformatedlines"
516 517 X2 1:925d80f479bb
517 518 Y 2:db815d6d32e6
518 519 * Z 3:125c9a1d6df6
519 520 x y 2:db815d6d32e6
520 521
521 522 test missing revisions
522 523
523 524 $ echo "925d80f479bc z" > .hg/bookmarks
524 525 $ hg book
525 526 no bookmarks set
526 527
527 528 test stripping a non-checked-out but bookmarked revision
528 529
529 530 $ hg --config extensions.graphlog= log --graph
530 531 o changeset: 4:9ba5f110a0b3
531 532 | branch: test
532 533 | tag: tip
533 534 | parent: 2:db815d6d32e6
534 535 | user: test
535 536 | date: Thu Jan 01 00:00:00 1970 +0000
536 537 | summary: y
537 538 |
538 539 | @ changeset: 3:125c9a1d6df6
539 540 |/ user: test
540 541 | date: Thu Jan 01 00:00:00 1970 +0000
541 542 | summary: x
542 543 |
543 544 o changeset: 2:db815d6d32e6
544 545 | parent: 0:f7b1eb17ad24
545 546 | user: test
546 547 | date: Thu Jan 01 00:00:00 1970 +0000
547 548 | summary: 2
548 549 |
549 550 | o changeset: 1:925d80f479bb
550 551 |/ user: test
551 552 | date: Thu Jan 01 00:00:00 1970 +0000
552 553 | summary: 1
553 554 |
554 555 o changeset: 0:f7b1eb17ad24
555 556 user: test
556 557 date: Thu Jan 01 00:00:00 1970 +0000
557 558 summary: 0
558 559
559 560 $ hg book should-end-on-two
560 561 $ hg co --clean 4
561 562 1 files updated, 0 files merged, 1 files removed, 0 files unresolved
562 563 $ hg book four
563 564 $ hg --config extensions.mq= strip 3
564 565 saved backup bundle to * (glob)
565 566 should-end-on-two should end up pointing to revision 2, as that's the
566 567 tipmost surviving ancestor of the stripped revision.
567 568 $ hg --config extensions.graphlog= log --graph
568 569 @ changeset: 3:9ba5f110a0b3
569 570 | branch: test
570 571 | bookmark: four
571 572 | tag: tip
572 573 | user: test
573 574 | date: Thu Jan 01 00:00:00 1970 +0000
574 575 | summary: y
575 576 |
576 577 o changeset: 2:db815d6d32e6
577 578 | bookmark: should-end-on-two
578 579 | parent: 0:f7b1eb17ad24
579 580 | user: test
580 581 | date: Thu Jan 01 00:00:00 1970 +0000
581 582 | summary: 2
582 583 |
583 584 | o changeset: 1:925d80f479bb
584 585 |/ user: test
585 586 | date: Thu Jan 01 00:00:00 1970 +0000
586 587 | summary: 1
587 588 |
588 589 o changeset: 0:f7b1eb17ad24
589 590 user: test
590 591 date: Thu Jan 01 00:00:00 1970 +0000
591 592 summary: 0
592 593
593 594
594 595 test clearing divergent bookmarks of linear ancestors
595 596
596 597 $ hg bookmark Z -r 0
597 598 $ hg bookmark Z@1 -r 1
598 599 $ hg bookmark Z@2 -r 2
599 600 $ hg bookmark Z@3 -r 3
600 601 $ hg book
601 602 Z 0:f7b1eb17ad24
602 603 Z@1 1:925d80f479bb
603 604 Z@2 2:db815d6d32e6
604 * Z@3 3:9ba5f110a0b3
605 four 3:9ba5f110a0b3
605 Z@3 3:9ba5f110a0b3
606 * four 3:9ba5f110a0b3
606 607 should-end-on-two 2:db815d6d32e6
607 608 $ hg bookmark Z
608 609 moving bookmark 'Z' forward from f7b1eb17ad24
609 610 $ hg book
610 611 * Z 3:9ba5f110a0b3
611 612 Z@1 1:925d80f479bb
612 613 four 3:9ba5f110a0b3
613 614 should-end-on-two 2:db815d6d32e6
614 615
615 616 test clearing only a single divergent bookmark across branches
616 617
617 618 $ hg book foo -r 1
618 619 $ hg book foo@1 -r 0
619 620 $ hg book foo@2 -r 2
620 621 $ hg book foo@3 -r 3
621 622 $ hg book foo -r foo@3
622 623 $ hg book
623 Z 3:9ba5f110a0b3
624 * Z 3:9ba5f110a0b3
624 625 Z@1 1:925d80f479bb
625 * foo 3:9ba5f110a0b3
626 foo 3:9ba5f110a0b3
626 627 foo@1 0:f7b1eb17ad24
627 628 foo@2 2:db815d6d32e6
628 629 four 3:9ba5f110a0b3
629 630 should-end-on-two 2:db815d6d32e6
General Comments 0
You need to be logged in to leave comments. Login now