New ENTITY declarations?

[Dave Pawson]

At 08:06 29/11/2003, Karsten Wade wrote:


>We use a common set available to all document writers, following the
>format of fedora-entities.sgml.  The contents of that file would be
>pulled into the parent XML like:
>
><!-- ****** Bring in Fedora Project standard entities ***** -->
><!ENTITY % FEDORA-ENTITIES SYSTEM
>"../fedora-common-xml/fedora-entities.xml">
>%FEDORA-ENTITIES;

Which is fine if the structure on an authors machine reflects
that on the fedora build.
1. Is that the intention.
2. Is that structure documented?

(That's why I suggested the use of a uri on the redhat site,
and a local catalog entry to map that to the local instance for
local use)


>I'm not 100% certain that my syntax is accurate for the XML DTD; it
>works for SGML.

Which is fedora working in?
  I've assumed XML. Is there much SGML legacy?

>  Let us know if there any differences.  Following is an
>example scheme based on what we are using at Red Hat.
>
>The target file in the common directory is called via a relative path,
>i.e. it's always in an expected location of off the Fedora docs cvsroot,
>../fedora-common-xml/fedora-entities.xml.


Are all authors expected to work with that relative path?


>This means fedora-common-xml/ is a module in CVS that you need to
>check-out in order to build your docs (if you call anything from there,
>of course), and which makes it easy to distribute changes globally, i.e.
>if Fedora Core becomes F3d0ra C0r3, then we only need to 'cd
>fedora-common-xml/ && cvs up'. ;)

No problems with that... so long as all understand it..
and its documented :-)
<snip/>


>hth - Karsten

Very much so Karsten.
  Very clear.
.... Is this to be marked up and added to the documentation howto :-)

regards DaveP