X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=doclib%2FSConscript;h=276ec2d6555dafbeecc6fbdfd6ff9c1c5f5df814;hb=31243b46fbd06bc6301acca8fbd8153829c61b0a;hp=102709e08caf561de97d5a13f1a6412e36fe78ce;hpb=6684208965aac5a93db01bcd189bc5c501f04c2c;p=senf.git diff --git a/doclib/SConscript b/doclib/SConscript index 102709e..276ec2d 100644 --- a/doclib/SConscript +++ b/doclib/SConscript @@ -29,8 +29,9 @@ # 1. Scanning the Doxyfile's # # The doxygen builder scans all documentation source files which have -# the text 'doxyfile' in any case within them. It understands @INCLUDE -# directives and will find all the dependencies of the documentation: +# the text 'doxyfile' in any case in their name. It understands +# @INCLUDE directives and will find all the dependencies of the +# documentation: # # * All the source files as selected by INPUT, INPUT_PATTERN, # RECURSIVE and so on. @@ -94,14 +95,14 @@ # # * 'doclib/dot' calls the real dot binary. If the resulting image is # more than 800 pixels wide, dot is called again, this time using -# the oposite rang direction (top-bottom vs. left-right). Then the -# image with the smaller width is selected and returned. +# the oposite rank direction (top-bottom vs. left-right). The image +# with the smaller width is selected and returned. # # * after doxygen is finished, the list of referenced tag-files is # checked. For each tag file the directory is found, where the # documentation is generated (by scanning the Doxyfile which is # repsonsible for building the tag file). For every tag file, the -# correct 'insstalldox' command is generated +# correct 'installdox' command is generated. # # * The stamp files are created # @@ -118,9 +119,9 @@ # namespace. # # * All html files are processed by 'doclib/html-munge.xsl'. However, -# since the documentation generated by doxygen is completely broken -# we need to preprocess the html files with a simple 'sed' script -# and 'tidy' before 'xsltproc' even accepts the html code. +# since the documentation generated by doxygen is completely invalid +# html we need to preprocess the html files with a simple 'sed' +# script and 'tidy' before 'xsltproc' even accepts the html code. # # * We use the generated xml output of doxygen to generate an XML # fragment for the global cross reference. This fragment is