diff kdiff3/doc/README @ 69:8febbfb1148c

KDiff3 0.9.89

--- a/kdiff3/doc/README	Mon Jan 31 22:30:47 2005 +0000
+++ b/kdiff3/doc/README	Mon Apr 10 08:40:51 2006 +0000
@@ -6,6 +6,10 @@
 It helps me remember certain details. Most users probably aren't 
 interested in these things.
 
+Docbook references:
+http://i18n.kde.org/doc/markup/index.html
+http://opensource.bureau-cornavin.com/crash-course/index.html
+
 Each directory contains the documentation for a different translation.
 The textual information is in the index.docbook of every subdirectory.
 
@@ -19,8 +23,18 @@
 
 meinproc index.docbook
 
-During normal installation on KDE a compressed file is generated.
+If you prefer everything in one big HTML/Postscript/PDF-file:
+   LANG=de_DE meinproc --check index.docbook --stylesheet /opt/kde3/share/apps/ksgmltools2/customization/kde-nochunk.xsl
+   (The LANG=de_DE prevents that meinproc writes the file in UTF-8 encoding, which isn't understood by html2ps.)
+Create ps-file:
+   html2ps -D -u -n index.html >index.ps
+      (For the -D to work add the line "Ghostscript: 1;" in the "package"-section of file /usr/lib/html2ps/html2psrc.)
+Create pdf-file:
+   ps2pdf index.ps index.pdf
 
+The script createpdfdoc does these steps for all subdirectories.
+
+During normal installation on KDE a compressed file is generated:
 meinproc --check --cache index.cache.bz2 index.docbook
 
 
@@ -50,4 +64,16 @@
 Command to retrieve other translations from cvs:
 
 cvs co kde-i18n/subdirs
-for i in `cat kde-i18n/subdirs`; do  cvs co kde-i18n/$i/docs/kdeextragear-1/kdiff3/index.docbook; done
\ No newline at end of file
+for i in `cat kde-i18n/subdirs`; do  cvs co kde-i18n/$i/docs/kdeextragear-1/kdiff3/index.docbook; done
+
+If a new translation is available, 
+- create a new directory, 
+- copy the index.docbook file there,
+- copy a Makefile.am there and correct it, 
+- edit the doc/Makefile.am to include the new subdir,
+- create the links for the graphics,
+- and don't forget to run make -f Makefile.cvs in the top directory.
+
+
+
+