From ce4a32fe52ef09d8f5ff1dd22c001110902b60a2 Mon Sep 17 00:00:00 2001
From: toma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>
Date: Wed, 25 Nov 2009 17:56:58 +0000
Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
 BUG:215923

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
---
 kdoctools/customization/dtd/kdex.dtd               | 129 +++++++++++++
 kdoctools/customization/dtd/modifications.elements |  77 ++++++++
 kdoctools/customization/dtd/rdbhier2.elements      |  61 ++++++
 kdoctools/customization/dtd/rdbpool.elements       | 213 +++++++++++++++++++++
 4 files changed, 480 insertions(+)
 create mode 100644 kdoctools/customization/dtd/kdex.dtd
 create mode 100644 kdoctools/customization/dtd/modifications.elements
 create mode 100644 kdoctools/customization/dtd/rdbhier2.elements
 create mode 100644 kdoctools/customization/dtd/rdbpool.elements

(limited to 'kdoctools/customization/dtd')

diff --git a/kdoctools/customization/dtd/kdex.dtd b/kdoctools/customization/dtd/kdex.dtd
new file mode 100644
index 000000000..c31d11a57
--- /dev/null
+++ b/kdoctools/customization/dtd/kdex.dtd
@@ -0,0 +1,129 @@
+<!--
+    Document Type Definition for DocBook XML as used in the KDE documentation
+    
+    Copyright (C) 2002 Frederik Fouvry
+     
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License
+    as published by the Free Software Foundation; either version 2
+    of the License, or (at your option) any later version.
+     
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+     
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+    
+    Send suggestions, comments, etc. to the KDE docbook list 
+    <kde-docbook@kde.org>.
+
+
+    USAGE
+
+    Refer to this DTD as
+
+      "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+
+    For instance:
+
+      <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+                     "customization/dtd/kdex.dtd">
+
+    and use catalog.xml or docbook.cat as the catalogue file.
+    Note: the system identifier is interpreted relative to the place
+    where it is defined, unless otherwise defined by the application you use.
+    If you have permanent internet access, you can use any URLs (and
+    you don't have to install docbook).
+
+    After a version number change, plenty of problems may occur because
+    of non-compatibilities (or DTDs not found, etc).  That doesn't mean your
+    document is invalid; it just means that the reference DTD has changed 
+    (new documentation and documentation updates).  Check out the previous
+    version and point to the appropriate catalog or DTD and things should
+    work again (=still ;-).
+-->
+
+
+<!-- ============================================================= -->
+<!--	      Modifications to the original DocBook DTD		   -->
+<!-- ============================================================= -->
+<!-- Declarations in this part should only *restrict* the DocBook 
+     DTD                                                           -->
+
+<!-- copied from docbookx.dtd: these values are for 
+     %xml.features; = "INCLUDE"
+     Files that define elements need them (currently only 
+     modifications.elements) -->
+<!ENTITY % ho "">
+<!ENTITY % ubiq.inclusion "">
+<!ENTITY % beginpage.exclusion "">
+
+<!-- Modifications in pool
+     %rdbpool; is called in the DocBook DTD
+     NEEDS TO BE CHECKED ON CHANGES
+ -->
+<!ENTITY % rdbpool	    PUBLIC
+  "-//KDE//ELEMENTS DocBook XML Pool Redeclarations V1.1//EN"	     
+  "rdbpool.elements"                                                 >
+<!ENTITY % dbpool.redecl.module "INCLUDE"			     >
+
+<!-- Modifications in hierarchy
+     %rdbhier2; is called in the DocBook DTD
+     NEEDS TO BE CHECKED ON CHANGES
+ -->
+<!ENTITY % rdbhier2	    PUBLIC
+  "-//KDE//ELEMENTS DocBook XML Hierarchy Redeclarations 2 V1.0//EN"     
+  "rdbhier2.elements"                                                >
+<!ENTITY % dbhier.redecl2.module "INCLUDE"			     >
+
+<!-- For Java-style refentries	   
+     Based on DocBook 4.0.                                         -->
+<!--ENTITY % jrefentry      PUBLIC
+  "-//Norman Walsh//DTD JRefEntry V1.0//EN"                          >
+%jrefentry; -->
+
+<!-- Temporary solution -->
+<!ENTITY copy  "(c)"> <!--=copyright sign-->
+<!ENTITY trade "[tm]"> <!--=trade mark sign-->
+<!ENTITY reg   "(R)"> <!--/circledR =registered sign-->
+
+
+<!-- ============================================================= -->
+<!--			 Original DocBook DTD			   -->
+<!-- ============================================================= -->
+
+<!ENTITY % DocBookDTD	    PUBLIC
+  "-//OASIS//DTD DocBook XML V4.2//EN"
+  "../../docbook/xml-dtd-4.2/docbookx.dtd"         > 
+%DocBookDTD;
+
+
+<!-- ============================================================= -->
+<!--          Modifications to the original DocBook DTD            -->
+<!-- ============================================================= -->
+<!-- ONLY to supply declarations that were switched off in the 
+     first "Modifications" section -->
+
+<!ENTITY % kde.modifications PUBLIC
+  "-//KDE//ELEMENTS DocBook XML Modifications V1.1//EN"
+  "modifications.elements"                                           >
+%kde.modifications;
+
+
+<!-- ============================================================= -->
+<!--		    Extensions to the DocBook DTD		   -->
+<!-- ============================================================= -->
+<!-- Is empty, except for what could go in dbgenent.mod            -->
+
+<!ENTITY % kde.general.entities	PUBLIC
+  "-//KDE//ENTITIES DocBook XML General Entity Declarations V1.2//EN"    
+  "../entities/general.entities"                                     >
+%kde.general.entities;
+
+<!ENTITY % kde.i18n.entities PUBLIC
+  "-//KDE//ENTITIES DocBook XML Localisation Entity Declarations V1.0//EN"
+  "../entities/l10n.entities"                                        >
+%kde.i18n.entities;
diff --git a/kdoctools/customization/dtd/modifications.elements b/kdoctools/customization/dtd/modifications.elements
new file mode 100644
index 000000000..e0cbd1474
--- /dev/null
+++ b/kdoctools/customization/dtd/modifications.elements
@@ -0,0 +1,77 @@
+<!-- -*- dtd -*-
+    Fills in declarations that were switched off earlier (to provide them 
+    anew and more restrictive this time)
+    
+    Copyright (C) 2001,2002 Frederik Fouvry
+     
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License
+    as published by the Free Software Foundation; either version 2
+    of the License, or (at your option) any later version.
+     
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+     
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+    
+    Send suggestions, comments, etc. to the KDE docbook list 
+    <kde-docbook@kde.org>.
+
+    USAGE
+
+    Refer to this DTD as
+
+      "-//KDE//ELEMENTS DocBook XML Modifications (Restrictions) V1.1//EN"
+
+    For instance
+
+      <!ENTITY % kde.modifications PUBLIC
+       "-//KDE//ELEMENTS DocBook XML Modifications (Restrictions) V1.1//EN">
+
+-->
+
+<!-- ONLY to supply declarations that were switched off earlier 
+     Take care to make it only _more_ restrictive.  -->
+
+<!-- One modification: BookInfo is compulsory, because
+     it contains ReleaseInfo, which is compulsory -->
+<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
+ 		(dedication | toc | lot
+ 		| glossary | bibliography | preface
+		| %chapter.class; | reference | part
+		| %article.class;
+ 		| %appendix.class;
+		| %index.class;
+		| colophon)*)
+		%ubiq.inclusion;>
+
+<!-- Modification: ReleaseInfo, Date, Abstract and Keywordset are
+     compulsory.  Not all orders that could be valid are allowed (the
+     number increases factorial).  The current restrictions are quite
+     strict, and it is foreseen that they will be relaxed.  Date and 
+     ReleaseInfo must come together, as must Abstract and Keywordset.
+     Abstract and Keywordset must follow Date and ReleaseInfo when they
+     are used the first time.
+-->
+<!ELEMENT bookinfo %ho; ((%kde.info.class;)*, date, releaseinfo, 
+                         (%kde.info.class;)*, abstract, keywordset, 
+                         (%info.class;)*)
+		%beginpage.exclusion;>
+
+<!-- value of Type changed from IMPLIED CDATA
+     default value of LinkMode set from #IMPLIED to kdems-default -->
+<!ATTLIST olink
+		targetdocent	ENTITY 		#IMPLIED
+		linkmode	IDREF		"kdems-default"
+		localinfo 	CDATA		#IMPLIED
+		type		(href|other)	"href"
+		targetdoc	CDATA		#IMPLIED
+		targetptr	CDATA		#IMPLIED
+		%common.attrib;
+		%olink.role.attrib;
+		%local.olink.attrib;
+>
diff --git a/kdoctools/customization/dtd/rdbhier2.elements b/kdoctools/customization/dtd/rdbhier2.elements
new file mode 100644
index 000000000..005934f87
--- /dev/null
+++ b/kdoctools/customization/dtd/rdbhier2.elements
@@ -0,0 +1,61 @@
+<!-- -*- dtd -*-
+    Modified hierarchy elements for DocBook as used in the KDE documentation
+    (instantiates %rdbhier2;).  The actual changes are done in
+    modifications.elements.
+    
+    Copyright (C) 2001 Frederik Fouvry
+     
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License
+    as published by the Free Software Foundation; either version 2
+    of the License, or (at your option) any later version.
+     
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+     
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+    
+    Send suggestions, comments, etc. to the KDE docbook list 
+    <kde-docbook@kde.org>.
+
+    USAGE
+
+    Refer to this DTD as
+
+      "-//KDE//ELEMENTS DocBook Hierarchy Redeclarations 2 V1.0//EN"
+
+    For instance
+
+      <!ENTITY % rdbhier2 PUBLIC
+       "-//KDE//ELEMENTS DocBook Hierarchy Redeclarations 2 V1.0//EN">
+
+    Set to IGNORE:                      to revert from KDE customisation for:
+    kde.remove.unused.elements          some elements unlikely to be used
+    kde.book.meta.info                  extra requirements for bookinfo element
+-->
+
+
+<!-- Elements which are unlikely to be useful in the KDE documentation,
+     because their purpose is either to markup already existing documents
+     or because there are automatic means of obtaining the same effect 
+
+     %kde.remove.unused.elements; is set in kde-rdbpool.elements.
+ -->
+<![ %kde.remove.unused.elements; [
+<!ENTITY % toc.content.module "IGNORE">
+<!ENTITY % lot.content.module "IGNORE">
+<!-- end of kde.remove.unused.elements -->]]>
+
+
+<!-- For translation and revision bookkeeping mechanisms, some elements 
+     are required to be present in bookinfo.
+ -->
+<!ENTITY % kde.book.meta.info "INCLUDE">
+<![ %kde.book.meta.info; [
+<!ENTITY % book.element "IGNORE">
+<!ENTITY % bookinfo.element "IGNORE">
+<!-- end of kde.book.meta.info -->]]>
diff --git a/kdoctools/customization/dtd/rdbpool.elements b/kdoctools/customization/dtd/rdbpool.elements
new file mode 100644
index 000000000..b3c452027
--- /dev/null
+++ b/kdoctools/customization/dtd/rdbpool.elements
@@ -0,0 +1,213 @@
+<!-- -*- dtd -*-
+    Modified element pool for DocBook as used in the KDE documentation
+    (instantiates %rdbpool;)
+    
+    Copyright (C) 2001,2002 Frederik Fouvry
+     
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License
+    as published by the Free Software Foundation; either version 2
+    of the License, or (at your option) any later version.
+     
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+     
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+    
+    Send suggestions, comments, etc. to the KDE docbook list 
+    <kde-docbook@kde.org>.
+
+    USAGE
+
+    Refer to this DTD as
+
+      "-//KDE//ELEMENTS DocBook XML Pool Redeclarations V1.1//EN"
+
+    For instance
+
+      <!ENTITY % rdbpool PUBLIC
+       "-//KDE//ELEMENTS DocBook XML Pool Redeclarations V1.1//EN">
+
+    Set to IGNORE:                      to revert from KDE customisation for:
+    kde.remove.unused.elements          some elements unlikely to be used
+-->
+
+<!-- Elements which are unlikely to be useful in the KDE documentation,
+     because their purpose is either to markup already existing documents
+     or because there are automatic means of obtaining the same effect 
+ -->
+<!ENTITY % kde.remove.unused.elements "INCLUDE">
+<![ %kde.remove.unused.elements; [
+<!ENTITY % beginpage.module "IGNORE">
+<!ENTITY % bridgehead.module "IGNORE">
+<!ENTITY % confgroup.content.module "IGNORE">
+<!ENTITY % graphic.module "IGNORE">
+<!ENTITY % graphicco.module "IGNORE">
+<!ENTITY % imageobjectco.module "IGNORE">
+<!ENTITY % inlinegraphic.module "IGNORE">
+<!ENTITY % revhistory.content.module "IGNORE">
+<!-- end of kde.remove.unused.elements -->]]>
+
+<!-- KDE Languages
+     To keep the language tags conform to RFC 3066 (successor to 1766)
+     (http://www.rfc-editor.org/rfc/rfc3066.txt)
+     Syntax (RE): [a-zA-Z]{1,8}(-[a-zA-Z]{1,8})*
+
+     The compulsory part is either a language tag from ISO 639 (ISO
+     639-1 (2 character tag) if there is a tag, ISO 639-2/T (three
+     character tag) otherwise, "i" (for IANA) or "x" (for private use,
+     e.g. languages that are not in ISO 639).
+     The optional part may consist of any value.  However, if the
+     first repetition consists of two letters, it must be an ISO
+     3166a2 country tag (so Nynorsk cannot be indicated by no-NY or
+     no-ny).
+     Official site for ISO 639-2: http://lcweb.loc.gov/standards/iso639-2/
+     For ISO 639-1, only the latest version (currently Feb 2000) counts!
+
+     Countries are currently only needed when the language is different.
+ -->
+<!ENTITY % lang.attrib
+        "lang           (af|ar|az|be|bg|bn|bo|br|bs|ca|cs|cy|da|de|el|en|en-GB
+                        |en-US|eo|es|et|eu|fa|fi|fo|fr|fy|ga|gl|gu|he|hi|hr|hu
+                        |id|is|it|ja|kn|km|ko|ku|lo|lt|lv|mi|mk|mn|mr|ms|mt|nb
+                        |nds|nl|nn|no|nso|oc|pl|pt|pt-BR|pt-PT|ro|ru|se|si|sk
+                        |sl|sq|sr|ss|st|sv|ta|te|tg|th|tr|uk|uz|ven|vi|wa|xh
+                        |zh|zh-CN|zh-TW|zu)
+                        #IMPLIED">
+<!-- List of languages
+     (Languages that only have a three-character code from 639-2, must use 
+     that one)
+af      Afrikaans
+ar	Arabic
+az	Azerbaijani
+be	Belarusian
+bg      Bulgarian
+bn	Bengali
+bo      Tibetan
+br      Breton
+bs	Bosnian
+ca      Catalan
+cs      Czech
+cy      Welsh
+da      Danish
+de      German
+el      Greek, Modern (1453-)
+en      English
+eo      Esperanto
+es      Spanish
+et      Estonian
+eu      Basque
+fa      Persian (Farsi)
+fi      Finnish
+fo      Faroese
+fr      French
+fy      Frisian
+ga      Irish
+gl	Gallegan
+gu	Gujarati
+he      Hebrew
+hi      Hindi
+hr      Croatian
+hu      Hungarian
+id      Indonesian
+is      Icelandic
+it      Italian
+ja      Japanese
+km	Khmer
+kn      Kannada
+ko      Korean
+ku	Kurdish
+lo      Lao
+lt      Lituanian
+lv	Latvian
+mi      Maori
+mk      Macedonian
+mn      Mongolian
+mr	Marathi
+ms      Malay
+mt	Maltese
+nb      Norwegian Bokmal
+nds     Low Saxon, Low German
+nl      Dutch
+nn      Norwegian Nynorsk
+no      Norwegian (in KDE = nb)
+nso	Northern Sotho
+oc	Occitan (post 1500); Provençal
+pl      Polish
+pt      Portuguese
+ro      Romanian
+ru      Russian
+se      Northern Sami
+si      Sinhalese
+sk      Slovak
+sl      Slovenian
+sq	Albanian
+sr      Serbian
+ss      Swati
+st	Sesotho (souther Sotho)
+sv      Swedish
+ta      Tamil
+te      Telugu
+tg	Tajik
+th      Thai
+tr      Turkish
+uk      Ukrainian
+uz      Uzbek
+ven	Venda
+vi	Vietnamese
+wa	Walloon
+xh	Xhosa
+zh      Chinese
+zu	Zulu
+-->
+<!-- end of KDE languages -->
+<!-- Languages could be made compulsory for books -->
+
+<!ENTITY % remap.attrib "">
+
+<!-- Not used -->
+<!ENTITY % revisionflag.attrib "">
+
+<!ENTITY % othercredit.role.attrib
+        "role   (translator|developer|reviewer|graphist|musician|tester)
+                #REQUIRED">
+
+<!ENTITY % kde.compulsory.datereleaseinfo "INCLUDE">
+<![ %kde.compulsory.datereleaseinfo; [
+<!-- Unchanged -->
+<!ENTITY % local.person.ident.mix "">
+<!ENTITY % person.ident.mix
+                "honorific|firstname|surname|lineage|othername|affiliation
+                |authorblurb|contrib %local.person.ident.mix;">
+
+<!ENTITY % local.bibliocomponent.mix "">
+<!-- Copy of bibliocomponent.mix without ReleaseInfo, Date or Abstract -->
+<!ENTITY % kde.bibliocomponent.mix
+		"abbrev|address|artpagenums|author
+		|authorgroup|authorinitials|bibliomisc|biblioset
+		|collab|confgroup|contractnum|contractsponsor
+		|copyright|corpauthor|corpname|edition
+		|editor|invpartnumber|isbn|issn|issuenum|orgname
+		|biblioid|citebiblioid|bibliosource|bibliorelation|bibliocoverage
+		|othercredit|pagenums|printhistory|productname
+		|productnumber|pubdate|publisher|publishername
+		|pubsnumber|revhistory|seriesvolnums
+		|subtitle|title|titleabbrev|volumenum|citetitle
+		|personname|%person.ident.mix;
+		|%ndxterm.class;
+		%local.bibliocomponent.mix;">
+<!-- Unchanged -->
+<!ENTITY % local.info.class "">
+<!-- Copy of info.class with %kde.bibliocomponent.mix; -->
+<!ENTITY % kde.info.class
+		"graphic | mediaobject | legalnotice | modespec
+		 | subjectset | keywordset | itermset | %kde.bibliocomponent.mix;
+                 %local.info.class;">
+<!-- End of compulsory ReleaseInfo -->]]>
+
+<!-- KDE uses a more specific list of attributes -->
+<!ENTITY % olink.attlist "IGNORE">
-- 
cgit v1.2.1