... 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. > > > >

