On Thu, 2004-11-18 at 16:26 -0800, Karsten Wade wrote:
On Thu, 2004-11-18 at 12:45, David Malcolm wrote:
> On Wed, 2004-11-17 at 16:39 -0800, Karsten Wade wrote:
> >
>
> Done, as this one:
>
https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=139931
>
> Should this go on a tracker bug somewhere?
I don't think there is one, just falls in the "all open fedora-docs
bugs" category.
> > Might also want to patch fedora-entities-en.xml to have it make the
> > entity declaration:
> >
> > <!ENTITY ERRATA-TIP-EN SYSTEM "errata-en.xml">
>
> Would doing this require that any files using fedora-entities-en.xml
> define the various entities referred to in errata-en.xml ? (and hence
> break all the existing docs, until they get fixed?)
Good question. I _think_ it would only come into play if explicitly
called by the document. Here's a test.
I added this to my fedora-entities-en.xml:
<!ENTITY ABOUT-DOC-EN SYSTEM "about-doc-en.xml">
then built a document without any error.
It also validated:
cd /home/kwade/Documents/projects/fedora/fedora-docs/selinux-apache/
nsgmls -wxml -s /home/kwade/lib/psgmlx-0.5/lib/xml.dcl
selinux-apache-en.xml
nsgmls:/home/kwade/lib/psgmlx-0.5/lib/xml.dcl:1:W: SGML declaration was
not implied
SGML validation finished at Thu Nov 18 16:24:42
FWIW, that's the way it normally appears when I validate (in Emacs using
C-c C-v).
OK, great; good idea. Is xmllint happy with such a setup? If so, then
the ABOUT-DOC-EN probably _should_ get added to the main entities file.
> >
> > > Any thoughts/rewrites? Perhaps the heading should read "About This
> > > Document" instead?
> >
> > Yes, that is more of an accurate title. Changed that in the attachment.
>
> Perhaps the file should have a different name; perhaps
> "about-this-document-en.xml" ?
How about about-doc-en.xml?
Yes, that's much better.
Maybe even "about-fedora-doc-en.xml", to make it clear that this relates
to a Fedora doc? (as opposed to RHEL)
Can I go ahead and commit this (assuming I have access rights)? Or
should someone else on the list comment first? I'm just a lowly desktop
developer :-)
Dave