Thanks for the clear information, Tucker.

On Jun 22, 2009, at 5:09 PM, P T Withington wrote:

Yeah, the doc tool chain is a problem. It's why most of us don't run it (sadly) and only find out about our doc errors when the nightly build fails.

If you are just trying to debug a particular doc page, there is a shortcut:

 cd docs/src; ant -DQUICK=true reference

Make sure the page you are interested in is referenced by either:

 WEB-INF/lps/lfc/doctestLaszloLibrary.lzs (for LFC)

or:

 lps/components/doctest-library.lzx (for components)

The -DQUICK=true option causes the doc tool to use these 'test' library specifications to build, so only builds a few pages. You will get warnings about missing things, but you can at least generate and proof a page in less than 3 hours... Just edit the library files to include what you want, but don't bother to check them in -- they are just for testing.


On 2009-06-21, at 19:44EDT, Raju Bitter wrote:

Now it ran through, took 61 min on my DualCore 2.2 ghz with 3.3 GB of RAM! What the hell! I think I remember than John once said he could build the docs in something like 35 min on his Macbook, not even a MacbookPro.

On Jun 22, 2009, at 12:10 AM, Raju Bitter wrote:

I waited for about 30 min and it never went on from that stage. How long does it take to write /Users/rajubitter/src/svn/ openlaszlo/trunk-work/docs/reference/index.html?

I'll do another test run over the night.

On Jun 21, 2009, at 10:25 PM, P T Withington wrote:

Are you seeing an error?  What makes you think it's not working?

On 2009-06-20, at 11:22EDT, Raju Bitter wrote:

I'm just building the docs, and the builds stops at docs/ reference/index.html:

....
[java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/lz.emailvalidator.html for refentry(lz.emailvalidator) [java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/lz.numbervalidator.html for refentry(lz.numbervalidator) [java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/lz.stringvalidator.html for refentry(lz.stringvalidator) [java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/lz.validatingForm.html for refentry(lz.validatingForm) [java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/topic.Incubator.Validators.html for reference(topic.Incubator.Validators) [java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/Incubator.ref.html for part(Incubator.ref) [java] Writing /Users/rajubitter/src/svn/openlaszlo/trunk-work/ docs/reference/index.html for book

Any idea what this might be?

- Raju





Reply via email to