build/doc: explain two XML conversions

Now that I figured out what these do, I might as well add comments about
it for others.

The target names are changed to be more descriptive of what the target
does.

Signed-off-by: Pekka Paalanen <pq@iki.fi>

1 files changed, 8 insertions, 4 deletions

diff --git a/doc/publican/meson.build b/doc/publican/meson.build
index 6493280..9704f29 100644
--- a/doc/publican/meson.build
+++ b/doc/publican/meson.build
@@ -39,29 +39,33 @@ publican_inputs += custom_target(
 	output: 'ProtocolInterfaces.xml'
 )
 
+# Doxygen generates a myriad of files, and offers an XSLT
+# to combine them all into one. This does the combining.
+# The result is still Doxygen XML.
 ClientAPI_combined = custom_target(
-	'ClientAPI-combined',
+	'ClientAPI-combine-doxygen-files',
 	command: [ xsltproc, '-o', '@OUTPUT@', '@INPUT@' ],
 	input: [ doxygen_Client_combine_xslt, doxygen_Client_index_xml ],
 	output: 'ClientAPI-combined.xml'
 )
 
+# This converts Doxygen XML to DocBook XML.
 publican_inputs += custom_target(
-	'ClientAPI.xml',
+	'ClientAPI-doxygen-to-docbook',
 	command: [ xsltproc, '-o', '@OUTPUT@', '--stringparam', 'which', 'Client', to_publican_xsl, '@INPUT@' ],
 	input: ClientAPI_combined,
 	output: 'ClientAPI.xml'
 )
 
 ServerAPI_combined = custom_target(
-	'ServerAPI-combined',
+	'ServerAPI-combine-doxygen-files',
 	command: [ xsltproc, '-o', '@OUTPUT@', '@INPUT@' ],
 	input: [ doxygen_Server_combine_xslt, doxygen_Server_index_xml ],
 	output: 'ServerAPI-combined.xml'
 )
 
 publican_inputs += custom_target(
-	'ServerAPI.xml',
+	'ServerAPI-doxygen-to-docbook',
 	command: [ xsltproc, '-o', '@OUTPUT@', '--stringparam', 'which', 'Server', to_publican_xsl, '@INPUT@' ],
 	input: ServerAPI_combined,
 	output: 'ServerAPI.xml'