10 files changed, 99 insertions, 0 deletions

diff --git a/docs/usermanual/Makefile b/docs/usermanual/Makefile
new file mode 100644
index 0000000..3242e5a
--- a/dev/null
+++ b/docs/usermanual/Makefile
@@ -0,0 +1,12 @@
+all: html
+
+DOC := usermanual
+
+html:
+        sgmltools -b html -s stylesheet-html.dsl $(DOC).sgm
+        mv -f $(DOC)/*.html .
+        rmdir $(DOC)
+        ln -sf book1.html index.html
+
+clean:
+        rm -f *.html
diff --git a/docs/usermanual/caution.gif b/docs/usermanual/caution.gif
new file mode 100644
index 0000000..9cc2e15
--- a/dev/null
+++ b/docs/usermanual/caution.gif
diff --git a/docs/usermanual/important.gif b/docs/usermanual/important.gif
new file mode 100644
index 0000000..25e40c7
--- a/dev/null
+++ b/docs/usermanual/important.gif
diff --git a/docs/usermanual/logo-small.png b/docs/usermanual/logo-small.png
new file mode 100644
index 0000000..6630276
--- a/dev/null
+++ b/docs/usermanual/logo-small.png
diff --git a/docs/usermanual/newfiles.tgz b/docs/usermanual/newfiles.tgz
new file mode 100644
index 0000000..41f4637
--- a/dev/null
+++ b/docs/usermanual/newfiles.tgz
diff --git a/docs/usermanual/note.gif b/docs/usermanual/note.gif
new file mode 100644
index 0000000..7322e8e
--- a/dev/null
+++ b/docs/usermanual/note.gif
diff --git a/docs/usermanual/preface.sgm b/docs/usermanual/preface.sgm
new file mode 100644
index 0000000..7e49937
--- a/dev/null
+++ b/docs/usermanual/preface.sgm
@@ -0,0 +1,31 @@
+<preface>
+  <title>Editorial note</title>
+  <note>
+    <para>The <xref linkend="installation" endterm="tinstallation"> chapter and some other chapters of this manual have been updated in August 2003, especially to take into account <ulink url="http://opie.handhelds.org/archive_2003-w31.html">&opie; 1.0 release</ulink>. But it is difficult for the &opie; team to keep up with &opie; and &opie; applications progress. Please indulge this manual occasional tardiness!</para>
+    <para>Please note, also, that the end of this guide (from late Chapter 2 on) is incomplete, when it comes to documenting applications. In particular, the following applications still have an empty page:
+      <emphasis>appearance2,
+      appskey,
+      calibrate,
+      citytime,
+      drawpad,
+      handwriting,
+      helpbrowser,
+      kjumpx,
+      language,
+      lightpower,
+      login,
+      multikey,
+      pickboard,
+      player2,
+      qpdf,
+      reader,
+      rotation,
+      sheet,
+      showimg,
+      sshkeys,
+      sysinfo,
+      tableviewer,</emphasis>
+      and <emphasis>write</emphasis>. Hopefully their interface is clear enough so you won't need documentation so much :-)
+    </para>
+  </note>
+</preface>
diff --git a/docs/usermanual/stylesheet-html.dsl b/docs/usermanual/stylesheet-html.dsl
new file mode 100644
index 0000000..c07cc53
--- a/dev/null
+++ b/docs/usermanual/stylesheet-html.dsl
@@ -0,0 +1,56 @@
+<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
+<!ENTITY dbstyle SYSTEM "/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl" CDATA DSSSL>
+]>
+
+<style-sheet>
+<style-specification use="docbook">
+<style-specification-body>
+
+; Personnalization of James Clark's stylesheet for HTML output
+; These parameters overide James Clark's one.
+
+; Only produce a table of contents (not a table of figure, etc...)
+(define ($generate-book-lot-list$)
+  (list ))
+
+; Depth of the table of contents
+(define (toc-depth nd)
+      2)
+
+; Change of HTML page for each chapter, not for each "sect1"
+(define (chunk-element-list)
+  (list (normalize "preface")
+        (normalize "chapter")
+        (normalize "appendix") 
+        (normalize "article")
+        (normalize "glossary")
+        (normalize "bibliography")
+        (normalize "index")
+        (normalize "colophon")
+        (normalize "setindex")
+        (normalize "reference")
+        (normalize "refentry")
+        (normalize "part")
+        (normalize "book")
+        (normalize "set")
+        ))
+
+; "screens" should be in verbatim mode"
+(define %shade-verbatim%
+  #t)
+
+; I want small icons for "notes", "warnings", "caution" & "important"
+(define %admon-graphics%
+  #t)
+; Path for the icons
+(define %admon-graphics-path%
+  "")
+
+; Use ID attributes as name for component HTML files
+(define %use-id-as-filename%
+  #t)
+
+</style-specification-body>
+</style-specification>
+<external-specification id="docbook" document="dbstyle">
+</style-sheet>
diff --git a/docs/usermanual/tip.gif b/docs/usermanual/tip.gif
new file mode 100644
index 0000000..f062955
--- a/dev/null
+++ b/docs/usermanual/tip.gif
diff --git a/docs/usermanual/warning.gif b/docs/usermanual/warning.gif
new file mode 100644
index 0000000..a587079
--- a/dev/null
+++ b/docs/usermanual/warning.gif