comparison mercurial/commands.py @ 3914:3c82ab166eea

doc fix: hg tags defaults to current parent revision, too. Additionally use better language for the help text for tag, cat and manifest.
author Thomas Arendsen Hein <thomas@intevation.de>
date Sat, 16 Dec 2006 22:58:10 +0100
parents 283ee8971570
children b12eae71382d 86098ec4b77a
comparison
equal deleted inserted replaced
3913:283ee8971570 3914:3c82ab166eea
340 340
341 def cat(ui, repo, file1, *pats, **opts): 341 def cat(ui, repo, file1, *pats, **opts):
342 """output the current or given revision of files 342 """output the current or given revision of files
343 343
344 Print the specified files as they were at the given revision. 344 Print the specified files as they were at the given revision.
345 If no revision is given then working dir parent is used, or tip 345 If no revision is given, the parent of the working directory is used,
346 if no revision is checked out. 346 or tip if no revision is checked out.
347 347
348 Output may be to a file, in which case the name of the file is 348 Output may be to a file, in which case the name of the file is
349 given using a format string. The formatting rules are the same as 349 given using a format string. The formatting rules are the same as
350 for the export command, with the following additions: 350 for the export command, with the following additions:
351 351
1742 1742
1743 def manifest(ui, repo, rev=None): 1743 def manifest(ui, repo, rev=None):
1744 """output the current or given revision of the project manifest 1744 """output the current or given revision of the project manifest
1745 1745
1746 Print a list of version controlled files for the given revision. 1746 Print a list of version controlled files for the given revision.
1747 If no revision is given then working dir parent is used, or tip 1747 If no revision is given, the parent of the working directory is used,
1748 if no revision is checked out. 1748 or tip if no revision is checked out.
1749 1749
1750 The manifest is the list of files being version controlled. If no revision 1750 The manifest is the list of files being version controlled. If no revision
1751 is given then the first parent of the working directory is used. 1751 is given then the first parent of the working directory is used.
1752 1752
1753 With -v flag, print file permissions. With --debug flag, print 1753 With -v flag, print file permissions. With --debug flag, print
2402 copied = repo.dirstate.copied(f) 2402 copied = repo.dirstate.copied(f)
2403 if copied: 2403 if copied:
2404 ui.write(' %s%s' % (copied, end)) 2404 ui.write(' %s%s' % (copied, end))
2405 2405
2406 def tag(ui, repo, name, rev_=None, **opts): 2406 def tag(ui, repo, name, rev_=None, **opts):
2407 """add a tag for the current tip or a given revision 2407 """add a tag for the current or given revision
2408 2408
2409 Name a particular revision using <name>. 2409 Name a particular revision using <name>.
2410 2410
2411 Tags are used to name particular revisions of the repository and are 2411 Tags are used to name particular revisions of the repository and are
2412 very useful to compare different revision, to go back to significant 2412 very useful to compare different revision, to go back to significant
2413 earlier versions or to mark branch points as releases, etc. 2413 earlier versions or to mark branch points as releases, etc.
2414 2414
2415 If no revision is given, the parent of the working directory is used. 2415 If no revision is given, the parent of the working directory is used,
2416 or tip if no revision is checked out.
2416 2417
2417 To facilitate version control, distribution, and merging of tags, 2418 To facilitate version control, distribution, and merging of tags,
2418 they are stored as a file named ".hgtags" which is managed 2419 they are stored as a file named ".hgtags" which is managed
2419 similarly to other project files and can be hand-edited if 2420 similarly to other project files and can be hand-edited if
2420 necessary. The file '.hg/localtags' is used for local tags (not 2421 necessary. The file '.hg/localtags' is used for local tags (not