Odd Behavior with Fedora Entity

Thomas Jones admin at buddhalinux.com
Thu Jul 28 16:26:27 UTC 2005


-----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

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.

http://www.buddhalinux.com/images/snapshot5.png

I don't believe that this is the intended behavior. It is my assumption[yeah i 
know] that (like many other doc projects) that this entity was intended to be 
called from the abstract element of bookinfo/articleinfo. Personally, i think 
it provides a better reference to the licensing than a simple link. However, 
in order to do so. There must be a change to the content of the common file 
- --- legalnotice-relnotes-en.xml.

In essence, this file contains common elements like that of 
legalnotice-content-en.xml. A simple removal of the legalnotice element 
parent in legalnotice-relnotes-en.xml corrects the problem and the entities 
behave as is expected.

http://www.buddhalinux.com/images/snapshot4.png

I have generated a diff against the current cvs:

Index: docs-common/common/legalnotice-relnotes-en.xml
===================================================================
RCS file: /cvs/docs/docs-common/common/legalnotice-relnotes-en.xml,v
retrieving revision 1.2
diff -u -r1.2 legalnotice-relnotes-en.xml
- --- docs-common/common/legalnotice-relnotes-en.xml	19 Jul 2005 20:41:03 -0000	
1.2
+++ docs-common/common/legalnotice-relnotes-en.xml	29 Jul 2005 04:13:57 -0000
@@ -7,9 +7,7 @@
 
 ]>
 -->
- -<legalnotice id="legalnotice">
- -  <para> This document is released under the terms of the GNU Free 
Documentation
+<para> This document is released under the terms of the GNU Free 
Documentation
     License.  For more details, read the full legalnotice in <xref
- -      linkend="sn-legalnotice" />.
- -  </para>
- -</legalnotice>
+    linkend="sn-legalnotice" />.
+</para>
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQFC6QczoR5cE1e/kEIRAstOAJ9yqJ1chxOUqcoe6b5yQUQXiNOAxACgpMmx
akmkJvlFB5u+CvltQ0SBT9A=
=LdF7
-----END PGP SIGNATURE-----




More information about the docs mailing list