( )⚙ D9990 gendoc: use an empty comment so aliases are separated from previous elements

This is an archive of the discontinued Mercurial Phabricator instance.

Differential D9990

gendoc: use an empty comment so aliases are separated from previous elements
ClosedPublic

Authored by spectral on Feb 12 2021, 4:31 PM.

Details

Reviewers
pulkit
Group Reviewers
hg-reviewers
Commits
rHG85ec89c47a04: gendoc: use an empty comment so aliases are separated from previous elements
Summary

For commands like hg bookmarks, where there's no `[+] marked option can be
specified multiple times`, this causes the final option in the option list to
not be the parent of the aliases definition. The aliases section is thus marked
as a blockquote like on commands that do have text separating the option list
and the aliases definition.

Diff Detail

Repository
rHG Mercurial
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

spectral created this revision.Feb 12 2021, 4:31 PM
pulkit accepted this revision.Feb 14 2021, 10:17 AM
This revision is now accepted and ready to land.Feb 14 2021, 10:17 AM

Revision Contents
Changeset List

PathPackages
Mdoc/gendoc.py (7 lines)

Diff 25623

doc/gendoc.py

_( _(
b"\n[+] marked option can be specified" b"\n[+] marked option can be specified"
b" multiple times\n" b" multiple times\n"
) )
) )
ui.write(b"\n") ui.write(b"\n")
# aliases # aliases
if d[b'aliases']: if d[b'aliases']:
ui.write(_(b" aliases: %s\n\n") % b" ".join(d[b'aliases'])) # Note the empty comment, this is required to separate this
# (which should be a blockquote) from any preceding things (such
# as a definition list).
ui.write(
_(b"..\n\n aliases: %s\n\n") % b" ".join(d[b'aliases'])
)
def allextensionnames(): def allextensionnames():
return set(extensions.enabled().keys()) | set(extensions.disabled().keys()) return set(extensions.enabled().keys()) | set(extensions.disabled().keys())
if __name__ == "__main__": if __name__ == "__main__":
doc = b'hg.1.gendoc' doc = b'hg.1.gendoc'