[Usability] Re: Making GNOME documentation suitable for different distros.

[James Henstridge <james daa com au>]

On 16/10/2003 6:10 AM, Malcolm Tredinnick wrote:

> Note, also, that the parameter-entity method works transparently if you
>
> are XIncluding other documents (i.e. it is not an either/or choice): you
> need to include the PE reference in each document's DOCTYPE, but there
> are no double-definition problems or anything.
>  
XIncludes are beneficial if you can't augment the DTD for the document.  
The case I can think of is where a document is assembled using a number 
of system entities -- the files expanded as entities can't define their 
own entities.  Of course, if you control the top level document, this 
isn't a problem.  It might be a problem if you include the same fragment 
in a number of documents.

The other reason people might prefer XIncludes is the increased locality 
-- with entities, you need more of a global knowledge of the document.

James.

--
Email: james daa com au
WWW:   http://www.daa.com.au/~james/