Re: A PHPDoc DTD: Making subfiles validate
| From: | Hannes Magnusson | Date: | Sat, 01 Mar 2008 17:21:22 +0000 |
| Subject: | Re: A PHPDoc DTD: Making subfiles validate | ||
| References: | 1 2 3 4 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969378647@lists.php.net to get a copy of this message | ||
On Sat, Mar 1, 2008 at 5:17 PM, Edward Z. Yang
<edwardzyang@thewritingpot.com> 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