ANN: pyXSLdoc 0.65
c.
csad7 at t-online.de
Wed Jul 7 20:14:11 CEST 2004
what is it
----------
An application to produce documentation for XSLT files in XHTML format,
similar to what javadoc does for Java files.
changes since the last release
------------------------------
* shortcomments on overview tables are shown now (in ReST version only)
* new options
--windowtitle
will be shown as Main Headline on overview page if no doctitle given or
found
--doctitle
doctitle.txt in ReST format will be shown at the top of overview page
--encoding
specify the encoding of additional ReST documentation files like
help.txt overview.txt or directory.txt.
* improved
--verbose, -v
output prints messages about used doctitle, overview and helpfile ReST
files now
* bugfixes and Javadoc comment style improvements suggested by Doron Enav
see http://cthedot.de/pyxsldoc/README.txt for a complete list of changes
license
-------
pyXSLdoc is published under the LGPL.
download
--------
download pyXSLdoc v0.65 - 040707 from http://cthedot.de/pyxsldoc/
pyXSLdoc needs
* Python 2.3 (tested with Python 2.3.4 on Windows XP only)
* Pyana (tested with Pyana 0.9.1 only)
* Docutils (tested with Docutils 0.3 only)
usage
-----
Copy the XSLT files to document in a directory below pyXSLdoc (you could
also give the complete path to your files but that would end up like
that in the documentation). Then start the documentation process with
>python xsldoc.py DIRNAMES FILENAMES [options]
DIRNAMES
directories with XSLT files to document,e.g. dir1 dir2
All directories and XSLT files below a given directory will be
processed, so you can just use your XSLT package main directory name or
use option -s.
FILENAMES
single XSLT files to document, e.g. file1.xsl path/file2.xsl
options
~~~~~~~
-sSOURCEPATH, --sourcepath=SOURCEPATH
sourcepath to XSLTs, all XSLT files under this path will be documented
and ``$SOURCEPATH/doctitle.txt`` and ``$SOURCEPATH/overview.txt`` will
be used for the overview. Alternatively you might also simply list all
dirs and XSLT files to document.
-j, --javadoc, --htmldocs
process comments in Javadoc style (XHTML and @tags). Default is
reStructuredText (ReST).
-dDOCPATH, --docpath=DOCPATH
documentation target directory. Default is ``./_xsldoc``
--windowtitle=WINDOWTITLE
browser window title for the documentation. Text only, no markup.
--doctitle=DOCTITLE
show the contents of this ReST .txt file at the top of the overview
page. Default is ``$SOURCEPATH/doctitle.txt``. If ommitted or no file is
found, WINDOWTITLETEXT is used.
-oOVERVIEW, --overview=OVERVIEW
show the contents of this ReST .txt file on the overview page.
Default is ``$SOURCEPATH/overview.txt``
--helpfile=HELPFILE
show the information of this ReST .txt file on the help page. Default
is ``./HELP.txt``.
--encoding=ENCODING
encoding of additional documenting ReST files (HELP.txt, doctitle.txt,
overview.txt, directory.txt etc.). Default is utf-8. (Encoding of XSLT
files and comments in these is of course read from the XSLT file itself.)
-r, --removedocs
remove all comments from given XSLTs and save results in
COMMENTSTRIPPEDPATH. Present files will be OVERWRITTEN!
-cCOMMENTSTRIPPEDPATH, --commentstrippedpath=COMMENTSTRIPPEDPATH
path where XSLTs will be saved after removing of all docs. Only used
when option ``--removedocs`` is given. Default directory is
``./_optimized``.
-v, --verbose
show more detailed information while generating the documentation
thanks for the interest. any comment is appreciated
christof hoeke http://cthedot.de
<P><A HREF="http://cthedot.de/pyxsldoc/">pyXSLdoc 0.65</A> - generate
XSLT documentation (7-Jul-04)
More information about the Python-announce-list
mailing list