[Laszlo-dev] Build of documentation stops at docs/reference/index.html

[Raju Bitter]

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
>>>>
>>>
>>
>