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