doc, minirst: support hg interpreted text role

doc/runrst

@@ -13,7 +13,16 b' where WRITER is the name of a Docutils w'
 """
 
 import sys
+from docutils.parsers.rst import roles
 from docutils.core import publish_cmdline
+from docutils import nodes, utils
+
+def role_hg(name, rawtext, text, lineno, inliner,
+            options={}, content=[]):
+    node = nodes.literal(rawtext, "hg " + utils.unescape(text, True))
+    return [node], []
+
+roles.register_local_role("hg", role_hg)
 
 if __name__ == "__main__":
     if len(sys.argv) < 2:

mercurial/minirst.py

@@ -252,6 +252,15 b' def inlineliterals(blocks):'
     return blocks
 
 
+_hgrolere = re.compile(r':hg:`([^`]+)`')
+
+def hgrole(blocks):
+    for b in blocks:
+        if b['type'] == 'paragraph':
+            b['lines'] = [_hgrolere.sub(r'"hg \1"', l) for l in b['lines']]
+    return blocks
+
+
 def addmargins(blocks):
     """Adds empty blocks for vertical spacing.
 
@@ -333,6 +342,7 b' def format(text, width, indent=0, keep=N'
     blocks = findliteralblocks(blocks)
     blocks, pruned = prunecontainers(blocks, keep or [])
     blocks = inlineliterals(blocks)
+    blocks = hgrole(blocks)
     blocks = splitparagraphs(blocks)
     blocks = updatefieldlists(blocks)
     blocks = findsections(blocks)

tests/test-minirst.py

@@ -178,3 +178,6 b" debugformat('containers (verbose)', cont"
 debugformat('containers (debug)', containers, 60, keep=['debug'])
 debugformat('containers (verbose debug)', containers, 60,
             keep=['verbose', 'debug'])
+
+roles = """Please see :hg:`add`."""
+debugformat('roles', roles, 60)

tests/test-minirst.py.out

@@ -298,3 +298,8 b' Debug output.'
 []
 ----------------------------------------------------------------------
 
+roles formatted to fit within 60 characters:
+----------------------------------------------------------------------
+Please see "hg add".
+----------------------------------------------------------------------
+