[Laszlo-dev] For Review: Change 20070709-jgrandyw-I Summary: Many improvements to doc tools and dguide and refguide

[Jim Grandy]

Change 20070709-jgrandyw-I by jgrandyw at jgrandy-mbp.local on  
2007-07-09 11:06:35 PDT
     in /Users/jgrandyw/dev/svn/openlaszlo/branches/legals
     for http://svn.openlaszlo.org/openlaszlo/branches/legals

Summary: Many improvements to doc tools and dguide and refguide

New Features:

Bugs Fixed:

LPP-1568  	Dataselectionmanager isSelected() has a return value, but  
is not documented.
LPP-1981  	context attribute of datapointer is missing a description
LPP-3385 	Dataset reference page shows confusing use of setQueryString()
LPP-3548 	Add runtime switch to documentation examples
LPP-3801 	improved reference doc for @mask attribute
LPP-3924 	Refguide Index entries for members should give parent class  
name
LPP-3926 	Remove links to Designer's guide
LPP-3927 	Link to forums from Preface in Reference Guide is incorrect
LPP-3938 	Index to 4.0 reference missing several entries for LzFoo 
(see also foo)
LPP-3941 	Create "Users" and "Contributors" sets containing existing  
books
LPP-4088 	Ant doc reports 'build successful' even though a gremlin in  
a .dbk source file breaks the build
LPP-4089 	Many semicolons disappeared from dguide code examples
LPP-4124 	LzParam should be a public API
LPP-4125 	LzDataElement.lzs should be listed in Files index of RefGuide
LPP-4140 	selectionmanager not documented in 4.0.2
LPP-4187 	Refguide: missing description for radiogroup
LPP-4262    docs/components is obsolete and should be removed
LPP-4263    Contributor's reference build shows lots of broken links
LPP-4264    Streamline xref's within written documentation

Technical Reviewer: ben
QA Reviewer: frisco
Doc Reviewer: jsundman

Details:Mostly documented in the relevant bugs.

Tests:

Files:
M      WEB-INF/lps/lfc/services/LzURL.lzs
M      WEB-INF/lps/lfc/services/platform/dhtml/LzBrowser.js
M      WEB-INF/lps/lfc/services/LzGlobalMouse.lzs
M      WEB-INF/lps/lfc/views/LaszloView.lzs
M      WEB-INF/lps/lfc/views/LaszloCanvas.lzs
M      WEB-INF/lps/lfc/helpers/LzCommand.lzs
M      WEB-INF/lps/lfc/helpers/LzSelectionManager.lzs
M      WEB-INF/lps/lfc/controllers/LzAnimatorGroup.lzs
M      WEB-INF/lps/lfc/controllers/LaszloLayout.lzs
M      WEB-INF/lps/lfc/controllers/LaszloAnimation.lzs
M      WEB-INF/lps/lfc/data/LzDatapointer.lzs
M      WEB-INF/lps/lfc/data/LzDataElement.lzs
M      WEB-INF/lps/lfc/data/LzDataset.lzs
M      WEB-INF/lps/lfc/data/LzParam.lzs
D      docs/components
D      docs/components/components.lzx.test
D      docs/components/tabsliderview.lzx
D      docs/components/tabsview.lzx
D      docs/components/components.lzx
D      docs/components/listview.lzx
D      docs/components/common.lzx
D      docs/components/hierarchyview.lzx
D      docs/components/treeview.lzx
D      docs/components/formview.lzx
D      docs/components/index.html
D      docs/components/scrollbarview.lzx
D      docs/components/menuview.lzx
D      docs/components/windowview.lzx
M      docs/src/userset.dbk
A  +   docs/src/contributors
A  +   docs/src/contributors/programs
D      docs/src/contribref/doctools-ref.dbk
D      docs/src/contribref/licenses.dbk
M      docs/src/contribref/index.dbk
D      docs/src/contribref/js2doc-ref.dbk
M      docs/src/build.xml
M      docs/src/reference/preface.dbk
D      docs/src/wrappers/lz-radiogroup.html
M      docs/src/xsl/js2doc-comment2dbk.xsl
M      docs/src/xsl/js2doc2dbk.xsl
M      docs/src/xsl/common-html.xsl
M      docs/src/xsl/lzx-pretty-print.xsl
M      docs/src/xsl/parameters.xsl
A  +   docs/src/xsl/dbkpreprocessexamples.xsl
M      docs/src/deployers/architecture.dbk
M      docs/src/deployers/logging.dbk
M      docs/src/deployers/lps-request-types.dbk
M      docs/src/deployers/deployers-index.dbk
M      docs/src/deployers/deploy-preface.dbk
M      docs/src/developers/book-info.dbk
M      docs/src/developers/tutorials/drawview-intro.dbk
M      docs/src/developers/tutorials/scripting.dbk
M      docs/src/developers/tutorials/text.dbk
M      docs/src/developers/tutorials/window.dbk
M      docs/src/developers/tutorials/laszlo_basics.dbk
M      docs/src/developers/tutorials/art_assets.dbk
M      docs/src/developers/tutorials/calculator.dbk
M      docs/src/developers/tutorials/data.dbk
M      docs/src/developers/tutorials/programs/drawview-intro-$3.lzx
M      docs/src/developers/tutorials/views.dbk
M      docs/src/developers/tutorials/classes.dbk
M      docs/src/developers/browser-integration.dbk
M      docs/src/developers/index.dbk
M      docs/src/developers/persistent_connection.dbk
M      docs/src/developers/survey-chapter.dbk
M      docs/src/developers/rpc-soap.dbk
M      docs/src/developers/rpc.dbk
M      docs/src/developers/text.dbk
M      docs/src/developers/media-resources.dbk
M      docs/src/developers/methods-events-attributes.dbk
M      docs/src/developers/debugging.dbk
M      docs/src/developers/programs/views-$4.lzx
M      docs/src/developers/programs/views-$22.lzx
A  +   docs/src/developers/programs/media-resources-$9.lzx
M      docs/src/developers/programs/class-1.lzx
M      docs/src/developers/programs/debugging-$5.lzx
M      docs/src/developers/programs/program-development-$14.lzx
M      docs/src/developers/developers_guide_preface.dbk
A  +   docs/src/contribset.dbk
M      docs/includes/lzx-pretty-print.css
M      docs/includes/docbook.css
M      docs/includes/styles.css
M      docs/index.html
D      docs/devdocs.css
M      lps/components/charts/common/viewspoolmanager.lzx
M      lps/components/lz/radio.lzx
M      lps/components/lzunit/lzunit.lzx
M      lps/components/incubator/draglib.lzx
M      lps/components/incubator/rich-text/formatbtn.lzx
M      lps/components/base/basescrollbar.lzx
M      lps/components/base/image.lzx
M      lps/components/base/basedatepickerweek.lzx
M      lps/components/base/basedatepickerday.lzx
M      lps/components/base/basedatepicker.lzx

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20070709- 
jgrandyw-I.tar