The reason the warning was there was that the 4.x doc was missing stuff that was in the 3.4 doc. Some things just got lost in the transition from HTML to XML. (I'm guessing; that was before my time.) For example, entire "See Also" sections (lists of links to related docs) were omitted entirely.
Can't you use the 4.0.18 doc? That would seem to be the safest thing. If not, I agree with Tucker. On Mon, Sep 21, 2009 at 11:50 AM, P T Withington <[email protected]> wrote: > Well that warning will never go away in the 4.0 line, as that line is no > longer actively developed. > > The major API changes came with 4.2 (which we all know in hindsight should > have been 5.0). > > 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. > > > On Sep 21, 2009, at 11:05, Raju Bitter <[email protected]> wrote: > > 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 >> >> It was initally added here: >> http://jira.openlaszlo.org/jira/browse/LPP-4539 , for OL 4.0.6 >> >> 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." >> http://jira.openlaszlo.org/jira/browse/LPP-5436 And updated for 4.0.10 >> >> Didn't find anything else in JIRA on it. >> >> On Sep 21, 2009, at 4:44 PM, P T Withington wrote: >> >> 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. >>> >>> On 2009-09-21, at 10:28, Raju Bitter wrote: >>> >>> Which is the best documentation available for OL 4.0.18? Should we use >>>> 3.4, or rather the OL 4.1 docs? >>>> >>>> Thanks, >>>> Raju >>>> >>> >>> >>
