Do not distinguish \refmodule from \module in the generated output;

whether or not a link will be generated will depend on the link database.
Add a couple of explanatory comments for one of the stranger constructs
(giving input an empty name).

diff --git a/Doc/tools/sgmlconv/conversion.xml b/Doc/tools/sgmlconv/conversion.xml
index 20acdf36c145ee2bfb6c7705293e318527e0dcc8..1944b1f784918d53b5958174ea1021fc5d0390d8 100644 (file)
--- a/Doc/tools/sgmlconv/conversion.xml
+++ b/Doc/tools/sgmlconv/conversion.xml
@@ -70,8 +70,9 @@
 
   <!-- Module referencing. -->
   <macro name="refmodule" outputname="module">
+    <!-- this causes the optional parameter to \refmodule to be
+         discarded -->
     <attribute name="" optional="yes"/>
-    <attribute name="link">yes</attribute>
     <content/>
     </macro>
 
@@ -184,6 +185,8 @@
 
   <!-- "See also:" sections. -->
   <macro name="seemodule">
+    <!-- this causes the optional parameter to \seemodule to be
+         discarded -->
     <attribute name="" optional="yes"/>
     <attribute name="name"/>
     <child name="description"/>