[Laszlo-dev] For Review: Change 20071105-ben-o Summary: Merging a few weeks of work in paperpie into trunk
ben at laszlosystems.com
Mon Nov 5 16:28:03 PST 2007
Change 20071105-ben-o by ben at slim.local on 2007-11-05 15:53:39 PST
Summary: Merging a few weeks of work in paperpie into trunk
LPP-4977 Refguide links to developers' guide chapters are wrongly mapped
LPP-4712 should not have two files with the same name and different
caps in the same directory: lz.html and Lz.html
Incomplete progress on unfiled bugs on the general badness of the
attributes list in the reference
Technical Reviewer: none (alas! my kingdom for an xslt reviewer!)
QA Reviewer: frisco (pending)
Doc Reviewer: sundman (pending)
This change makes substantial progress towards making the documentation
presentable again. The major change is to the attributes list reference,
wherein we're approaching good rules for selecting attribute "category."
The options for attribute category are now initialize-only, read/write,
read-only, and special. No "special" attributes have yet been
Many, many attributes are listed in the reference as "(FIXME:
These are indications to the doc toolsmith (me) that the js2doc comments
in the source are not internally consistent and must be repaired.
Similarly, "(TODO: declare attribute)" is a sign to the toolsmith that
the doc comments indicate that that attribute should be declared in
the source, but it is not. This situation arises because of swf's
permissiveness with undeclared attributes; the doctools are noticing
problems in the code that have been okay with swf < swf9 and okay
with dhtml, but that swf9 and the doctools will need to be squared
Keep track of the attributes for each class as three sets:
args, instance variables, and setters. Do lots of boolean logic on
the members of those sets to figure out what category (read/
initialize-only, todo/fixme) that attribute should belong in.
Change the look of the attribute tables.
Show the returns type of methods.
Detect files that would be named Lz.html and lz.html; give them
docbook.css and docs/includes/styles.css:
cosmetic changes to make the docs look more okay and more like
the 3.4 docs
Instead of totally blowing away the docbook-generated index,
just rename it.
easier to find in the output than ???
Improve linking between reference guide and developer's guide
figuring out how to build a useful attributes list
put back in some templates I had moved out, in paperpie.
ant clean build doc
...look at the doc.
More information about the Laszlo-dev