rst: minor fixes (#18960)

lib/packages/docutils/rst.nim

@@ -172,6 +172,7 @@
 ##     ``header``, ``footer``, ``meta``, ``class``
 ##     - no ``role`` directives and no custom interpreted text roles
 ##     - some standard roles are not supported (check `RST roles list`_)
+##     - no generic admonition support
 ## * inline markup
 ##   - no simple-inline-markup
 ##   - no embedded aliases

lib/packages/docutils/rstast.nim

@@ -381,7 +381,7 @@ proc renderRstToText*(node: PRstNode): string =
       result.add renderRstToText(node.sons[i])
     if node.kind in code: result.add "`"
 
-proc renderRstToStr*(node: PRstNode, indent=0): string =
+proc treeRepr*(node: PRstNode, indent=0): string =
   ## Writes the parsed RST `node` into an AST tree with compact string
   ## representation in the format (one line per every sub-node):
   ## ``indent - kind - [text|level|order|adType] - anchor (if non-zero)``
@@ -411,4 +411,4 @@ proc renderRstToStr*(node: PRstNode, indent=0): string =
   result.add (if node.anchor == "": "" else: "  anchor='" & node.anchor & "'")
   result.add "\n"
   for son in node.sons:
-    result.add renderRstToStr(son, indent=indent+2)
+    result.add treeRepr(son, indent=indent+2)

lib/packages/docutils/rstgen.nim

@@ -1164,7 +1164,7 @@ proc renderAdmonition(d: PDoc, n: PRstNode, result: var string) =
   case n.adType
   of "hint", "note", "tip":
     htmlCls = "admonition-info"; texSz = "\\normalsize"; texColor = "green"
-  of "attention", "admonition", "important", "warning":
+  of "attention", "admonition", "important", "warning", "caution":
     htmlCls = "admonition-warning"; texSz = "\\large"; texColor = "orange"
   of "danger", "error":
     htmlCls = "admonition-error"; texSz = "\\Large"; texColor = "red"

tests/stdlib/trst.nim

@@ -55,7 +55,7 @@ proc toAst(input: string,
 
     var (rst, _, _) = rstParse(input, filen, line=LineRstInit, column=ColRstInit,
                                rstOptions, myFindFile, testMsgHandler)
-    result = renderRstToStr(rst)
+    result = treeRepr(rst)
   except EParseError as e:
     if e.msg != "":
       result = e.msg