[PATCH 2 of 2 STABLE] Consistent help text formatting (indentation)
Martin Geisler
mg at lazybytes.net
Wed Jan 11 02:13:02 CST 2012
Matt Mackall <mpm at selenic.com> writes:
> On Tue, 2012-01-10 at 15:41 +0100, Olav Reinert wrote:
>
>> Finally, when formatting the command list using RST, if
>> 'definitionmargin':False is omitted, the output of "hg help -v" will
>> look like this:
>>
>> [quote]
>> 14:51:11 ~/Code/mercurial $ ./hg help -v
>> Mercurial Distributed SCM
>>
>> list of commands:
>>
>> add:
>> add the specified files on the next commit
>>
>> addremove:
>> add all new files, delete all missing files
>>
>> annotate, blame:
>> show changeset information by line for each file
>>
>> archive:
>> create an unversioned archive of a repository revision
>
> Yeah, I've never liked that. We waste 55 lines in stock hg just to
> tell you about a few boring or trivial aliases:
>
> annotate, blame:
> commit, ci:
> copy, cp:
> identify, id:
> import, patch:
> incoming, in:
> log, history:
> outgoing, out:
> remove, rm:
> rename, move, mv:
> showconfig, debugconfig:
> status, st:
> summary, sum:
> update, up, checkout, co:
>
> Some of these (like history) we shouldn't even be advertising. The
> rest can easily be discovered just by running 'hg help <command I
> don't know>' or 'hg help <command I want aliases for>'. I'm fine with
> dropping this version of the list entirely though maybe other people
> disagree.
Just FYI, I'm also happy to drop it! I never liked the hanging format
much here, so let's throw it out.
--
Martin Geisler
Mercurial links: http://mercurial.ch/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
URL: <http://selenic.com/pipermail/mercurial-devel/attachments/20120111/e0afae84/attachment.pgp>
More information about the Mercurial-devel
mailing list