[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