[Laszlo-dev] For Review: Change 20070102-jgrandyw-x Summary: Bring new refguide over to branches/legals from private working branch
P T Withington
ptw at openlaszlo.org
Thu Jan 4 03:14:32 PST 2007
I went through this fairly carefully, hoping to prevent the lossage
from the last pass where somehow comment conversion absorbed code
into a comment.
Comments:
1) My primary complaint is that some important (at least to me)
comments were dropped. As with last time, the thing that seems to
have thrown your conversion off is the use of two adjacent comments
with different comment style. In particular, the following comment
seem to have been lost:
LzProfiler:
// NOTE: [2006-06-24 ptw] This code is inlined by the compiler
method
// `meterFunctionEvent` and must be kept in sync with that.
LzDebug:
// TODO: [2006-04-20 ptw] Remove when compiler no longer references
debugger/platform/swf/kernel.as:
// Implementation of Debug.log does not depend on any of
// the LFC working and hence can be used from startup on.
2) I'm concerned that there may be other places where adjacent
comments caused a comment to be lost that I did not find with my
eyeballs. Can you think of a way we could verify that automatically?
3) In some places, FIXME/TODO's have been reformatted as @fixme @todo
and seem to have lost some annotation. Is that intentional, if so,
why? E.g.:
-// [todo: 2004-3-29 hqm] lines seem to get the ends clipped off if
you use the TextField.textWidth
+ * @todo 2004-3-29 hqm lines seem to get the ends clipped off if
you use the TextField.textWidth
(Not that Henry had the approved format, either), and:
+ * @fixme [2006-07-26] (LPP-2412) The Instance reference is
required for lzpix
+ * to run.
-// FIXME: [2006-07-26] (LPP-2412) The Instance reference is required
for lzpix
-//
Otherwise, approved.
On 2007-01-03, at 01:35 EST, Jim Grandy wrote:
> Change 20070102-jgrandyw-x by jgrandyw at jgrandy-pb.local on
> 2007-01-02 22:20:09 PST
> in /Users/jgrandyw/dev/svn/openlaszlo/branches/legals
>
> Summary: Bring new refguide over to branches/legals from private
> working branch
>
> New Features:
>
> Bugs Fixed:LPP-3342 LPP-3255 LPP-3252 LPP-3250 LPP-3254 LPP-3251
>
> Technical Reviewer: ptw
> QA Reviewer: pga
> Doc Reviewer: jsundman
>
> Documentation:
>
> Release Notes:
>
> Details: Many improvements to the new refguide. Much of the LFC
> wrapper
> page content has been moved into the LFC sources. Class refentries are
> pretty readable now. Public/private filtering works -- although it
> ended
> up being part of the dbk compile step for technical reasons. Files
> reference just lists entries rather than redundantly giving whole
> synopses. Special forms (event, method, handler, etc.) now
> documented. Components
> now documented. Many (although not all) component wrappers have
> migrated into
> corresponding source files.
>
> Added new book: the Contributor's Guide. Right now it contains full
> details of
> LZX and LFC (including private declarations), but the plan is to
> eventually
> include a cleaned-up docbook version of the Kernel API as well as
> the javadocs
> for the LPS.
>
> Contributor's Guide and Reference Guide are both built with a
> General Index,
> and are available from the docs index: docs/index.html.
>
> Note that cross-links between refguide and the other books is still
> quite
> broken. That's high on my priority list to fix.
>
> Deleted some now-obsolete Python scripts.
>
>
> Tests:
>
> Files:
> M WEB-INF/lps/schema/lzx.rnc
> M WEB-INF/lps/lfc/kernel/svg/LzSprite.js
> M WEB-INF/lps/lfc/kernel/svg/LzInputTextSprite.js
> M WEB-INF/lps/lfc/kernel/svg/LzTextSprite.js
> M WEB-INF/lps/lfc/kernel/swf/LzSoundMC.as
> M WEB-INF/lps/lfc/kernel/swf/LzLibrary.lzs
> M WEB-INF/lps/lfc/kernel/swf/LzTextSprite.as
> M WEB-INF/lps/lfc/kernel/swf/LzLoader.lzs
> M WEB-INF/lps/lfc/kernel/swf/LzMediaLoader.lzs
> M WEB-INF/lps/lfc/kernel/swf/LzLoadQueue.as
> M WEB-INF/lps/lfc/kernel/swf/LzInputTextSprite.as
> M WEB-INF/lps/lfc/kernel/swf/LzFontManager.as
> M WEB-INF/lps/lfc/kernel/swf/LzMakeLoadSprite.as
> M WEB-INF/lps/lfc/kernel/swf/LzHTTPLoader.as
> M WEB-INF/lps/lfc/kernel/swf/LzSprite.as
> M WEB-INF/lps/lfc/kernel/dhtml/LzSprite.js
> M WEB-INF/lps/lfc/profiler/LzProfile.lzs
> M WEB-INF/lps/lfc/services/LzKeys.as
> M WEB-INF/lps/lfc/services/platform/swf/LzModeManager.as
> M WEB-INF/lps/lfc/services/platform/dhtml/LzModeManager.js
> M WEB-INF/lps/lfc/services/platform/dhtml/LzCursor.js
> M WEB-INF/lps/lfc/services/LzTrack.js
> M WEB-INF/lps/lfc/services/LzCursor.as
> M WEB-INF/lps/lfc/services/LzGlobalMouse.lzs
> M WEB-INF/lps/lfc/services/LzIdle.lzs
> M WEB-INF/lps/lfc/services/LzBrowser.as
> M WEB-INF/lps/lfc/services/LzFocus.lzs
> M WEB-INF/lps/lfc/services/LzInstantiator.lzs
> M WEB-INF/lps/lfc/services/LzKeys.js
> M WEB-INF/lps/lfc/services/LzModeManager.lzs
> M WEB-INF/lps/lfc/services/LzTimer.lzs
> M WEB-INF/lps/lfc/services/LzBrowser.js
> M WEB-INF/lps/lfc/services/LzHistory.as
> M WEB-INF/lps/lfc/services/LzStyleSheet.js
> M WEB-INF/lps/lfc/services/LzTrack.as
> M WEB-INF/lps/lfc/debugger/LzMessage.lzs
> M WEB-INF/lps/lfc/debugger/LzDebug.lzs
> M WEB-INF/lps/lfc/debugger/platform/swf/LzMemory.as
> M WEB-INF/lps/lfc/debugger/platform/swf/LzFlashRemote.as
> M WEB-INF/lps/lfc/debugger/platform/swf/kernel.as
> M WEB-INF/lps/lfc/debugger/platform/swf/LzRemote.as
> M WEB-INF/lps/lfc/debugger/platform/swf/LzDebug.as
> M WEB-INF/lps/lfc/debugger/platform/dhtml/LzDebug.js
> M WEB-INF/lps/lfc/debugger/platform/dhtml/kernel.js
> M WEB-INF/lps/lfc/debugger/LzMonitor.lzs
> M WEB-INF/lps/lfc/debugger/LzFormat.lzs
> M WEB-INF/lps/lfc/debugger/LzCompiler.lzs
> M WEB-INF/lps/lfc/debugger/LzTrace.lzs
> M WEB-INF/lps/lfc/debugger/LzBacktrace.lzs
> M WEB-INF/lps/lfc/lzpreloader.as
> M WEB-INF/lps/lfc/core/LzDictionary.lzs
> M WEB-INF/lps/lfc/core/LzNode.lzs
> M WEB-INF/lps/lfc/core/LzConstants.lzs
> M WEB-INF/lps/lfc/core/UserClass.lzs
> M WEB-INF/lps/lfc/core/Class.lzs
> M WEB-INF/lps/lfc/core/LzDefs.lzs
> M WEB-INF/lps/lfc/glue/LaszloInitiator.lzs
> M WEB-INF/lps/lfc/views/LzInputText.lzs
> M WEB-INF/lps/lfc/views/LzScript.lzs
> M WEB-INF/lps/lfc/views/LzText.lzs
> M WEB-INF/lps/lfc/views/LzViewLinkage.lzs
> M WEB-INF/lps/lfc/views/platform/swf/LzDrawView.lzs
> M WEB-INF/lps/lfc/views/platform/swf/LzContextMenu.lzs
> M WEB-INF/lps/lfc/views/platform/swf/LzPlatform.as
> M WEB-INF/lps/lfc/views/platform/dhtml/LzDrawView.lzs
> M WEB-INF/lps/lfc/views/LaszloView.lzs
> M WEB-INF/lps/lfc/views/LaszloCanvas.lzs
> M WEB-INF/lps/lfc/LaszloLibrary.lzs
> M WEB-INF/lps/lfc/helpers/LzFont.lzs
> M WEB-INF/lps/lfc/helpers/LzCommand.lzs
> M WEB-INF/lps/lfc/helpers/LzSelectionManager.lzs
> M WEB-INF/lps/lfc/helpers/LzState.lzs
> M WEB-INF/lps/lfc/events/LaszloEvents.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/LzLazyReplicationManager.lzs
> M WEB-INF/lps/lfc/data/LzReplicationManager.lzs
> M WEB-INF/lps/lfc/data/platform/swf/LzConnectionDatasource.lzs
> M WEB-INF/lps/lfc/data/platform/swf/LzConnection.lzs
> M WEB-INF/lps/lfc/data/LzDatapointer.lzs
> M WEB-INF/lps/lfc/data/LzDataText.lzs
> M WEB-INF/lps/lfc/data/LzDataNode.lzs
> M WEB-INF/lps/lfc/data/LzDataElement.lzs
> M WEB-INF/lps/lfc/data/LzDataset.lzs
> M WEB-INF/lps/lfc/data/LzDatapath.lzs
> M WEB-INF/lps/lfc/data/LzResizeReplicationManager.lzs
> M WEB-INF/lps/lfc/data/LzDatasource.lzs
> M WEB-INF/lps/lfc/data/LzHTTPDatasource.lzs
> M WEB-INF/lps/lfc/data/LzParsedPath.lzs
> M WEB-INF/lps/lfc/data/LzParam.lzs
> M WEB-INF/lps/lfc/data/LzDataAttrBind.lzs
> M WEB-INF/lps/lfc/compiler/LzRuntime.lzs
> M WEB-INF/lps/server/src/org/openlaszlo/js2doc/Schema_Test.java
> M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
> test_include.xml
> M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
> LaszloEvents.xml
> 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/js2doc.rnc
> M WEB-INF/lps/server/src/org/openlaszlo/compiler/
> ClassCompiler.java
> M WEB-INF/lps/server/src/org/openlaszlo/compiler/ViewSchema.java
> M WEB-INF/lps/server/src/org/openlaszlo/compiler/NodeModel.java
> M WEB-INF/lps/server/build.xml
> D docs/src/HTMLPage.py
> D docs/src/config.py
> D docs/src/HTMLWrapper.py
> A + docs/src/contributors
> A + docs/src/contributors/book-info.dbk
> A + docs/src/contributors/preface.dbk
> A + docs/src/contributors/index.dbk
> M docs/src/build.xml
> D docs/src/XMLDocs.py
> D docs/src/categories.txt
> D docs/src/tiers.txt
> D docs/src/Text.py
> D docs/src/element.py
> D docs/src/makeXML.py
> D docs/src/makeHTML.py
> A + docs/src/reference/images
> A + docs/src/reference/images/resizelayout
> A + docs/src/reference/images/tabelement
> A + docs/src/reference/images/basetabs
> A + docs/src/reference/images/wrappinglayout
> A + docs/src/reference/images/basebutton
> A + docs/src/reference/images/stableborderlayout
> A + docs/src/reference/images/multistatebutton
> A + docs/src/reference/images/simplelayout
> A + docs/src/reference/images/tabslider
> A + docs/src/reference/images/basetree
> A + docs/src/reference/images/view
> A + docs/src/reference/images/simpleinputtext
> M docs/src/reference/index.dbk
> A + docs/src/reference/data
> A + docs/src/reference/resources
> A + docs/src/reference/resources/autoPng
> D docs/src/build/redmond-button.xml
> D docs/src/build/redmond-windowtext.xml
> D docs/src/build/redmond-radio.xml
> D docs/src/build/redmond-tabview.xml
> D docs/src/build/redmond-windowframe.xml
> D docs/src/build/redmond-menuitem.xml
> D docs/src/build/redmond-scrollbar.xml
> D docs/src/build/redmond-menu.xml
> D docs/src/build/redmond-menuseparator.xml
> D docs/src/build/redmond-checkbox.xml
> D docs/src/build/redmond-window.xml
> D docs/src/build/redmond-combobox.xml
> D docs/src/build/redmond-menubar.xml
> D docs/src/wrappers/state.html
> D docs/src/wrappers/lzmodemanager.html
> D docs/src/wrappers/multistatebutton.html
> D docs/src/wrappers/basecomponent.html
> D docs/src/wrappers/lzcanvasgradient.html
> D docs/src/wrappers/connection.html
> D docs/src/wrappers/style.html
> D docs/src/wrappers/submit.html
> D docs/src/wrappers/lzparam.html
> D docs/src/wrappers/import.html
> D docs/src/wrappers/basetabscontent.html
> D docs/src/wrappers/include.html
> D docs/src/wrappers/swatchview.html
> D docs/src/wrappers/text.html
> D docs/src/wrappers/basescrollthumb.html
> D docs/src/wrappers/basetree.html
> D docs/src/wrappers/lzresizereplicationmanager.html
> D docs/src/wrappers/basebuttonrepeater.html
> D docs/src/wrappers/hbox.html
> D docs/src/wrappers/basedatepickerday.html
> D docs/src/wrappers/baselist.html
> D docs/src/wrappers/view.html
> D docs/src/wrappers/vbox.html
> D docs/src/wrappers/dragstate.html
> D docs/src/wrappers/lzcursor.html
> D docs/src/wrappers/baseform.html
> D docs/src/wrappers/basegridcolumn.html
> D docs/src/wrappers/splash-view.html
> D docs/src/wrappers/images
> D docs/src/wrappers/images/resizelayout
> D docs/src/wrappers/images/resizelayout/resizelayout_image1.jpg
> D docs/src/wrappers/images/resizelayout/resizelayout_image2.jpg
> D docs/src/wrappers/images/tabelement
> D docs/src/wrappers/images/tabelement/tabelement_image1.jpg
> D docs/src/wrappers/images/logo.png
> D docs/src/wrappers/images/basetabs
> D docs/src/wrappers/images/basetabs/tabs-diagram.gif
> D docs/src/wrappers/images/wrappinglayout
> D docs/src/wrappers/images/wrappinglayout/
> wrappinglayout_image1.jpg
> D docs/src/wrappers/images/wrappinglayout/
> wrappinglayout_image2.jpg
> D docs/src/wrappers/images/basebutton
> D docs/src/wrappers/images/basebutton/button-up.png
> D docs/src/wrappers/images/basebutton/button-down.png
> D docs/src/wrappers/images/basebutton/button-over.png
> D docs/src/wrappers/images/stableborderlayout
> D docs/src/wrappers/images/stableborderlayout/
> stableborderlayout_image1.jpg
> D docs/src/wrappers/images/multistatebutton
> D docs/src/wrappers/images/multistatebutton/state0-mouseover.jpg
> D docs/src/wrappers/images/multistatebutton/state1-mouseover.jpg
> D docs/src/wrappers/images/multistatebutton/state0-mouseup.jpg
> D docs/src/wrappers/images/multistatebutton/state1-mouseup.jpg
> D docs/src/wrappers/images/multistatebutton/state0-mousedown.jpg
> D docs/src/wrappers/images/multistatebutton/state1-mousedown.jpg
> D docs/src/wrappers/images/simplelayout
> D docs/src/wrappers/images/simplelayout/simplelayout1.jpg
> D docs/src/wrappers/images/simplelayout/simplelayout2.jpg
> D docs/src/wrappers/images/simplelayout/simplelayout3.jpg
> D docs/src/wrappers/images/tabslider
> D docs/src/wrappers/images/tabslider/tabslider_image1.png
> D docs/src/wrappers/images/tabslider/tabslider_image2.png
> D docs/src/wrappers/images/basetree
> D docs/src/wrappers/images/basetree/basetree-diagram.png
> D docs/src/wrappers/images/view
> D docs/src/wrappers/images/view/view_image4.jpg
> D docs/src/wrappers/images/view/view_image5.jpg
> D docs/src/wrappers/images/view/view_image0.jpg
> D docs/src/wrappers/images/view/view_image1.jpg
> D docs/src/wrappers/images/view/view_image2.jpg
> D docs/src/wrappers/images/view/view_image3.jpg
> D docs/src/wrappers/images/simpleinputtext
> D docs/src/wrappers/images/simpleinputtext/
> simpleinputtext_image.jpg
> D docs/src/wrappers/basecombobox.html
> D docs/src/wrappers/replicationmanager.html
> D docs/src/wrappers/event-declaration.html
> D docs/src/wrappers/basetabpane.html
> D docs/src/wrappers/lzdatatext.html
> D docs/src/wrappers/lztimer.html
> D docs/src/wrappers/resizestate.html
> D docs/src/wrappers/library.html
> D docs/src/wrappers/basedatepicker.html
> D docs/src/wrappers/resources
> D docs/src/wrappers/resources/poof.mp3
> D docs/src/wrappers/resources/contactsdata.xml
> D docs/src/wrappers/resources/autoPng
> D docs/src/wrappers/resources/autoPng/lzwaitcursor_rsc.png
> D docs/src/wrappers/resources/lzwaitcursor_rsc.swf
> D docs/src/wrappers/basegrid.html
> D docs/src/wrappers/lzfocus.html
> D docs/src/wrappers/attribute.html
> D docs/src/wrappers/script.html
> D docs/src/wrappers/basefocusview.html
> D docs/src/wrappers/basetabsbar.html
> D docs/src/wrappers/basescrollbar.html
> D docs/src/wrappers/method.html
> D docs/src/wrappers/basedatepickerweek.html
> D docs/src/wrappers/lzdatanode.html
> D docs/src/wrappers/lzbrowser.html
> D docs/src/wrappers/httpdatasource.html
> D docs/src/wrappers/lzcontextmenuitem.html
> D docs/src/wrappers/lzlazyreplicationmanager.html
> D docs/src/wrappers/basetabelement.html
> D docs/src/wrappers/basetrackgroup.html
> D docs/src/wrappers/command.html
> D docs/src/wrappers/basescrolltrack.html
> D docs/src/wrappers/lzglobalmouse.html
> D docs/src/wrappers/basetabs.html
> D docs/src/wrappers/baselistitem.html
> D docs/src/wrappers/basevaluecomponent.html
> D docs/src/wrappers/basescrollarrow.html
> D docs/src/wrappers/data
> D docs/src/wrappers/data/columnchart-data-example1.xml
> D docs/src/wrappers/data/ebay.xml
> D docs/src/wrappers/data/columnchart-data-example2.xml
> D docs/src/wrappers/data/ebay1.xml
> D docs/src/wrappers/data/ebay1000.xml
> D docs/src/wrappers/data/simple-redsox-data.xml
> D docs/src/wrappers/data/pie-data.xml
> D docs/src/wrappers/data/pie-data2.xml
> D docs/src/wrappers/data/simple.xml
> D docs/src/wrappers/data/redsox-data.xml
> D docs/src/wrappers/data/redsox-data1.xml
> D docs/src/wrappers/data/redsox-data2.xml
> D docs/src/wrappers/basebutton.html
> D docs/src/wrappers/dataselectionmanager.html
> D docs/src/wrappers/handler.html
> D docs/src/wrappers/baseslider.html
> D docs/src/wrappers/baseformitem.html
> D docs/src/wrappers/image.html
> D docs/src/wrappers/lzidle.html
> D docs/src/wrappers/debug.html
> D docs/src/wrappers/splash.html
> D docs/src/wrappers/basedatacombobox.html
> D docs/src/wrappers/basetabslider.html
> D docs/src/wrappers/connectiondatasource.html
> D docs/src/wrappers/lztrack.html
> D docs/src/LZXConcepts.py
> D docs/src/xsl/redmond-components.xsl
> M docs/src/xsl/synop-javascript.xsl
> D docs/src/xsl/reference-nav.xsl
> D docs/src/xsl/reference-toc.xsl
> A + docs/src/xsl/js2doc-verbose.xsl
> M docs/src/xsl/js2doc-comment2dbk.xsl
> M docs/src/xsl/js2doc2dbk.xsl
> M docs/src/xsl/js2doc2topics.xsl
> M docs/src/xsl/js2doc2xref.xsl
> M docs/src/xsl/refguide-html.xsl
> M docs/src/xsl/common-html.xsl.proto
> M docs/src/xsl/parameters.xsl
> D docs/src/globals.py
> M docs/includes/docbook.css
> M docs/index.html
> M lps/components/extensions/library.lzx
> M lps/components/extensions/av/library.lzx
> M lps/components/utils/layouts/library.lzx
> M lps/components/utils/library.lzx
> M lps/components/utils/states/library.lzx
> M lps/components/utils/states/dragstate.lzx
> M lps/components/utils/states/resizestate.lzx
> M lps/components/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/lz/edittext.lzx
> M lps/components/lzunit/library.lzx
> M lps/components/incubator/custombutton.lzx
> M lps/components/incubator/fisheye_lib.lzx
> M lps/components/incubator/boxview.lzx
> A + lps/components/incubator/library.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/datalistselector.lzx
> M lps/components/base/basebutton.lzx
> M lps/components/base/basegridrow.lzx
> M lps/components/base/basetabelement.lzx
> M lps/components/base/basescrollbar.lzx
> M lps/components/base/image.lzx
> M lps/components/base/basedatepickerweek.lzx
> M lps/components/base/swatchview.lzx
> M lps/components/base/baselistitem.lzx
> M lps/components/base/multistatebutton.lzx
> M lps/components/base/basetree.lzx
> M lps/components/base/componentmanager.lzx
> M lps/components/base/basecomponent.lzx
> M lps/components/base/basebuttonrepeater.lzx
> M lps/components/base/hbox.lzx
> M lps/components/base/basewindow.lzx
> M lps/components/base/basecombobox.lzx
> M lps/components/base/submit.lzx
> M lps/components/base/library.lzx
> M lps/components/base/basetabslider.lzx
> M lps/components/base/basedatepickerday.lzx
> M lps/components/base/basefocusview.lzx
> M lps/components/base/basedatepicker.lzx
> M lps/components/base/baselist.lzx
> M lps/components/base/basetrackgroup.lzx
> M lps/components/base/baseslider.lzx
> M lps/components/base/baseformitem.lzx
> M lps/components/base/vbox.lzx
> M lps/components/base/basegrid.lzx
> M lps/components/base/basetabs.lzx
> M lps/components/base/basevaluecomponent.lzx
> M lps/components/base/basedatacombobox.lzx
> M lps/components/base/baseform.lzx
> M lps/components/base/basegridcolumn.lzx
> M lps/components/base/style.lzx
>
> Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20070102-
> jgrandyw-x.tar
More information about the Laszlo-dev
mailing list