On Sat, Mar 1, 2008 at 5:17 PM, Edward Z. Yang <[EMAIL PROTECTED]> wrote: > The DocBook mentions some disadvantages of XIncludes: [1] > > - XInclude can only have one root, parsed entities can have multiple > elements (I don't think this is a problem with PHPDoc)
I've already fixed those problems, at least most of them, when we moved to DB5 > - An XIncluded document with an IDREF that crosses document boundaries > still won't be valid. Why? XIncludes are to XML what macros are to C... well, kinda. Almost. No, not really. My point is: XIncludes are processed long before validation. > I presume we'll still use entities for text-level inclusions, so we'll > still need to define a custom Doctype for PHPDoc. Probably, yes. Not necessarily though. -Hannes