[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-core-devel
Subject:    Re: docbook errors: Current KDE_2_2_BRANCH kdebase doesn't compile
From:       Frederik Fouvry <fouvry () CoLi ! Uni-SB ! DE>
Date:       2001-09-04 9:45:26
[Download RAW message or body]


[ This mail may not arrive with kde-core-devel, since I'm not on
  that list - pls forward if necessary - thanks ]

,-- One day, you wrote:
| 
| On Monday 03 September 2001 16:12, Bernhard Rosenkraenzer wrote:
| > On Mon, 3 Sep 2001, Bernhard Rosenkraenzer wrote:
| > > Barfs on a docbook breakage:
| > >
| > > /usr/bin/meinproc --check --cache index.cache.bz2 ./index.docbook
| > > index.docbook:693: error: Entity 'KDE' not defined
| > > <para>&konsole; also accepts generic &Qt; and &KDE; options:</para>
| > >                                                    ^
| >
| > This patch fixes it:
| >
| > diff -u -r1.31.2.1 index.docbook
| > --- index.docbook       2001/09/02 23:44:43     1.31.2.1
| > +++ index.docbook       2001/09/03 14:12:08
| > @@ -4,6 +4,7 @@
| >  <!ENTITY kappname "&konsole;">
| >  <!ENTITY % English "INCLUDE">
| >  <!ENTITY % addindex "IGNORE">
| > +<!ENTITY KDE "<application>KDE</application>">
| >  ]>
| >
| >  <book lang="&language;">
| >
| >
| > But I don't know if that's what &KDE; should look like...
| 
| Hmm, the more correct fix would be &kde; I guess, but you better ask 
| kde-docbook@kde.org about that before you add such crude hacks.

Yes, please.  NEVER add entities yourself at the beginning of a
document, unless you know there are _very_ good reasons.  Here,
it's obvious you don't know ;-) All general entities that are
available are defined in
kdelibs/kdoctools/customization/entities/general.entities for
language-independent one, and in
kdelibs/kdoctools/customization/<lg>/user.entities for language
specific ones.  Entities that you want but that are missing can
be added, but the best thing is to ask the kde-DocBook list.

Happy documentation-writing,

--
Frederik Fouvry		-	fouvry@coli.uni-sb.de
KDE DocBook Team	-	kde-docbook@master.kde.org

[prev in list] [next in list] [prev in thread] [next in thread]