The attached patch adds a section to the "Overview" document
to say that the samples are available with the distribution and
shows how to use the samples to learn behind-the-scenes.
It also tweaks a couple sentences in the existing sections,
to better explain.
David Crossley
Index: overview.xml
===================================================================
RCS file: /home/cvspublic/xml-cocoon2/xdocs/overview.xml,v
retrieving revision 1.2
diff -u -r1.2 overview.xml
--- overview.xml 2001/07/19 14:20:23 1.2
+++ overview.xml 2001/09/11 08:42:05
@@ -3,7 +3,7 @@
<document>
<header>
<title>Overview of @doctitle@</title>
- <version>0.1</version>
+ <version>0.2</version>
<type>Overview document</type>
<authors><person name="Tom Klaasen" email="[EMAIL PROTECTED]"/>
</authors>
@@ -13,12 +13,36 @@
<p>@docname@ is an XML publishing framework. It allows you to define
XML
documents and transformations to be applied on it, to eventually
generate a
presentation format of your choice (HTML, PDF, SVG, ...).</p>
- <p>@docname@ also gives you the possibility to have logic in your XML
files
- (so that the XML file itself can become dynamically generated).</p>
+ <p>@docname@ also gives you the possibility to apply logic to your XML
+files
+ (so that the XML pipeline can be dynamic).</p>
</s1>
- <s1 title="General structure">
- <p>This section gives a general overview of how an XML document is
- handled by @docname@.</p>
+
+ <anchor id="samples"/>
+ <s1 title="Examples and demonstration applications">
+ <p>
+ There are a whole suite of sample applications to demonstrate the power
+ of @docname@. These samples are available from the "welcome" page after
+ you have downloaded, built, and installed the distribution.
+ Each example portrays a different aspect of the vast capabilities of
+ @docname@.
+ </p>
+
+ <p>
+ It will greatly assist your understanding of @docname@ to investigate
+ behind-the-scenes, to find out how each sample is processed. Do this
+ by looking at the actual XML documents provided in the distribution at
+ <code>webapp/docs/samples/</code> and by consulting the sitemap to see
+ the processing steps that are defined.
+ </p>
+ </s1>
+
+ <s1 title="Overview of XML document processing">
+ <p>This section gives a general overview of how an XML document is
+ handled by @docname@. See also the document
+ <link href="uc2.html">Understanding @docname@</link> for explanation of
+ the separation of content, style, logic and management functions.
+ </p>
+
<s2 title="Pipeline">
<p>@docname@ relies on the pipeline model: an XML document is pushed
through a pipeline, that exists in several transformation
steps of your
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]
