mercurial-scm/hg: comparison mercurial/commands.py

equal deleted inserted replaced

-:babf9a5f5528
+:687c7d395f20
 Schedule files to be version controlled and added to the
 repository.
 The files will be added to the repository at the next commit. To
-undo an add before that, see hg forget.
+undo an add before that, see :hg:`forget`.
 If no names are given, add all files to the repository.
 .. container:: verbose
 def branches(ui, repo, active=False, closed=False):
 """list repository named branches
 List the repository's named branches, indicating which ones are
 inactive. If -c/--closed is specified, also list branches which have
-been marked closed (see hg commit --close-branch).
+been marked closed (see :hg:`commit --close-branch`).
 If -a/--active is specified, only show active branches. A branch
 is considered active if it contains repository heads.
 Use the command :hg:`update` to switch to an existing branch.
 def commit(ui, repo, *pats, **opts):
 """commit the specified files or all outstanding changes
 Commit changes to the given files into the repository. Unlike a
-centralized RCS, this operation is a local operation. See hg push
+centralized RCS, this operation is a local operation. See
-for a way to actively distribute your changes.
+:hg:`push` for a way to actively distribute your changes.
 If a list of files is omitted, all changes reported by :hg:`status`
 will be committed.
 If you are committing the result of a merge, do not provide any
 By default, this command copies the contents of files as they
 exist in the working directory. If invoked with -A/--after, the
 operation is recorded, but no copying is performed.
 This command takes effect with the next commit. To undo a copy
-before that, see hg revert.
+before that, see :hg:`revert`.
 Returns 0 on success, 1 if errors are encountered.
 """
 wlock = repo.wlock(False)
 try:
 This only removes files from the current branch, not from the
 entire project history, and it does not delete them from the
 working directory.
-To undo a forget before the next commit, see hg add.
+To undo a forget before the next commit, see :hg:`add`.
 Returns 0 on success.
 """
 if not pats:
 If one or more REVs are given, only branch heads on the branches
 associated with the specified changesets are shown.
 If -c/--closed is specified, also show branch heads marked closed
-(see hg commit --close-branch).
+(see :hg:`commit --close-branch`).
 If STARTREV is specified, only those heads that are descendants of
 STARTREV will be displayed.
 If -t/--topo is specified, named branch mechanics will be ignored and only
 text/plain or text/x-patch). From and Subject headers of email
 message are used as default committer and commit message. All
 text/plain body parts before first diff are added to commit
 message.
-If the imported patch was generated by hg export, user and
+If the imported patch was generated by :hg:`export`, user and
 description from patch override values from message headers and
 body. Values given on command line with -m/--message and -u/--user
 override these.
 If --exact is specified, import will set the working directory to
 This finds all changes from the repository at the specified path
 or URL and adds them to a local repository (the current one unless
 -R is specified). By default, this does not update the copy of the
 project in the working directory.
-Use hg incoming if you want to see what would have been added by a
+Use :hg:`incoming` if you want to see what would have been added
-pull at the time you issued this command. If you then decide to
+by a pull at the time you issued this command. If you then decide
-add those changes to the repository, you should use pull -r X
+to add those changes to the repository, you should use :hg:`pull
-where X is the last changeset listed by hg incoming.
+-r X` where ``X`` is the last changeset listed by :hg:`incoming`.
 If SOURCE is omitted, the 'default' path will be used.
 See :hg:`help urls` for more information.
 Returns 0 on success, 1 if an update had unresolved files.
 revision without deleting them from the working directory.
 The following table details the behavior of remove for different
 file states (columns) and option combinations (rows). The file
 states are Added [A], Clean [C], Modified [M] and Missing [!] (as
-reported by hg status). The actions are Warn, Remove (from branch)
+reported by :hg:`status`). The actions are Warn, Remove (from
-and Delete (from disk)::
+branch) and Delete (from disk)::
 A  C  M  !
 none   W  RD W  R
 -f     R  RD RD R
 -A     W  W  W  R
 -Af    R  R  R  R
 This command schedules the files to be removed at the next commit.
-To undo a remove before that, see hg revert.
+To undo a remove before that, see :hg:`revert`.
 Returns 0 on success, 1 if any warnings encountered.
 """
 ret = 0
 By default, this command copies the contents of files as they
 exist in the working directory. If invoked with -A/--after, the
 operation is recorded, but no copying is performed.
 This command takes effect at the next commit. To undo a rename
-before that, see hg revert.
+before that, see :hg:`revert`.
 Returns 0 on success, 1 if errors are encountered.
 """
 wlock = repo.wlock(False)
 try:

changeset 11193	687c7d395f20
parent 11185	6d7cf82453be
child 11211	e43c23d189a5