... and, I presume, to add this declaration to my templates so that  
future modules include this declaration from the outset. Consider it  
done. Thank you for the explanation.

On Jul 23, 2009, at 9:22 AM, Hussein Shafie <hussein at xmlmind.com> wrote:

> Sundial Services wrote:
>>
>> As for the future...  putting (say) "<!DOCTYPE>" declarations into a
>> few hundred files is short-work for a Perl script.  (But will this
>> confuse things if the file starts with "<refentry>?"  Only one way to
>> find out, I guess...)
>>
>
> There are two ways to write clean, ``portable'', modular documents:
>
> [A] Use references to external entities and in such case, an included
> file must *not* start with <!DOCTYPE>.
>
> If this is not the case, the XML parser will reject your master  
> document
> as non-well-formed.
>
> [B] OR Use XIncludes  and in such case, the included file (e.g. a
> refentry) must really start with the proper <!DOCTYPE> (e.g. <!DOCTYPE
> refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>)
>
> If this is not the case, XML processors such as Xerces or xmllint will
> fail to process any XInclude making use of an element ID (e.g.
> <xi:include href="my_function.xml" xpointer="examples"/>)
>
> Therefore, now that we know that you use XIncludes, we really  
> recommend
> that you write and run this Perl script in order to add the proper
> <!DOCTYPE> to your numerous XML files.
>
>
>
>

Reply via email to