Commit experiments with DocBook 5 (xinclude to pull in constituent parts)

git-svn-id: svn://svn.open-ils.org/ILS/trunk@11445 dcc99617-32d9-48b4-a31d-7c20da2025e4

diff --git a/docs/index.xml b/docs/index.xml
index a04622e..c1da3b2 100644 (file)
--- a/docs/index.xml
+++ b/docs/index.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<book xmlns="http://docbook.org/ns/docbook"
+<book version="5.0" xmlns="http://docbook.org/ns/docbook"
   xmlns:xi="http://www.w3.org/2001/XInclude">
   <info>
     <title>The Book of Evergreen</title>
@@ -77,7 +77,7 @@
   </part>
 
   <part><title>Administering Evergreen</title>
-    <chapter><title>Starting and stopping Evergreen</title></chapter>
+    <xi:include href="starting_stopping.xml" /> 
     <chapter><title>Setting up organizational units</title></chapter>
     <chapter><title>Generating reports</title></chapter>
     <chapter><title>Preventing disaster</title></chapter>

diff --git a/docs/starting_stopping.xml b/docs/starting_stopping.xml
new file mode 100644 (file)
index 0000000..0f4795b
--- /dev/null
+++ b/docs/starting_stopping.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter version="5.0" xmlns="http://docbook.org/ns/docbook"
+  xmlns:xi="http://www.w3.org/2001/XInclude"
+  xmlns:xlink="http://www.w3.org/1999/xlink/">
+  <title>Starting and stopping the Evergreen services</title>
+    <para>
+      This chapter tells you how to start and stop the Evergreen services.
+    </para> 
+  <section id="starting_stopping_intro">
+    <title>Introduction</title>
+    <para>
+      We may talk a bit about how Evergreen is built on OpenSRF and uses
+      the OpenSRF control scripts. We could also talk a little bit about
+      SysV init scripts (and the current lack thereof) and point to 
+      <link xlink:href="http://blah.com">further documentation</link>.
+    </para>
+  </section>
+  <section id="starting_stopping_start">
+    <title>Starting the Evergreen services</title>
+    <para>
+      To start all of the Evergreen services on a given server, issue
+      the following command as the opensrf user:
+    </para>
+    <userinput><![CDATA[
+osrf_ctl.sh -a start_all
+]]></userinput>
+  </section>
+</chapter>