> [xref on para is not supported]
> 
> The id xref is linking to, is missing in the de-tree, but present in the
> missing-ids.xml file:
> <para id="ini.com.allow-dcom"></para>
> 
> In the english file in question (faq/com.xml) xref is used like:
> <xref linkend="ini.com.allow-dcom"/>
> As this points to <para id="ini.com.allow-dcom"></para> in
> missing-ids.xml for the de tree, obviously no link text can be produced.
> 
> This should not affect the building prozess,(it's only a warning) but
> renders not very nice:
> http://www.php.net/manual/de/faq.com.php#faq.com.q8
> The link text ist empty.
> Anything we can do about?
> 
> Possibilities (other than updating the german manual ;-)):
> 1.) use xreflabel
> 2.) produce content for the para's in missing-ids.xml
> 3.) split the faq

No splitting will help this error message popping up, since it occurs in
different places in different translations. It can happen anytime you
have an outdated file in your translation. The "problem" is the
increased usage of <xref>. Previously authors were encouraged to use
<link> to add internal links, which requires text content, so this was
no problem. The adoption of <xref> lead to this problem.

1. What would we put into <para xreflabel="..."> in place of the dots in
the missing-ids.xml file?

2. How would this be better then the previous option?

3. This is not just a faq problem. True, there are some big files in the
FAQ folder..

Goba

Reply via email to