Index: openacs-4/packages/acs-authentication/www/doc/xml/example.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-authentication/www/doc/xml/example.xml,v
diff -u
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ openacs-4/packages/acs-authentication/www/doc/xml/example.xml	9 Feb 2004 15:50:11 -0000	1.1
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<enterprise>
+  <properties>
+    <datasource>FOO</datasource>
+    <target>dotLRN</target>
+    <type>DB Increment</type>
+    <datetime>28-oct-2003#16:06:02</datetime>
+  </properties>
+  <person recstatus = "1">
+    <sourcedid>
+      <source>FOO</source>
+      <id>karlf</id>
+    </sourcedid>
+    <name>
+      <n>
+        <given>Karl</given>
+        <family>Fritz</family>
+        <prefix></prefix>
+      </n>
+    </name>
+    <email>karlf@example.net</email>
+  </person>
+  <person recstatus = "2">    <!--modified person-->
+    ...
+  </person>
+  <person recstatus = "3">    <!--deleted person-->
+  <sourcedid>
+    <id>LL1</id>      <!--only requires username-->
+  </sourcedid>
+  </person>
+</enterprise>
Index: openacs-4/packages/acs-authentication/www/doc/xml/install.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-authentication/www/doc/xml/install.xml,v
diff -u -r1.3 -r1.4
--- openacs-4/packages/acs-authentication/www/doc/xml/install.xml	20 Oct 2003 15:44:31 -0000	1.3
+++ openacs-4/packages/acs-authentication/www/doc/xml/install.xml	9 Feb 2004 15:50:11 -0000	1.4
@@ -1,13 +1,15 @@
 <?xml version='1.0' ?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
 ]>
 
   <article id="ext-auth-install">
     <title>Installation</title>
 
     <authorblurb>
+      <para>
       by <ulink url="mailto:joel@aufrecht.org">Joel Aufrecht</ulink>
+      </para>
     </authorblurb>
 
     <sect1 id="ext-auth-pam-install">
@@ -224,52 +226,13 @@
             supply XML files to the URLs IncrementalURL and
             SnapshotURL.  A typical set of incremental file record
             looks like:</para>
-<programlisting>
-&lt;enterprise&gt;
-  &lt;person recstatus = "1"&gt;  <emphasis>added person</emphasis>
-    &lt;sourcedid&gt;
-      &lt;id&gt;[username]&lt;/id&gt;
-    &lt;/sourcedid&gt;
-    &lt;name&gt;
-      &lt;family&gt;[last_name]&lt;/family&gt;
-      &lt;given&gt;[first_names]&lt;/given&gt;
-    &lt;/name&gt;
-    &lt;email&gt;[email]&lt;/email&gt;
-    &lt;url&gt;[homepage_url]&lt;/url&gt;
-  &lt;/person&gt;
-  &lt;person recstatus = "2"&gt;    <emphasis>modified person</emphasis>
-    ...
-  &lt;/person&gt;
-  &lt;person recstatus = "3"&gt;    <emphasis>deleted person</emphasis>
-    &lt;sourcedid&gt;
-      &lt;id&gt;LL1&lt;/id&gt;      <emphasis>only requires username</emphasis>
-    &lt;/sourcedid&gt;
-  &lt;/person&gt;
-&lt;/enterprise&gt;</programlisting>
+<programlisting><xi:include href="example.xml" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>example missing</xi:fallback></xi:include></programlisting>
           <para>A snapshot file is similar but doesn't have recstatus,
-  since it's not a delta but a list of valid records.
+  since it's not a delta but a list of valid records.  See the larger example in the design document for more details.
 </para>
-          <programlisting>
-&lt;enterprise&gt;
-  &lt;person&gt;
-    &lt;sourcedid&gt;
-      &lt;id&gt;[username]&lt;/id&gt;
-    &lt;/sourcedid&gt;
-    &lt;name&gt;
-      &lt;family&gt;[last_name]&lt;/family&gt;
-      &lt;given&gt;[first_names]&lt;/given&gt;
-    &lt;/name&gt;
-    &lt;email&gt;[email]&lt;/email&gt;
-    &lt;url&gt;[homepage_url]&lt;/url&gt;
-  &lt;/person&gt;
-  ...
-&lt;/enterprise&gt;
-</programlisting>
               <para>(More information: <xref linkend="ims-sync-driver-design"/>, <ulink url="http://www.imsproject.org/enterprise/">The IMS 1.1 spec</ulink>)</para>
           </listitem>
       </orderedlist>
+      <para><phrase role="cvstag">($Id$)</phrase></para>
     </sect1>
-
-
-              <para><phrase role="cvstag">($Id$)</phrase></para>
   </article>