bookmarks: wrap docstrings at 70 characters

This commit is contained in:
Martin Geisler 2009-07-26 01:38:22 +02:00
parent bed7919bb4
commit f54e276815

View File

@ -7,22 +7,25 @@
'''track a line of development with movable markers '''track a line of development with movable markers
Bookmarks are local movable markers to changesets. Every bookmark points to a Bookmarks are local movable markers to changesets. Every bookmark
changeset identified by its hash. If you commit a changeset that is based on a points to a changeset identified by its hash. If you commit a
changeset that has a bookmark on it, the bookmark shifts to the new changeset. changeset that is based on a changeset that has a bookmark on it, the
bookmark shifts to the new changeset.
It is possible to use bookmark names in every revision lookup (e.g. hg merge, It is possible to use bookmark names in every revision lookup (e.g. hg
hg update). merge, hg update).
By default, when several bookmarks point to the same changeset, they will all By default, when several bookmarks point to the same changeset, they
move forward together. It is possible to obtain a more git-like experience by will all move forward together. It is possible to obtain a more
adding the following configuration option to your .hgrc:: git-like experience by adding the following configuration option to
your .hgrc::
[bookmarks] [bookmarks]
track.current = True track.current = True
This will cause Mercurial to track the bookmark that you are currently using, This will cause Mercurial to track the bookmark that you are currently
and only update it. This is similar to git's approach to branching. using, and only update it. This is similar to git's approach to
branching.
''' '''
from mercurial.i18n import _ from mercurial.i18n import _
@ -121,15 +124,15 @@ def setcurrent(repo, mark):
def bookmark(ui, repo, mark=None, rev=None, force=False, delete=False, rename=None): def bookmark(ui, repo, mark=None, rev=None, force=False, delete=False, rename=None):
'''track a line of development with movable markers '''track a line of development with movable markers
Bookmarks are pointers to certain commits that move when committing. Bookmarks are pointers to certain commits that move when
Bookmarks are local. They can be renamed, copied and deleted. It is committing. Bookmarks are local. They can be renamed, copied and
possible to use bookmark names in 'hg merge' and 'hg update' to merge and deleted. It is possible to use bookmark names in 'hg merge' and
update respectively to a given bookmark. 'hg update' to merge and update respectively to a given bookmark.
You can use 'hg bookmark NAME' to set a bookmark on the working You can use 'hg bookmark NAME' to set a bookmark on the working
directory's parent revision with the given name. If you specify a revision directory's parent revision with the given name. If you specify
using -r REV (where REV may be an existing bookmark), the bookmark is a revision using -r REV (where REV may be an existing bookmark),
assigned to that revision. the bookmark is assigned to that revision.
''' '''
hexfn = ui.debugflag and hex or short hexfn = ui.debugflag and hex or short
marks = parse(repo) marks = parse(repo)