Re: Call for help about html_css doc pages

Laurent Laville wrote:
> Mark Wiesemann a écrit :
>> Hi Laurent,
>>
>> Laurent Laville wrote:
>>> As you've perharps noticed, I tried to include (following PEAR manual 
>>> standard/examples) html_css doc, but there are still few errors
>>>
>>> See : http://peardoc.m-takagi.org/en/build.log
>> Didn't you read my commit message? You'll "simply" have to change two
>> files (in which you aren't following the examples). If you correct the
>> nesting of your files, the error (it's basically only one that occurs
>> multiple times) should be gone.
>>
> 
> Mark,
> 
> Sorry but I don't understand. I've followed html quickform example which 
>   seems to be equal than html css, but don't use the
> 
> <?xml version="1.0" encoding="iso-8859-1" ?>
> 
> you've added on previous commit.

That's not the problem here. (I thought that this line would be missing, 
but I was wrong. It doesn't hurt to have it.)

There are two problems:

(1) In html-css.xml you have these two lines inside the <sect2> tag:
   &package.html.html-css.faq;
   &package.html.html-css.whatsnew;

If you put these two "references" into another <sect3> tag, the first 
errors are gone. (Note: The refs to "...api;" and "...errorhandler;" are 
fine. The system only doesn't like the combination of <sect2> and <sect3>.)

(2) api.xml won't work in the current way. References to e.g. 
&package.html.html-css.html-css.html-css; are not allowed inside 
<refsect1>. I'm not a Docbook expert but I guess that you'll need to 
follow the example of html-css.xml (using <sect*>).

Regards,
Mark

-- 
http://www.markwiesemann.eu