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

[John Sundman]

I'm giving this proforma approval, since these are all agreed  
changes, and others are doing technical and qa review.

I am very pleased and excited to see these going in.

Thank you!

jrs

On Jul 9, 2007, at 2:30 PM, Jim Grandy wrote:

> 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