[PATCH 0 of 2 STABLE] Consistent help text formatting with minirst

Olav Reinert seroton10 at gmail.com
Tue Jan 10 08:40:56 CST 2012


On 10. jan 2012, at 01.37, Matt Mackall wrote:

> On Mon, 2012-01-09 at 17:31 +0100, Olav Reinert wrote:
>> The output from "hg help" is formatted inconsistently, sometimes using
>> formatting strings, sometimes using minirst. Also, the list of enabled
>> extensions is indented differently than the other two sections.
> 
> What user-visible bug does this fix?

"hg help" produces three sections of output: commands, extensions, and additional (help topics).
Currently, the "commands" and "additional" sections are always aligned, on both columns, because formatting is done using the % string formatting operator, or direct invocation of util.wrap(). In contrast, the "extensions" section is formatted as an RST field list. Because our minirst implementation shrinks the width of the left column of field lists to fit its content, the right column is easily brought out of alignment with the columns above and below. This effect is pronounced in the case where mq is the only enabled extension, and it looks buggy to me.

> Why is it appropriate to stable?

It isn't - my bad.



More information about the Mercurial-devel mailing list