Doxygen code comment cleanups and fixes. No code changes. (0.41.5)

src/vm/xml/name.c

@@ -30,9 +30,10 @@
  *   stack as usual.
  *
  * Example
- *  // ... stack: [ node_handle ]
- *  OP_XML_NAME  // → [ "book" ]
+ *  - stack: [ node_handle ]
+ *  - OP_XML_NAME → [ "book" ]
  */
+
 /* OP_XML_NAME: pops node handle; pushes string */
 case OP_XML_NAME: {
 #ifdef FUN_WITH_XML2

src/vm/xml/parse.c

@@ -28,9 +28,10 @@
  * - The parser is invoked with XML_PARSE_NONET to disallow network access.
  *
  * Example
- *  // stack: [ "<root/>" ]
- *  OP_XML_PARSE   // → [ 1 ]   (example handle)
+ *  - stack: [ "<root/>" ]
+ *  - OP_XML_PARSE  → [ 1 ]   (example handle)
  */
+
 /* OP_XML_PARSE: pops text string; pushes doc handle (>0) or 0 */
 case OP_XML_PARSE: {
 #ifdef FUN_WITH_XML2

src/vm/xml/root.c

@@ -26,9 +26,10 @@
  *   released by corresponding XML VM opcodes to avoid leaks.
  *
  * Example
- *  // stack: [ doc_handle ]
- *  OP_XML_ROOT   // → [ node_handle ] or [ 0 ]
+ *  - stack: [ doc_handle ]
+ *  - OP_XML_ROOT → [ node_handle ] or [ 0 ]
  */
+
 /* OP_XML_ROOT: pops doc handle; pushes node handle (>0) or 0 */
 case OP_XML_ROOT: {
 #ifdef FUN_WITH_XML2

src/vm/xml/text.c

@@ -27,9 +27,10 @@
  *   freed immediately after use.
  *
  * Example
- *  // stack: [ node_handle ]
- *  OP_XML_TEXT   // → [ "Hello world" ]
+ *  - stack: [ node_handle ]
+ *  - OP_XML_TEXT → [ "Hello world" ]
  */
+
 /* OP_XML_TEXT: pops node handle; pushes string (concatenate text node children) */
 case OP_XML_TEXT: {
 #ifdef FUN_WITH_XML2