Re: docs-common Makefile.common,1.73,1.74

[Karsten Wade]

On Mon, 2006-02-27 at 19:12 -0600, Tommy Reynolds wrote:
>  Uttered "Paul W. Frields" <stickster(a)gmail.com&gt;,
> spake thus:
>  
>  > On Mon, 2006-02-27 at 14:12 -0500, Karsten Wade wrote:
>  > >  set-locale-${1}::
>  > > -	${LN} -f -s ${FDPDIR}/docs-common/common/entities/entities-${1}.ent \
>  > > +	${LN} -f -s ${FDPDIR}/docs-common/common/entities/entities-${1}.xml \
>  > >  		${LOCALE_ENTITIES}
>  > Err... doesn't this break stuff?  The .ent file is generated from
>  > the .xml, and the LOCALE_ENTITIES is a link to those entities.  If you
>  > link to the .xml sources things stop working.
>  
>  Yup, it absolutely breaks stuff.  The XML file is the raw form that
>  needs to be compiled into the ".ent" file, containing NOTHING except
>  <!ENTITY> elements.  
>  
>  This file gets included as part of the <DOCTYPE>'s local DTD section,
>  between the '[]' pair, and you can't put full XML in there, only
>  <!ENTITY> stuff. 
I obviously didn't grok what was going on.  I was helping a user who's
first error was a bad symlink because it was trying to get ../docs-
common/common/entities/entities-en.ent ... because it's not there.  It
wasn't getting dynamically generated.  Doing this at least caused a new
set of problems. :)

- Karsten
-- 
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint:  2680 DBFD D968 3141 0115    5F1B D992 0E06 AD0E 0C41   
Content Services                          Fedora Documentation Project
http://www.redhat.com/docs   http://fedoraproject.org/wiki/DocsProject