D2678: help: supporting both help and doc for aliases
mharbison72 (Matt Harbison)
phabricator at mercurial-scm.org
Sun Mar 4 21:04:37 EST 2018
mharbison72 added a comment.
I really like this feature too. Any plans to extend it to {fileset,revset,template}alias?
I don't think this should prevent it from being accepted, but is there a way to get the help text rendered as-is, without reflowing? For example, to simulate the usual 1 line summary + extended detail, I tried:
[alias]
phabimport:doc = Import a stack of revisions from phabricator.
.
This is extended help.
That got me:
$ ../hg help phabimport
hg phabimport
shell alias for: "%HG%" phabread $1 | "%HG%" import --bypass -
Import a stack of revisions from phabricator. . This is extended help.
defined by: c:\Users\Matt\projects\hg\.hg\hgrc:28
(some details hidden, use --verbose to show complete help)
(The middle '.' line is necessary, because the config parser throws away empty lines, complains about unexpected leading whitespace in the next line, and then exits without the usual 'abort: ' prefix. That bad format even kills `hg version`, but the output does indicate exactly where the problem is.)
REPOSITORY
rHG Mercurial
REVISION DETAIL
https://phab.mercurial-scm.org/D2678
To: rdamazio, #hg-reviewers
Cc: mharbison72, spectral, pulkit, mercurial-devel
More information about the Mercurial-devel
mailing list