summaryrefslogtreecommitdiff
path: root/docs/development/ksgmltools-bug-read-me.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/development/ksgmltools-bug-read-me.txt')
-rw-r--r--docs/development/ksgmltools-bug-read-me.txt36
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/development/ksgmltools-bug-read-me.txt b/docs/development/ksgmltools-bug-read-me.txt
new file mode 100644
index 0000000..5a40a7f
--- /dev/null
+++ b/docs/development/ksgmltools-bug-read-me.txt
@@ -0,0 +1,36 @@
+During the creation of these documents I found several problems with the
+docbook DTD supplied with Mandrake 8.1 This read me documents the work arounds made.
+
+Problem
+
+&XML; parses as XML?
+
+Solution
+
+Edited the file /usr/share/apps/ksgmltools2/customization/entities/general.entities
+also known as "-//KDE//ENTITIES DocBook XML General Entity Declarations V1.0//EN"
+
+to read
+<!ENTITY XML '<trademark class="registered">XML</trademark>'>
+
+Also did this with all trademark tags that had no class. Class is required for this tag, see
+
+DocBook: The Definitive Guide
+By Norman Walsh and Leonard Muellner
+O'Reilly & Associates, Inc.
+
+Result
+
+&XML; parses as XML®
+
+
+Problem
+<quote>stuff</quote> parses as ?quote?
+
+Used " instead.
+
+This should be corrected when <quote> parses as "
+
+----------------------
+Fred Saalbach 22 Dec 2001
+----------------------