For Programmers: Free Programming Magazines  


Home > Archive > PHP Documentation > July 2005 > Re: [PHP-DOC] Manual build failure









You are viewing an archived Text-only version of the thread. To view this thread in it's original format and/or if you want to reply to this thread please [click here]

 

Author Re: [PHP-DOC] Manual build failure
Gabor Hojtsy

2005-07-25, 5:31 pm

> All the errors from reference.xml are made by the following sequence of
> lines:
>
> [...]
> <section id='dom.class.domattr.constructor'>
> &reftitle.constructor;
> <itemizedlist>
> <listitem>
> <para><xref linkend='function.dom-domattr-construct' /> - construct a new
> DOMAttr object</para> <-- The line with error
> </listitem>
> </itemizedlist>
> </section>
> [...]
>
> All 'constructor' tables have the error. Other tables (i.e. methods table)
> are ok. What are the differences? Is the link pointed by linked? I've
> checked it, dom-domattr-construct exists. I looked for some wrong characters
> into the definition of the entity '&reftitle.constructor;', nothing, it
> seems ok.


Since the error message says something about the correlation of the para
and xref tags, either xref is not supported in this context (which I
doubt), or xref should not point to a paragraph with an ID (which is
probable). But as far as I guess, function.dom-domattr-construct is not
a para, but a complete function doc section.

Goba
Darvin Andrioli

2005-07-25, 5:31 pm

>
> construct a new
> [...]
> Since the error message says something about the correlation of the para
> and xref tags, either xref is not supported in this context (which I
> doubt), or xref should not point to a paragraph with an ID (which is
> probable). But as far as I guess, function.dom-domattr-construct is not
> a para, but a complete function doc section.

The xref points to 'refentry' tag (<refentry
id='function.dom-domattr-construct'> ), but I'm wondering why I get the error
on that line, but the following one is correct (it also points to 'refentry'
tag)

<section id='dom.class.domattr.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domattr-isid' /> - Checks if
attribute is a defined ID</para>
</listitem>
</itemizedlist>
</section>


Darvin
Darvin Andrioli

2005-07-27, 4:01 am

[...][color=darkred]
Finally, last night I was able to build the Italian manual on my system.
I got the 'unsupported para' only on one file (faq/com.xml) and not four as
Derick's build (probably his tree needs to be update) and I found out that
the error was caused by missing ID (due to an old translated file) declared
as para into missing-ids.xml.
Removed the translated file to fall back to the En version, I got "[xref to
varlistentry unsupported]".The En version has the ID "ini.com.allow-dcom"
declared as varlistentry (file reference/com/ini.xml, line 65).
I also build the En version and I got the same errors; so there is something
else to fix on my build system, or should be fixed the xref links on the En
tree?

Darvin
Gabor Hojtsy

2005-07-27, 4:01 am

>>>and xref tags, either xref is not supported in this context (which I
>
> Finally, last night I was able to build the Italian manual on my system.
> I got the 'unsupported para' only on one file (faq/com.xml) and not four as
> Derick's build (probably his tree needs to be update) and I found out that
> the error was caused by missing ID (due to an old translated file) declared
> as para into missing-ids.xml.
> Removed the translated file to fall back to the En version, I got "[xref to
> varlistentry unsupported]".The En version has the ID "ini.com.allow-dcom"
> declared as varlistentry (file reference/com/ini.xml, line 65).
> I also build the En version and I got the same errors; so there is something
> else to fix on my build system, or should be fixed the xref links on the En
> tree?


Seems like to be a problem in the EN version then.

Goba
Sponsored Links







Also available: Server administration forum archive | Web Design forum archive | Software forum archive | Hardware reviews archive

Copyright 2008 codecomments.com