documentation/tools: Add comments to script

Signed-off-by: Richard Purdie <rpurdie@linux.intel.com>

diff --git a/documentation/tools/poky-docbook-to-pdf b/documentation/tools/poky-docbook-to-pdf
index 9ac0b828cf44619e123f8829b7df73a0f12c6cbb..f55fd278afc86bb841d37f4c7a58c4fecbf0633e 100755 (executable)
--- a/documentation/tools/poky-docbook-to-pdf
+++ b/documentation/tools/poky-docbook-to-pdf
@@ -18,11 +18,13 @@ TEMPLATEDIR=$2
 # match your localy installed XSL stylesheets.
 XSL_BASE_URI="http://docbook.sourceforge.net/release/xsl/current"
 
+# Creates a temporary XSL stylesheet based on titlepage.xsl
 xsltproc -o /tmp/titlepage.xsl                                           \
         --xinclude                                                      \
          $XSL_BASE_URI/template/titlepage.xsl \
          $TEMPLATEDIR/titlepage.templates.xml || exit 1
 
+# Creates the file needed for FOP
 xsltproc --xinclude                    \
         --stringparam hyphenate false \
         --stringparam formal.title.placement "figure after" \
@@ -38,7 +40,7 @@ xsltproc --xinclude                    \
          $TEMPLATEDIR/poky-db-pdf.xsl    \
         $1                 || exit 1
 
-
+# Invokes the Java version of FOP.  Uses the additional configuration file common/fop-config.xml
 fop -c $TEMPLATEDIR/fop-config.xml -fo $FO -pdf $PDF       || exit 1
 
 rm -f $FO