<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div>Comments:</div><div>---- In datareplication.dbk:</div><div><br></div><div> <H2>Tags/APIs discussed in this chapter</h2></div><div> <ul></div><div> <li><classname link="true">LzDataElement</classname></li></div><div> <li><classname link="true">LzDataNode</classname></li></div><div> <li><classname link="true">LzDataText</classname></li></div><div> <li><classname link="true">LzDatapointer</classname></li></div><div> <li><classname link="true">lz.datapath</classname></li></div><div> <li><classname link="true">LzReplicationManager</classname></li></div><div> <li><classname link="true">LzLazyReplicationManager</classname></li></div><div> <li><classname link="true">lz.dataselectionmanager</classname></li></div><div> </ul></div><div><br></div><div>some of these are lz.* and some are not. I don't know how <classname> is used, will</div><div>it be able to make a link correctly?</div><div><br></div><div>---- In doc-backwards-xform.dbk, there are problems with all the diffs, since they apply to internal lzs coding,</div><div>where developers must have knowledge of the 'real' class names.</div><div><br></div><div>1)</div><div><div> Turn to lz.text.lzs, to find where these variables were declared:</para></div><div><br></div><div>the names of source files have not changed. Should be LzText.lzs .</div><div><br></div><div>2)</div><div><div> &lt;class extends=&quot;lz.view&quot;&gt;</div><div> &lt;property access=&quot;private&quot; id=&quot;lz.text.tagname&quot; <emphasis>name=&quot;tagname&quot; value=&quot;text&quot;&gt;</emphasis>&lt;!-- region 6 --&gt;</div><div><br></div></div><div>should be LzText.tagname since the classnames have not changed intenally.</div><div><br></div><div>3)</div><div><div> &lt;property id=&quot;lz.text.prototype.format&quot; <emphasis>name=&quot;format&quot;</emphasis>&lt;!-- regions 1, 2 --&gt; </div><div><br></div><div>This is talking about <property> generated by the doc tool -- The property should be LzText.prototype.format</div><div><br></div><div>4)</div><div><div> Formats its arguments using &lt;xref linkend=&quot;lz.Formatter.formatToString&quot;/&gt; and sets the text of the</div><div><br></div><div><div><div>It's still LzFormatter.formatToString for linkend . Unfortunately, anyone working at the lzs level needs to know</div><div>that the names of classes internally are LzFoo, and that is what the doc tools use.</div><div>Perhaps we need to add something to the content to say this.</div><div><br></div></div></div></div><div>5)</div></div><div><div> <para>To carry this reasoning all the way back to the javascript code definining the method, in <literal>WEB-INF/lps/lfc/views/lz.text.lzs</literal>:</para></div><div><br></div><div>Again LzText.lzs</div><div><br></div><div>6)</div><div><div> * linkend=&quot;lz.Formatter.formatToString&quot;/&gt; and sets the text of the</div><div><br></div><div>Should be LzFormatter.formatToString when used with linkend</div><div><br></div><div><br></div><div>---- input-gestures.dbk</div><div><br></div><div><div>this can be accomplished by defining a custom resource for the cursor and using it with LzCursor service as shown below.</div><div><br></div><div>should be lz.Cursor service</div><div><br></div><div>(I think you figured out, and I should have mentioned that for services, the class name LzCursorService translates to lz.Cursor.</div><div>I think the class name used to be LzCursor, so it's still a simple transition for programmers)</div><div><br></div></div><div>---- media-resourse.dbk</div><div><br></div><div><div> <literal>LzView.play()</literal> method. Conversely, when</div><div><br></div><div>lz.view.play() </div><div><br></div><div>---- rpc-javarpc.dbk</div><div><br></div><div><div><para>lz.rpc can be found in <literal>$LPS_HOME/lps/components/rpc/library/lz.rpc.js</literal>.</para></div><div><br></div></div><div>File name is $LPS_HOME/lps/components/rpc/library/rpc.js</div><div><br></div><div>---- rpc.dbk</div><div><br></div><div><div><para><indexterm significance="preferred"><primary>dataobject</primary></indexterm><glossterm>dataobject</glossterm>: (Dataset|lz.DataElement) if set, the return value will</div><div><br></div><div>Should be (lz.dataset|lz.DataElement)</div><div><br></div><div><br></div><div>---- states.dbk</div><div><br></div><div><div> as in, for example, <literal>an lz.node.setParent(otherlz.node)</literal>, but it's not). </div><div><br></div><div>Better: lz.node.setParent(otherNode)</div></div><div><br></div></div></div></div></div></div></div><div>---- Not your error, but noticed in passing:</div><div>Misspelled Browser in doc-toolchain.dbk</div><div><br></div><div>+ <entry>the <literal>lz.Browswer</literal> class, as it exists only in the dhtml runtime.</entry></div><div><br></div><div>Otherwise, approved!</div><div><br></div><div><div>On Aug 25, 2008, at 11:36 AM, Lou Iorio wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>Change 20080825-lou-j by <a href="mailto:lou@loumac.local">lou@loumac.local</a> on 2008-08-25 11:19:43 AST<br> in /Users/lou/src/svn/openlaszlo/trunk<br> for <a href="http://svn.openlaszlo.org/openlaszlo/trunk">http://svn.openlaszlo.org/openlaszlo/trunk</a><br><br>Summary: dguide: make sure classes and tags are up to date, e.g., lz.text instead of LzText<br><br>Bugs Fixed: LPP-6878, LPP-6869 (partial)<br><br>Technical Reviewer: donald anderson<br>QA Reviewer: (pending)<br>Doc Reviewer: (pending)<br><br>Details: interim checkin so Don can review what's done so far.<br><br>Tests: ant clean build doc, visual verify<br>grep Lz[A-Z]<br><br>Files:<br>M docs/src/developers/lzunit.dbk<br>M docs/src/developers/classes-powerprogramming.dbk<br>M docs/src/developers/components-design.dbk<br>M docs/src/developers/delegates.dbk<br>M docs/src/developers/performance.dbk<br>M docs/src/developers/rpc-javarpc.dbk<br>M docs/src/developers/initialization-and-instantiation.dbk<br>M docs/src/developers/rpc-soap.dbk<br>M docs/src/developers/rpc.dbk<br>M docs/src/developers/media-resources.dbk<br>M docs/src/developers/fonts.dbk<br>M docs/src/developers/debugging.dbk<br>M docs/src/developers/doc-toolchain.dbk<br>M docs/src/developers/doc-backwards-xform.dbk<br>M docs/src/developers/input-gestures.dbk<br>M docs/src/developers/classes-introductory.dbk<br>M docs/src/developers/states.dbk<br>M docs/src/developers/browser-integration.dbk<br>M docs/src/developers/animation.dbk<br>M docs/src/developers/layout-and-design.dbk<br>M docs/src/developers/language-preliminaries.dbk<br>M docs/src/developers/text.dbk<br>M docs/src/developers/programs/databinding-$14.lzx<br>M docs/src/developers/programs/databinding-$19.lzx<br>M docs/src/developers/programs/databinding-$16.lzx<br>M docs/src/developers/programs/data-accessing-lzdataelement.lzx<br>M docs/src/developers/structure.dbk<br>M docs/src/developers/datareplication.dbk<br>M docs/src/developers/databinding.dbk<br>M docs/src/developers/constraints.dbk<br><br><br>Changeset: <a href="http://svn.openlaszlo.org/openlaszlo/patches/20080825-lou-j.tar">http://svn.openlaszlo.org/openlaszlo/patches/20080825-lou-j.tar</a><br></div></blockquote></div><br><div> <span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><br class="Apple-interchange-newline">--</div><div><br>Don Anderson<br>Java/C/C++, Berkeley DB, systems consultant<br><br>voice: 617-547-7881<br>email: <a href="mailto:dda@ddanderson.com">dda@ddanderson.com</a><br>www: <a href="http://www.ddanderson.com/">http://www.ddanderson.com</a><br></div></div></span></span><br class="Apple-interchange-newline"></div></span></div></span><br class="Apple-interchange-newline"> </div><br></body></html>