Add some more comments

doc/asciidoc.conf

@@ -1,17 +1,33 @@
 # AsciiDoc configuration file
 # Copyright (c) Jonas Fonseca <fonseca@diku.dk>, 2006
 
-# The elink macro can have optional {0} value, that is what
+# This file sets the following ELinks specific AsciiDoc macros:
+#
+# General purpose:
+# - man:page[section]: which is used for linking between ELinks manpages.
+#
+# API Doc:
+# - id:[]
+# - enum:[]
+# - func:[]
+# - struct:[]
+# - macro:[]
+# - typedef:[]
+# - ref:[]
+
+# Some macros can have optional {0} value, that is what
 # the {0%...} and {0#...} handles.
 
 #############################################################################
 # DocBook
 
 ifdef::backend-docbook[]
+
+# No interlinking between elinks manpages
 [man-inlinemacro]
 {target}({0})
 
-## For manpages use less verbose linking
+# For manpages use less verbose linking
 ifdef::doctype-manpage[]
 [link-inlinemacro]
 {0%&lt;{target}&gt;}
@@ -31,9 +47,13 @@ endif::backend-docbook[]
 # XHTML11
 
 ifdef::backend-xhtml11[]
+
+# Use the man:[] macro to link between elinks manpages
 [man-inlinemacro]
 <a href="{target}.{0}.html">{target}({0})</a>
 
+# API Doc macros
+
 [id-inlinemacro]
 <a id="{0}" href="#{0}">{0}</a>
 
@@ -54,4 +74,5 @@ ifdef::backend-xhtml11[]
 
 [ref-inlinemacro]
 <a href="{target}#{0}">{0}</a>
+
 endif::backend-xhtml11[]