Advanced
Mailing List Archive

Mailing List Archive

  1. Home >
  2. Forrest>
  3. Site-SVN
svn commit: r525747 [2/2] - in /forrest/site: ./ docs_0_80/ docs_0_80/error_site_your-project/ docs_0_80/howto/ docs_0_80/howto/multi/ dtdx/ procedures/release/
crossley at apache
Apr 4, 2007, 11:40 PM
Post #1 of 1 (981 views)
Permalink
Modified: forrest/site/docs_0_80/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/index.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs_0_80/index.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/index.xml?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/index.xml (original)
+++ forrest/site/docs_0_80/index.xml Thu Apr 5 00:40:14 2007
@@ -25,8 +25,14 @@
</p>
<p>In the <link href="howto/index.html">How-To</link> section you will find various
practical guides on how to achieve common objectives in Forrest.</p>
- <p>We also have a <link href="faq.html">FAQ</link> that you should consult before posting questions to
+ <p>We also have a <link href="faq.html">FAQ</link> list that you should consult before posting questions to
our user list.</p>
+ <p>
+ The documentation <link href="site:linkmap">Table of Contents</link> provides a
+ useful overview of the main documentation. <link href="site:faq/docs">This FAQ</link>
+ explains that there is other documentation at the example forrest seed
+ site and that each plugin has its own documentation.
+ </p>
<p>
There are docs for
<link href="site:versions/overview">other versions</link>

Modified: forrest/site/docs_0_80/libre-intro.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/libre-intro.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/libre-intro.html (original)
+++ forrest/site/docs_0_80/libre-intro.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/linking.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/linking.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/linking.html (original)
+++ forrest/site/docs_0_80/linking.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/locationmap.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/locationmap.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/locationmap.html (original)
+++ forrest/site/docs_0_80/locationmap.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/menu-index.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/menu-index.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/menu-index.html (original)
+++ forrest/site/docs_0_80/menu-index.html Thu Apr 5 00:40:14 2007
@@ -192,7 +192,7 @@
</li>

<li>
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</li>

</ul>

Modified: forrest/site/docs_0_80/primer.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/primer.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/primer.html (original)
+++ forrest/site/docs_0_80/primer.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/project-sitemap.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/project-sitemap.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/project-sitemap.html (original)
+++ forrest/site/docs_0_80/project-sitemap.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/searching.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/searching.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/searching.html (original)
+++ forrest/site/docs_0_80/searching.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/sitemap-ref.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/sitemap-ref.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/sitemap-ref.html (original)
+++ forrest/site/docs_0_80/sitemap-ref.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/skin-package.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/skin-package.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/skin-package.html (original)
+++ forrest/site/docs_0_80/skin-package.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/skins.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/skins.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/skins.html (original)
+++ forrest/site/docs_0_80/skins.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/status-themes.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/status-themes.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/status-themes.html (original)
+++ forrest/site/docs_0_80/status-themes.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/upgrading_08.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/upgrading_08.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/upgrading_08.html (original)
+++ forrest/site/docs_0_80/upgrading_08.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/docs_0_80/validation.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/validation.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/validation.html (original)
+++ forrest/site/docs_0_80/validation.html Thu Apr 5 00:40:14 2007
@@ -5,7 +5,7 @@
<meta content="Apache Forrest" name="Generator">
<meta name="Forrest-version" content="0.8-dev">
<meta name="Forrest-skin-name" content="pelt">
-<title>XML Validation (v0.8-dev)</title>
+<title>XML validation and entity resolution (v0.8-dev)</title>
<link type="text/css" href="../skin/basic.css" rel="stylesheet">
<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menupage">
-<div class="menupagetitle">XML Validation</div>
+<div class="menupagetitle">XML validation and entity resolution</div>
</div>
</div>
<div class="menuitem">
@@ -313,7 +313,7 @@
&nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
&nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
-<h1>XML Validation</h1>
+<h1>XML validation and entity resolution</h1>
<h3>DTDs, catalogs and whatnot</h3>
<div id="motd-area">
This is documentation for development version v0.8
@@ -321,6 +321,9 @@
<div id="minitoc-area">
<ul class="minitoc">
<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
<a href="#xml_validation">XML validation</a>
</li>
<li>
@@ -335,6 +338,9 @@
</ul>
</li>
<li>
+<a href="#debug-catalog">Debugging the Catalog Entity Resolver</a>
+</li>
+<li>
<a href="#entities">Referring to entities</a>
</li>
<li>
@@ -343,10 +349,37 @@
<li>
<a href="#relaxng">Validation using RELAX NG</a>
</li>
+<li>
+<a href="#sitemap">Validation using Cocoon sitemap and the Cocoon Validation block</a>
+</li>
</ul>
</div>

-<a name="N10010"></a><a name="xml_validation"></a>
+<a name="N10010"></a><a name="intro"></a>
+<h2 class="underlined_10">Introduction</h2>
+<div class="section">
+<p>
+ When a source document uses a DTD to define its structure, then various abilities are enabled. Forrest handles the annoying side of this and takes advantage of the benefits.
+ </p>
+<p>
+ The xml parser must locate the DTDs and other entities. Forrest uses the XML
+ Catalog Entity Resolver to associate DTD references with local copies.
+ </p>
+<p>
+ Forrest also uses the XML Document Type Declaration to effect the
+ <a href="../docs_0_80/cap.html">Content Aware Pipelines</a>. Remember that you are
+ not required to use DTDs (for example Forrest can also respond to a namespace)
+ so RELAX NG or W3c XML Schema can be used.
+ </p>
+<p>
+ If you do use DTDs, then forrest is automatically configured to do XML validation.
+ </p>
+<p>
+ This document explains both the validation and entity resolution aspects of the Forrest XML framework.
+ </p>
+</div>
+
+<a name="N1002A"></a><a name="xml_validation"></a>
<h2 class="underlined_10">XML validation</h2>
<div class="section">
<p>
@@ -411,7 +444,7 @@
</div>


-<a name="N10049"></a><a name="Validating+new+XML+types"></a>
+<a name="N10063"></a><a name="Validating+new+XML+types"></a>
<h2 class="underlined_10">Validating new XML types</h2>
<div class="section">
<p>
@@ -425,7 +458,7 @@
an entry to the <span class="codefrag">${project.schema-dir}/catalog.xcat</span> file. This
section describes the details of this process.
</p>
-<a name="N1006A"></a><a name="Creating+or+extending+a+DTD"></a>
+<a name="N10084"></a><a name="Creating+or+extending+a+DTD"></a>
<h3 class="underlined_5">Creating or extending a DTD</h3>
<p>
The main Forrest DTDs are designed to be modular and extensible, so
@@ -552,7 +585,7 @@
customizing a DTD.
</div>
</div>
-<a name="N100B1"></a><a name="catalog"></a>
+<a name="N100CB"></a><a name="catalog"></a>
<h3 class="underlined_5">Associating DTDs with document types</h3>
<p>
Recall that our DOCTYPE declaration for our download document type
@@ -580,9 +613,15 @@
<p>
Forrest provides a standard catalog file at
<span class="codefrag">forrest/main/webapp/resources/schema/catalog.xcat</span>
- for the document
- types that Forrest provides. Projects can augment this with their
- own catalog file located in
+ for the document types that Forrest supplies.
+ </p>
+<p>
+ An additional system-wide catalog can be configured for use by multiple forrest-based projects.
+ See the "local-catalog" parameter in <span class="codefrag">main/webapp/WEB-INF/xconf/forrest-core.xconf</span>
+
+</p>
+<p>
+ Projects can augment this with their own catalog file located in
<span class="codefrag">${project.schema-dir}/catalog.xcat</span> to use it you must
specify either the path (full or relative) to your
<span class="codefrag">catalog.xcat</span> in the <span class="codefrag">CatalogManager.properties</span>
@@ -593,7 +632,7 @@
When Cocoon starts, it reads the <span class="codefrag">CatalogManager.properties</span> file from your
<span class="codefrag">project.classes-dir</span>. This is usually src/documentation/classes/
but you can change this in <span class="codefrag">forrest.properties</span>. When you seed
- a new site using <span class="codefrag">forrest seed-site</span> a sample catalog file
+ a new site using <span class="codefrag">forrest seed</span> a sample catalog file
is placed in the site structure, you can use this as a template for your
own files.
</p>
@@ -618,17 +657,43 @@
<p>
We now have a custom DTD and a catalog mapping which lets both
Forrest and Cocoon
- locate the DTD. Now if we were to run <span class="codefrag">'forrest validate'</span>
+ locate the DTD. Now if we were to run <span class="codefrag">'forrest validate-xdocs'</span>
our download file would validate along with all the others. If
- something goes wrong, try running <span class="codefrag">'forrest -v validate'</span> to
- see the error in more detail. Remember to raise the "verbosity"
- level in <span class="codefrag">cocoon.xconf</span> if you suspect problems
- with your catalog.
+ something goes wrong, try running <span class="codefrag">'forrest -v validate-xdocs'</span> to
+ see the error in more detail.
</p>
</div>


-<a name="N1010F"></a><a name="entities"></a>
+<a name="N1012F"></a><a name="debug-catalog"></a>
+<h2 class="underlined_10">Debugging the Catalog Entity Resolver</h2>
+<div class="section">
+<p>
+ If you suspect problems with your project catalog, then raise the "verbosity"
+ level in <span class="codefrag">src/documentation/classes/CatalogManager.properties</span>
+ and re-start forrest.
+ This should show your project catalogs being parsed and loaded.
+ </p>
+<p>
+ However this configuration does not show your DTDs being resolved.
+ So raise the verbosity level in the central configuration at
+ <span class="codefrag">main/webapp/WEB-INF/properties/dev/core.properties</span>
+ and re-start forrest. This also shows the main catalogs being loaded
+ and shows the resolving of every DTD and entity set.
+ </p>
+<p>
+ When a DTD is successfully resolved you should see the message:
+ <span class="codefrag">Resolved public:</span>
+
+</p>
+<p>
+ When debugging such issues, a network monitoring tool (e.g. ngrep.sf.net)
+ is useful to ensure that all resources are being locally resolved and not wandering onto the network to find remote copies.
+ </p>
+</div>
+
+
+<a name="N1014B"></a><a name="entities"></a>
<h2 class="underlined_10">Referring to entities</h2>
<div class="section">
<p>
@@ -651,7 +716,7 @@
</div>


-<a name="N10134"></a><a name="Validating+in+an+XML+editor"></a>
+<a name="N10170"></a><a name="Validating+in+an+XML+editor"></a>
<h2 class="underlined_10">Validating in an XML editor</h2>
<div class="section">
<p>
@@ -665,7 +730,7 @@
</div>


-<a name="N10142"></a><a name="relaxng"></a>
+<a name="N1017E"></a><a name="relaxng"></a>
<h2 class="underlined_10">Validation using RELAX NG</h2>
<div class="section">
<p>
@@ -681,6 +746,17 @@
know more about this, and perhaps extend it for your own use, then
see <span class="codefrag">main/webapp/resources/schema/relaxng/README.txt</span>
and the Ant targets in the various build.xml files.
+ </p>
+</div>
+
+
+<a name="N10191"></a><a name="sitemap"></a>
+<h2 class="underlined_10">Validation using Cocoon sitemap and the Cocoon Validation block</h2>
+<div class="section">
+<p>
+ The content of pipelines can be validated at various points in the Cocoon sitemaps
+ using RELAX NG or W3C XML Schema.
+ See <a href="../howto-dev.html#debug-validation">notes</a>.
</p>
</div>


Modified: forrest/site/docs_0_80/validation.pdf
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/validation.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/docs_0_80/your-project.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/your-project.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/docs_0_80/your-project.html (original)
+++ forrest/site/docs_0_80/your-project.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/document-v12.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v12.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/document-v12.html (original)
+++ forrest/site/dtdx/document-v12.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/document-v13.dtdx.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.dtdx.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/document-v13.dtdx.html (original)
+++ forrest/site/dtdx/document-v13.dtdx.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/document-v13.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/document-v13.html (original)
+++ forrest/site/dtdx/document-v13.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/document-v20.dtdx.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.dtdx.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/document-v20.dtdx.html (original)
+++ forrest/site/dtdx/document-v20.dtdx.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/document-v20.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/document-v20.html (original)
+++ forrest/site/dtdx/document-v20.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/dtd-docs.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/dtd-docs.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/dtd-docs.html (original)
+++ forrest/site/dtdx/dtd-docs.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/faq-v13.dtdx.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/faq-v13.dtdx.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/faq-v13.dtdx.html (original)
+++ forrest/site/dtdx/faq-v13.dtdx.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/faq-v20.dtdx.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/faq-v20.dtdx.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/faq-v20.dtdx.html (original)
+++ forrest/site/dtdx/faq-v20.dtdx.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/howto-v13.dtdx.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/howto-v13.dtdx.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/howto-v13.dtdx.html (original)
+++ forrest/site/dtdx/howto-v13.dtdx.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/dtdx/howto-v20.dtdx.html
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/howto-v20.dtdx.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/dtdx/howto-v20.dtdx.html (original)
+++ forrest/site/dtdx/howto-v20.dtdx.html Thu Apr 5 00:40:14 2007
@@ -223,7 +223,7 @@
<a href="../docs_0_80/cap.html">Sourcetype Action</a>
</div>
<div class="menuitem">
-<a href="../docs_0_80/validation.html">XML Validation</a>
+<a href="../docs_0_80/validation.html">XML validation and entity resolution</a>
</div>
</div>
<div class="menuitem">

Modified: forrest/site/forrest-issues.html
URL: http://svn.apache.org/viewvc/forrest/site/forrest-issues.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/forrest-issues.html (original)
+++ forrest/site/forrest-issues.html Thu Apr 5 00:40:14 2007
@@ -195,16 +195,13 @@
<div id="minitoc-area">
<ul class="minitoc">
<li>
-<a href="#%5BFOR-868%5D+add+relevant+notes+to+the+%22Upgrading%22+xdoc">[FOR-868] add relevant notes to the "Upgrading" xdoc</a>
-</li>
-<li>
<a href="#%5BFOR-855%5D+verify+the+license+situation+prior+to+each+release">[FOR-855] verify the license situation prior to each release</a>
</li>
<li>
-<a href="#%5BFOR-742%5D+trouble+accessing+unversioned+plugin+for+a+released+version+of+Forrest%2C+e.g.+projectInfo">[FOR-742] trouble accessing unversioned plugin for a released version of Forrest, e.g. projectInfo</a>
+<a href="#%5BFOR-868%5D+add+relevant+notes+to+the+%22Upgrading%22+xdoc">[FOR-868] add relevant notes to the "Upgrading" xdoc</a>
</li>
<li>
-<a href="#%5BFOR-977%5D+The+releaseNotes_*.html+has+Bugzilla+URLs+rather+than+Jira+URLs+for+linked+issues">[FOR-977] The releaseNotes_*.html has Bugzilla URLs rather than Jira URLs for linked issues</a>
+<a href="#%5BFOR-742%5D+trouble+accessing+unversioned+plugin+for+a+released+version+of+Forrest%2C+e.g.+projectInfo">[FOR-742] trouble accessing unversioned plugin for a released version of Forrest, e.g. projectInfo</a>
</li>
<li>
<a href="#%5BFOR-241%5D+character+entities+%28e.g.+ampersand%29+are+expanded+again+for+href+or+src+attributes">[FOR-241] character entities (e.g. ampersand) are expanded again for href or src attributes</a>
@@ -225,15 +222,7 @@
<a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?pid=12310000&resolutionIds=-1&tempMax=1000&reset=true">all</a> open issues).
The listing below is regenerated on each Forrest run.</div>
</div>
-<a name="N10011"></a><a name="%5BFOR-868%5D+add+relevant+notes+to+the+%22Upgrading%22+xdoc"></a>
-<h2 class="underlined_10">[FOR-868] add relevant notes to the "Upgrading" xdoc</h2>
-<div class="section">
-<p>
-<a href="http://issues.apache.org/jira/browse/FOR-868">http://issues.apache.org/jira/browse/FOR-868</a>
-</p>
-<p>We need to add some notes to the upgrading_0*.html doc for the upcoming release. This would most easily be done after attending to &lt;a href="https://issues.apache.org/jira/browse/FOR-865" title="Add missing entries to status.xml to generate the changes list"&gt;&lt;strike&gt;FOR-865&lt;/strike&gt;&lt;/a&gt; &amp;quot;Add missing entries to status.xml to generate the changes list&amp;quot;.</p>
-</div>
-<a name="N1001D"></a><a name="%5BFOR-855%5D+verify+the+license+situation+prior+to+each+release"></a>
+<a name="N10011"></a><a name="%5BFOR-855%5D+verify+the+license+situation+prior+to+each+release"></a>
<h2 class="underlined_10">[FOR-855] verify the license situation prior to each release</h2>
<div class="section">
<p>
@@ -248,6 +237,14 @@
B) Scan the whole trunk repository to add missing ASF license headers to source files and to ensure that the ASF license headers have not been accidently added to external files. See etc/relicense.txt&lt;br/&gt;
</p>
</div>
+<a name="N1001D"></a><a name="%5BFOR-868%5D+add+relevant+notes+to+the+%22Upgrading%22+xdoc"></a>
+<h2 class="underlined_10">[FOR-868] add relevant notes to the "Upgrading" xdoc</h2>
+<div class="section">
+<p>
+<a href="http://issues.apache.org/jira/browse/FOR-868">http://issues.apache.org/jira/browse/FOR-868</a>
+</p>
+<p>We need to add some notes to the upgrading_0*.html doc for the upcoming release. This would most easily be done after attending to &lt;a href="https://issues.apache.org/jira/browse/FOR-865" title="Add missing entries to status.xml to generate the changes list"&gt;&lt;strike&gt;FOR-865&lt;/strike&gt;&lt;/a&gt; &amp;quot;Add missing entries to status.xml to generate the changes list&amp;quot;.</p>
+</div>
<a name="N10029"></a><a name="%5BFOR-742%5D+trouble+accessing+unversioned+plugin+for+a+released+version+of+Forrest%2C+e.g.+projectInfo"></a>
<h2 class="underlined_10">[FOR-742] trouble accessing unversioned plugin for a released version of Forrest, e.g. projectInfo</h2>
<div class="section">
@@ -259,15 +256,7 @@
The solution is discussed here:&lt;br/&gt;
&lt;a href="http://marc.theaimsgroup.com/?t=113176328300002"&gt;http://marc.theaimsgroup.com/?t=113176328300002&lt;/a&gt;</p>
</div>
-<a name="N10035"></a><a name="%5BFOR-977%5D+The+releaseNotes_*.html+has+Bugzilla+URLs+rather+than+Jira+URLs+for+linked+issues"></a>
-<h2 class="underlined_10">[FOR-977] The releaseNotes_*.html has Bugzilla URLs rather than Jira URLs for linked issues</h2>
-<div class="section">
-<p>
-<a href="http://issues.apache.org/jira/browse/FOR-977">http://issues.apache.org/jira/browse/FOR-977</a>
-</p>
-<p>The changes_*.html are generated from status.xml and the references to &amp;quot;fixes-bug&amp;quot; issues are correctly constructed as Jira URLs. However the releaseNotes_*.html incorrectly has Bugzilla URLs. IIRC an entry in a site's forrest.properties handles this.</p>
-</div>
-<a name="N10041"></a><a name="%5BFOR-241%5D+character+entities+%28e.g.+ampersand%29+are+expanded+again+for+href+or+src+attributes"></a>
+<a name="N10035"></a><a name="%5BFOR-241%5D+character+entities+%28e.g.+ampersand%29+are+expanded+again+for+href+or+src+attributes"></a>
<h2 class="underlined_10">[FOR-241] character entities (e.g. ampersand) are expanded again for href or src attributes</h2>
<div class="section">
<p>
@@ -294,7 +283,7 @@
The ampersand in the link element text is properly handled but&lt;br/&gt;
the ampersand in the link href attribute is not.</p>
</div>
-<a name="N1004D"></a><a name="%5BFOR-922%5D+update+all+docs+that+explain+sitemap+fragments"></a>
+<a name="N10041"></a><a name="%5BFOR-922%5D+update+all+docs+that+explain+sitemap+fragments"></a>
<h2 class="underlined_10">[FOR-922] update all docs that explain sitemap fragments</h2>
<div class="section">
<p>
@@ -306,7 +295,7 @@
&lt;br/&gt;
These changes need to be reflected in the current docs.</p>
</div>
-<a name="N10059"></a><a name="%5BFOR-644%5D+code-style+cleanup+for+xml+files"></a>
+<a name="N1004D"></a><a name="%5BFOR-644%5D+code-style+cleanup+for+xml+files"></a>
<h2 class="underlined_10">[FOR-644] code-style cleanup for xml files</h2>
<div class="section">
<p>

Modified: forrest/site/forrest-issues.pdf
URL: http://svn.apache.org/viewvc/forrest/site/forrest-issues.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/index.html
URL: http://svn.apache.org/viewvc/forrest/site/index.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/index.html (original)
+++ forrest/site/index.html Thu Apr 5 00:40:14 2007
@@ -433,15 +433,13 @@
Documentation on the Apache Forrest website exists for various versions
including the latest release, the current development, and past releases.
All versions of Forrest include their own copy of the documentation.
- To view it, do 'cd site-author; forrest run' and visit
- http://localhost:8888/ in your browser.
- The <a href="http://forrest.apache.org/">Apache Forrest website</a> is updated
- manually as needed, while we develop the
- <a href="proposal-asf-forrestbot.html">forrestbot</a> deployment facility.
+ There is also documentation for each plugin and the forrest seed site
+ contains further examples and documentation (see
+ <a href="docs_0_80/faq.html#docs">FAQ</a>).
</p>
</div>

-<a name="N10110"></a><a name="news"></a>
+<a name="N1010C"></a><a name="news"></a>
<h2 class="underlined_10">News and events</h2>
<div class="section">
<p>See the <a href="events.html">events</a> list for more detail.
@@ -473,7 +471,7 @@
</ul>
</div>

-<a name="N1012B"></a><a name="help"></a>
+<a name="N10127"></a><a name="help"></a>
<h2 class="underlined_10">Help Wanted!</h2>
<div class="section">
<p>

Modified: forrest/site/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/index.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/linkmap.html
URL: http://svn.apache.org/viewvc/forrest/site/linkmap.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/linkmap.html (original)
+++ forrest/site/linkmap.html Thu Apr 5 00:40:14 2007
@@ -834,6 +834,7 @@



+

</ul>
</ul>
@@ -905,8 +906,13 @@

<ul>
<li>
-<a href="docs_0_80/validation.html">XML Validation</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>validation</em>
+<a href="docs_0_80/validation.html">XML validation and entity resolution</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>validation</em>
</li>
+<ul>
+
+
+
+</ul>
</ul>

</ul>

Modified: forrest/site/linkmap.pdf
URL: http://svn.apache.org/viewvc/forrest/site/linkmap.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/mirrors.html
URL: http://svn.apache.org/viewvc/forrest/site/mirrors.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/mirrors.html (original)
+++ forrest/site/mirrors.html Thu Apr 5 00:40:14 2007
@@ -202,7 +202,7 @@
<a href="#closest">Current official release (closest mirror site selected automatically)</a>
</li>
<li>
-<a href="#svn">Snapshots of current development and head SVN repository</a>
+<a href="#svn">Current development and head SVN repository</a>
</li>
<li>
<a href="#archive">Archive of old releases</a>
@@ -241,9 +241,9 @@
</ul>
</div>
<a name="N1007B"></a><a name="svn"></a>
-<h2 class="underlined_10">Snapshots of current development and head SVN repository</h2>
+<h2 class="underlined_10">Current development and head SVN repository</h2>
<div class="section">
-<p>If you want to use the latest Apache Forrest features, the source code is under version control with Subversion (read how to <a href="docs_0_70/build.html">obtain</a> your working copy).</p>
+<p>Developers can use the latest Apache Forrest features, the source code is under version control with Subversion (read how to <a href="docs_0_70/build.html">obtain</a> your working copy).</p>
</div>
<a name="N10087"></a><a name="archive"></a>
<h2 class="underlined_10">Archive of old releases</h2>
@@ -269,6 +269,9 @@
% gpg --verify apache-forrest-X.Y.tar.gz.asc
</pre>
<p>To verify the MD5 signature on the files, you need to use a program called <span class="codefrag">md5</span> or <span class="codefrag">md5sum</span>, which is included in many unix distributions. It is also available as part of <a href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</a>. Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">here</a>, <a href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or <a href="http://www.slavasoft.com/fsum/">here</a> or an openssl client from <a href="http://www.slproweb.com/products/Win32OpenSSL.html">here</a>.</p>
+<pre>% md5sum apache-forrest-X.Y.tar.gz
+... output should match the string in apache-forrest-X.Y.tar.gz.md5
+</pre>
<p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
</div>
</div>

Modified: forrest/site/mirrors.pdf
URL: http://svn.apache.org/viewvc/forrest/site/mirrors.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

Modified: forrest/site/procedures/release/How_to_release.html
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/How_to_release.html?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
--- forrest/site/procedures/release/How_to_release.html (original)
+++ forrest/site/procedures/release/How_to_release.html Thu Apr 5 00:40:14 2007
@@ -527,7 +527,7 @@
</li>

<li>
- Ensure that documentation structure and conntet is ready.
+ Ensure that documentation structure and content is ready.
</li>

<li>Ensure that the documentation is building properly, do 'cd site-author; forrest'. Fix any linking errors.</li>
@@ -702,6 +702,14 @@


<li>
+ Change the "fixfor" attribute to the next version for the
+ "project.issues-rss-url" RSS feed in the <span class="codefrag">site-author/forrest.properties</span> file.
+ Find the version number via the "Road Map" link at our Jira front page.
+ Verify localhost:8888/forrest-issues.html
+ </li>
+
+
+<li>

<p>Edit site-author/status.xml:</p>

@@ -765,7 +773,7 @@
</div>


-<a name="N101FA"></a><a name="BuildDist"></a>
+<a name="N10200"></a><a name="BuildDist"></a>
<h2 class="underlined_10">Building the release candidate packages</h2>
<div class="section">
<p>In this phase the Release Manager builds the release candidate to be tested.</p>
@@ -1009,7 +1017,7 @@
</div>


-<a name="N102C2"></a><a name="vote"></a>
+<a name="N102C8"></a><a name="vote"></a>
<h2 class="underlined_10">Testing the release candidate and voting</h2>
<div class="section">
<p>Get Forrest developers to test the actual packges on various platforms.</p>
@@ -1071,7 +1079,7 @@
</div>


-<a name="N102FE"></a><a name="FinalRel"></a>
+<a name="N10304"></a><a name="FinalRel"></a>
<h2 class="underlined_10">Finalizing the release</h2>
<div class="section">
<p>When a good release candidate has been achieved and affirmed by the vote, we'll finalize the release.</p>
@@ -1144,7 +1152,7 @@
</div>


-<a name="N10348"></a><a name="UploadAndAnnounce"></a>
+<a name="N1034E"></a><a name="UploadAndAnnounce"></a>
<h2 class="underlined_10">Upload and announcement</h2>
<div class="section">
<p>In this phase we'll upload the new Release, wait for it to be available on most mirror sites, then
@@ -1305,7 +1313,7 @@
</div>


-<a name="N103FE"></a><a name="cleanup"></a>
+<a name="N10404"></a><a name="cleanup"></a>
<h2 class="underlined_10">Cleanup</h2>
<div class="section">
<ol>
@@ -1368,11 +1376,6 @@
<li>
<p>Review the Issues for the old version and move any Incomplete ones up.</p>
</li>
-
-<li>
-<p>Change the "fixfor" attribute to the next version for the
- "project.issues-rss-url" RSS feed in forrest.properties</p>
-</li>

</ol>

@@ -1387,7 +1390,7 @@
</div>


-<a name="N1044C"></a><a name="conclusion"></a>
+<a name="N1044E"></a><a name="conclusion"></a>
<h2 class="underlined_10">Conclusion</h2>
<div class="section">
<p>All done!</p>

Modified: forrest/site/procedures/release/How_to_release.pdf
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/How_to_release.pdf?view=diff&rev=525747&r1=525746&r2=525747
==============================================================================
Binary files - no diff available.

©2024 GT.net. A Gossamer Threads company.
5th Floor, 455 Granville St., Vancouver, BC V6C 1T1, Canada | Legal