r1569: *** empty log message ***

diff --git a/doc/appendix.sgml b/doc/appendix.sgml
new file mode 100644 (file)
index 0000000..3e8c989
--- /dev/null
+++ b/doc/appendix.sgml
@@ -0,0 +1,10 @@
+<!-- -*- DocBook -*- -->
+
+<appendix>
+  <title>Installation</title>
+  <sect1>
+    <title>Download &uffi;</title>
+    <para>
+    </para>
+  </sect1>
+</appendix>

diff --git a/doc/glossary.sgml b/doc/glossary.sgml
new file mode 100644 (file)
index 0000000..008ada1
--- /dev/null
+++ b/doc/glossary.sgml
@@ -0,0 +1,16 @@
+<!-- -*- DocBook -*- -->
+
+<glossary>
+  <glossentry id="gloss-ffi">
+    <glossterm>Foreign Function Interface
+      <acronym>FFI</acronym>)
+    </glossterm>
+    <glossdef>
+      <para>
+        An interface to a C-compatible library.
+      </para>
+    </glossdef>
+  </glossentry>
+</glossary>
+
+

diff --git a/doc/preface.sgml b/doc/preface.sgml
new file mode 100644 (file)
index 0000000..31ed9e5
--- /dev/null
+++ b/doc/preface.sgml
@@ -0,0 +1,11 @@
+<!-- -*- DocBook -*- -->
+
+<preface>
+  <title>Preface</title>
+  <para>This reference guide describes the usage and features
+    of &uffi;.  The first 
+    chapter provides an overview to the design of &uffi;.
+    Following that chapter is the reference section for all user
+    accessible functions of &uffi;. The appendix covers the
+    installation and implementation-specifc features of &uffi;.
+  </preface>

diff --git a/doc/uffi.sgml b/doc/uffi.sgml
index 8a3419e8bf6002a7aa889c998091e67e01aada79..f422f99050740a613c1e769152cb0185b402d33c 100644 (file)
--- a/doc/uffi.sgml
+++ b/doc/uffi.sgml
@@ -12,14 +12,20 @@
 <!ENTITY c "<computeroutput>C</computeroutput>">
 <!ENTITY defsystem "<application>defsystem</application>">
 <!ENTITY bookinfo SYSTEM "bookinfo.sgml">
+<!ENTITY preface SYSTEM "preface.sgml">
 <!ENTITY intro SYSTEM "intro.sgml">
 <!ENTITY notes SYSTEM "notes.sgml">
 <!ENTITY ref SYSTEM "ref.sgml">
+<!ENTITY appendix SYSTEM "appendex.sgml">
+<!ENTITY glossary SYSTEM "glossary.sgml">
 ]>
 
 <book>
 &bookinfo;
+&preface;
 &intro;
 &notes;
 &ref;
+&appendix;
+&glossary;
 </book>