[38646] trunk/doc-new/guide

[Bryan Blackburn]

On Jul 29, 2008, at 1:07 AM, Caspar Florian Ebeling wrote:

>>>> Thanks for catching that. Is there some script I'm meant to run  
>>>> before
>>>> committing changes to the documentation, to make sure I'm not  
>>>> breaking
>>>> something?
>>>
>>> Just do a "make guide" or "make guide-chunked" in doc-new/. If it  
>>> runs
>>> without errors it should be ok, but you can visually check in the  
>>> sub-dir
>>> guide/html.
>>
>> Building the guide with docbook takes very long in my opinion.  
>> There is also
>> a quicker 'make validate' which just checks for syntax errors before
>> building.
>
> make guide takes 6.5 seconds on my machine, which is quick enough  
> for me,
> but the make validate takes only 2, so for just verifying while  
> editing this is
> even better, of course.
>

If it takes significantly longer than this for anyone, check to see if  
you have XML_CATALOG_FILES set in your environment.  I did, and it  
kept downloading stuff, so I killed it after 8.5 minutes...once I  
unset it, it took about as long as it did for Florian.

Bryan


> Florian
>
> -- 
> Florian Ebeling
> florian.ebeling at gmail.com