Re: Odd Behavior with Fedora Entity

[Karsten Wade]

On Thu, 2005-07-28 at 11:26 -0500, Thomas Jones wrote:
>  -----BEGIN PGP SIGNED MESSAGE-----
>  Hash: SHA1
>  
>  I was reviewing the entities in the current --- fedora-entities-en.ent. And 
>  noticed a rather peculiar behavior. One which I assume was expected to behave 
>  in a different fashion.
>  
>  It has to do with: LEGALNOTICE-RELNOTES 
This entity is intended to be used for the release notes only,
especially when printing no-chunks HTML.  It's purpose is to leave the
semantic <legalnotice> entity with meaningful content, but to move most
of the text out of the way.  Otherwise, in no-chunks output the
legalnotice is predominant and distracting.

You want to use the traditional LEGALNOTICE, which calls in docs-
common/common/legalnotice-en.xml.  Within that file is called
LEGALNOTICE-CONTENT.  There is your actual license et al.

>  Now I put this entity in my bookinfo/articleinfo element.  Anyways,
> upon 
>  building the source, the xml processor is directed to generate a link labeled 
>  "Legal Notice". This in effect generates a seperate page entirely with the 
>  content of the LEGALNOTICE-RELNOTES entity and it is pointed to from this 
>  link. This page is entirely blank minus the content of the entity. No header 
>  or footer etc.... No good. 
When LEGALNOTICE-RELNOTES is used, the <legalnotice /> appears where the
element may be used in DocBook.  The content is minimal, and it points
at a <section> that exists otherwise.  In that <section>, the entity
LEGALNOTICE-CONTENT is called in.

I should probably rename -RELNOTES to LEGALNOTICE-NOCHUNKS, as its main
purpose is when doing a no-chunks HTML build.

hth - Karsten
-- 
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint:  2680 DBFD D968 3141 0115    5F1B D992 0E06 AD0E 0C41   
                       Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/