1) Approved pro-forma, as this is Ben's branch and I think he needs
latitude. The general direction is correct and what we agreed upon.
2) As to Tucker's point about recouping potentially useful info:
let's discuss at the OL annual meeting next week. (Input welcome from
the community, of course.)
jrs
On Sep 29, 2007, at 7:52 AM, P T Withington wrote:
Good stuff.
I have one question: is the 'extra information' you are filtering
out _duplicate_ information, or is it _additional_ information that
should still appear, just not where it was appearing? If it is
additional useful information, maybe you could consult our
documentation architect to see where it could fit in our
documentation architecture.
On 2007-09-28, at 22:04 EDT, Benjamin Shine wrote:
(I'm sending these doctools change package reviews as a matter of
courtesy; I'll ask for a "real" review when I have a chunk of
changes ready to go into trunk.)
Change 20070928-ben-3 by [EMAIL PROTECTED] on 2007-09-28 18:24:44 PDT
in /Users/ben/src/svn/openlaszlo/branches/paperpie
for http://svn.openlaszlo.org/openlaszlo/branches/paperpie
Summary: Make top part of individual pages in the reference guide
look more like 3.4 reference guide
Documentation:
This change is a number of small formatting and processing changes
which
make the generated documentation look superficially more like the 3.4
documentation. This mostly means filtering out some of the extra
information that had been added to the top of the page in reference
entries. Several minor CSS changes have been made to match the
look of the old documentation better.
This work was based on getting <tab> to match the 3.4 <tab>
reference. The formatting currently looks "best" for
components; other areas have not been evaluated.
Details:
Tests:
ant clean; ant build doc
passes.
Pages in the reference still look decent, for instance:
http://localhost:8080/paperpie/docs/reference/LzAnimator.html
Files:
M docs/src/build.xml
M docs/src/xsl/js2doc2dbk.xsl
M docs/src/xsl/common-html.xsl
M docs/src/xsl/refguide-html.xsl
M docs/src/xsl/parameters.xsl
M docs/includes/lzx-pretty-print.css
M docs/includes/docbook.css
M docs/includes/styles.css
Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20070928-
ben-3.tar
