The reason the warning was there was that the 4.x doc was missing stuff<br>that was in the 3.4 doc. Some things just got lost in the transition from HTML<br>to XML. (I'm guessing; that was before my time.) For example, entire "See<br>
Also" sections (lists of links to related docs) were omitted entirely.<br><br>Can't you use the 4.0.18 doc? That would seem to be the safest thing. If not,<br>I agree with Tucker.<br><br><div class="gmail_quote">
On Mon, Sep 21, 2009 at 11:50 AM, P T Withington <span dir="ltr"><<a href="mailto:ptw@pobox.com">ptw@pobox.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Well that warning will never go away in the 4.0 line, as that line is no longer actively developed.<br>
<br>
The major API changes came with 4.2 (which we all know in hindsight should have been 5.0).<br>
<br>
But, unless you are doing something pretty obscure, you should be able to use either doc set. Our goal is to try to maintain compatibility.<div><div></div><div class="h5"><br>
<br>
On Sep 21, 2009, at 11:05, Raju Bitter <<a href="mailto:rajubitter@me.com" target="_blank">rajubitter@me.com</a>> wrote:<br>
<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Good question. I still see the warning for the reference guide for OL 4.0.18: Documentation in progress: please use the 3.4 Reference Manual<br>
<br>
It was initally added here: <a href="http://jira.openlaszlo.org/jira/browse/LPP-4539" target="_blank">http://jira.openlaszlo.org/jira/browse/LPP-4539</a> , for OL 4.0.6<br>
<br>
John's comment: "The OpenLaszlo 4.x Reference Manual is alpha quality. The information on this page is believed to be correct, but some information may be missing. We recommend using the OpenLaszlo 3.4 Reference Manual, since the APIs are essential identical between OL 3.4 and OL 4.x. The OpenLaszlo 4.0.5 Developer's Guide should be used in preference to the OL 3.4 Developer's Guide, however."<br>
<a href="http://jira.openlaszlo.org/jira/browse/LPP-5436" target="_blank">http://jira.openlaszlo.org/jira/browse/LPP-5436</a> And updated for 4.0.10<br>
<br>
Didn't find anything else in JIRA on it.<br>
<br>
On Sep 21, 2009, at 4:44 PM, P T Withington wrote:<br>
<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Are there not docs for 4.0? IIRC the main reason the 4.0 docs referred you to the 3.4 docs was because the new doc tools didn't make pretty enough documentation. Not because the documentation was wrong. But, maybe I mis-remember.<br>
<br>
On 2009-09-21, at 10:28, Raju Bitter wrote:<br>
<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Which is the best documentation available for OL 4.0.18? Should we use 3.4, or rather the OL 4.1 docs?<br>
<br>
Thanks,<br>
Raju<br>
</blockquote>
<br>
</blockquote>
<br>
</blockquote>
</div></div></blockquote></div><br>