[Laszlo-dev] For Review: Change 20070122-jgrandyw-u Summary: Unify comment processing for script and tag source, bring back Components refguide content

[Jim Grandy]

Change 20070122-jgrandyw-u by jgrandyw at jgrandy-pb.local on 2007-01-22  
22:37:04 PST
     in /Users/jgrandyw/dev/svn/openlaszlo/branches/legals

Summary: Unify comment processing for script and tag source, bring  
back Components refguide content

New Features:

Bugs Fixed:

Technical Reviewer: pga
QA Reviewer: (pending)
Doc Reviewer: (pending)

Documentation:

Release Notes:

Details:This change refactors js2doc so that it can be used to
"reprocess" raw comments left in js2doc output. The idea is that we use
an XSL transformer to extract documentation from LZX code, but leave the
raw structured comments in <comment> tags. The "--reprocess" option to
js2doc reads in a js2doc XML file and converts the <comment> tags into
properly parsed <doc> tags. There is also a "hoisting" process where
documentation tags are used to fill out the js2doc content itself --
this is used to apply type information, for example -- and that is
handled in this same reprocessing step.

With this change there is Components content in the refguide again, but
it doesn't have as much information as the in the B1 refguide. I had to
rewrite the XSL transformer, and haven't put back all the rules that
were in the B1 version.

Also includes beginnings of conditional content support for devguide,  
and a
change that fixes refguide-to-docbook links.

Tests:'ant clean build doc test'

Files:
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/Comment.java
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/JS2Doc_Test.java
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/JS2Doc.java
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/Main.java
A      WEB-INF/lps/server/src/org/openlaszlo/js2doc/ 
ReprocessComments.java
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/WholeFile_Test.java
M      WEB-INF/lps/server/build.xml
M      docs/src/build.xml
M      docs/src/dguide/fonts.html
M      docs/src/xsl/js2doc-comment2dbk.xsl
M      docs/src/xsl/refguide-html.xsl
M      docs/src/xsl/fast-dguide.xsl
M      docs/src/xsl/dguide.xsl
M      docs/src/xsl/lzx2js2doc.xsl
A      docs/src/xsl/conditional-html.xsl
M      docs/src/xsl/html2dbk.xsl
M      docs/src/xsl/doc2dbk.xsl
M      build-tools/build-opt.xml
M      lps/components/extensions/library.lzx
M      lps/components/extensions/av/library.lzx
M      lps/components/utils/layouts/library.lzx
M      lps/components/utils/states/library.lzx
M      lps/components/charts/library.lzx
M      lps/components/charts/addon/library.lzx
M      lps/components/charts/common/library.lzx
M      lps/components/debugger/library.lzx
M      lps/components/rpc/library.lzx
M      lps/components/lz/library.lzx
M      lps/components/lzunit/library.lzx
M      lps/components/incubator/custombutton.lzx
M      lps/components/incubator/fisheye_lib.lzx
M      lps/components/incubator/draglib.lzx
M      lps/components/incubator/bigcheckbox.lzx
M      lps/components/incubator/colorpicker.lzx
M      lps/components/incubator/closebox.lzx
M      lps/components/incubator/base64.lzx
M      lps/components/incubator/tooltipmanager.lzx
M      lps/components/incubator/stylishbutton.lzx
M      lps/components/incubator/borderinput.lzx
M      lps/components/base/library.lzx

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20070122- 
jgrandyw-u.tar