# HG changeset patch
# User Kyle Lippincott <spectral@google.com>
# Date 1613165223 28800
# Node ID 85ec89c47a0413a0cbd54062527e33555f45dec3
# Parent  eb36f7a71291de88e0ee12cebdd574d026fce2dc
gendoc: use an empty comment so aliases are separated from previous elements

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.

Differential Revision: https://phab.mercurial-scm.org/D9990

diff -r eb36f7a71291 -r 85ec89c47a04 doc/gendoc.py
--- a/doc/gendoc.py	Fri Feb 12 11:06:56 2021 -0800
+++ b/doc/gendoc.py	Fri Feb 12 13:27:03 2021 -0800
@@ -317,7 +317,12 @@
                 ui.write(b"\n")
             # 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():