Change 20070116-jgrandyw-y by [EMAIL PROTECTED] on 2007-01-16
12:55:31 PST
in /Users/jgrandyw/dev/svn/openlaszlo/branches/legals
Summary: Unify comment processing for script and tag source, bring
back Components refguide content
Technical Reviewer: pga
QA Reviewer:
Doc Reviewer:
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.
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/xsl/lzx2js2doc.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/20070116-
jgrandyw-y.tar
