Author: crossley
Date: Thu Dec 28 22:53:21 2006
New Revision: 490928
URL: http://svn.apache.org/viewvc?view=rev&rev=490928
Log:
Automatic publish from forrestbot
Modified:
forrest/site/docs_0_80/upgrading_08.html
forrest/site/docs_0_80/upgrading_08.pdf
forrest/site/forrest-issues.html
forrest/site/forrest-issues.pdf
forrest/site/live-sites.html
forrest/site/live-sites.pdf
forrest/site/procedures/release/How_to_release.html
forrest/site/procedures/release/How_to_release.pdf
forrest/site/skin/screen.css
forrest/site/zone.html
forrest/site/zone.pdf
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=490928&r1=490927&r2=490928
==============================================================================
--- forrest/site/docs_0_80/upgrading_08.html (original)
+++ forrest/site/docs_0_80/upgrading_08.html Thu Dec 28 22:53:21 2006
@@ -338,6 +338,9 @@
<a href="#to2to">New filename convention for stylesheets</a>
</li>
<li>
+<a href="#docs">Notes about documentation</a>
+</li>
+<li>
<a href="#tips">General upgrade tips</a>
</li>
<li>
@@ -471,7 +474,23 @@
</div>
-<a name="N100BC"></a><a name="tips"></a>
+<a name="N100BC"></a><a name="docs"></a>
+<h2 class="underlined_10">Notes about documentation</h2>
+<div class="section">
+<p>After each release, the "Versioned Docs" are copied to form the new "dev" set.
+ Ideally the docs are then upgraded in readiness for the new release.
+ This has not been completed for the 0.8 release. In particular there are
+ example snippets of sitemaps which have not yet been upgraded to reflect the changes
to the sitemaps and the separation of some core stuff into plugins.
+ See issues
+ <a href="http://issues.apache.org/jira/browse/FOR-546">FOR-546</a>
+ and
+ <a href="http://issues.apache.org/jira/browse/FOR-922">FOR-922</a>
+ and others.
+ </p>
+</div>
+
+
+<a name="N100CE"></a><a name="tips"></a>
<h2 class="underlined_10">General upgrade tips</h2>
<div class="section">
<p>
@@ -490,7 +509,7 @@
</div>
-<a name="N100CC"></a><a name="To+be+continued..."></a>
+<a name="N100DE"></a><a name="To+be+continued..."></a>
<h2 class="underlined_10">To be continued...</h2>
<div class="section">
<p>...as more issues are discovered/remembered :) Please send feedback
Modified: forrest/site/docs_0_80/upgrading_08.pdf
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_80/upgrading_08.pdf?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
Binary files - no diff available.
Modified: forrest/site/forrest-issues.html
URL: http://svn.apache.org/viewvc/forrest/site/forrest-issues.html?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
--- forrest/site/forrest-issues.html (original)
+++ forrest/site/forrest-issues.html Thu Dec 28 22:53:21 2006
@@ -192,10 +192,10 @@
<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-865%5D+Add+missing+entries+to+status.xml+to+generate+the+changes+list">[FOR-865]
Add missing entries to status.xml to generate the changes list</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-868%5D+add+relevant+notes+to+the+%22Upgrading%22+xdoc">[FOR-868] add
relevant notes to the "Upgrading" xdoc</a>
+<a href="#%5BFOR-865%5D+Add+missing+entries+to+status.xml+to+generate+the+changes+list">[FOR-865]
Add missing entries to status.xml to generate the changes list</a>
</li>
<li>
<a href="#%5BFOR-911%5D+decide+content+of+release">[FOR-911] decide content of release</a>
@@ -246,6 +246,9 @@
<a href="#%5BFOR-936%5D+Forrest+%22looses%22+the+locale+when+switching+pages">[FOR-936]
Forrest "looses" the locale when switching pages</a>
</li>
<li>
+<a href="#%5BFOR-704%5D+span-template+in+html2document.xsl+doubles+span-content">[FOR-704]
span-template in html2document.xsl doubles span-content</a>
+</li>
+<li>
<a href="#%5BFOR-537%5D+Plugin+documentation+sitemap+references">[FOR-537] Plugin documentation
sitemap references</a>
</li>
<li>
@@ -260,9 +263,6 @@
<li>
<a href="#%5BFOR-767%5D+Forrestbot+webapp+reports+succesful+even+when+there+are+broken+links">[FOR-767]
Forrestbot webapp reports succesful even when there are broken links</a>
</li>
-<li>
-<a href="#%5BFOR-861%5D+Update+locationmap+docs+for+working+with+remote+files">[FOR-861]
Update locationmap docs for working with remote files</a>
-</li>
</ul>
</div>
<div class="note">
@@ -295,7 +295,15 @@
<br/>
</p>
</div>
-<a name="N1001D"></a><a name="%5BFOR-865%5D+Add+missing+entries+to+status.xml+to+generate+the+changes+list"></a>
+<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 <a href="http://issues.apache.org/jira/browse/FOR-865"
title="Add missing entries to status.xml to generate the changes list">FOR-865</a>
&quot;Add missing entries to status.xml to generate the changes list&quot;.</p>
+</div>
+<a name="N10029"></a><a name="%5BFOR-865%5D+Add+missing+entries+to+status.xml+to+generate+the+changes+list"></a>
<h2 class="underlined_10">[FOR-865] Add missing entries to status.xml to generate the
changes list</h2>
<div class="section">
<p>
@@ -313,14 +321,6 @@
<br/>
<a href="http://marc.theaimsgroup.com/?t=114274836600001">http://marc.theaimsgroup.com/?t=114274836600001</a></p>
</div>
-<a name="N10029"></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 <a href="http://issues.apache.org/jira/browse/FOR-865"
title="Add missing entries to status.xml to generate the changes list">FOR-865</a>
&quot;Add missing entries to status.xml to generate the changes list&quot;.</p>
-</div>
<a name="N10035"></a><a name="%5BFOR-911%5D+decide+content+of+release"></a>
<h2 class="underlined_10">[FOR-911] decide content of release</h2>
<div class="section">
@@ -593,7 +593,45 @@
<br/>
The fix is simple, patch to come soon.</p>
</div>
-<a name="N100F5"></a><a name="%5BFOR-537%5D+Plugin+documentation+sitemap+references"></a>
+<a name="N100F5"></a><a name="%5BFOR-704%5D+span-template+in+html2document.xsl+doubles+span-content"></a>
+<h2 class="underlined_10">[FOR-704] span-template in html2document.xsl doubles span-content</h2>
+<div class="section">
+<p>
+<a href="http://issues.apache.org/jira/browse/FOR-704">http://issues.apache.org/jira/browse/FOR-704</a>
+</p>
+<p>template for span-element traverses to children elements via xsl:apply-templates
TWICE!
+<br/>
+once in xsl:choose, than outside
+<br/>
+thus producing doubling the content of span.
+<br/>
+::
+<br/>
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;xsl:template match=&quot;span&quot;&gt;
+<br/>
+ &lt;xsl:choose&gt;
+<br/>
+&lt;!-- ... --&gt;
+<br/>
+ &lt;xsl:otherwise&gt;
+<br/>
+ &lt;!-- Strip --&gt;
+<br/>
+ &lt;xsl:apply-templates/&gt;
+<br/>
+ &lt;/xsl:otherwise&gt;
+<br/>
+ &lt;/xsl:choose&gt;
+<br/>
+&nbsp;&nbsp;&nbsp;&nbsp;
+<br/>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;xsl:apply-templates
select=&quot;./*&quot;/&gt;
+<br/>
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;/xsl:template&gt;
+<br/>
+</p>
+</div>
+<a name="N10101"></a><a name="%5BFOR-537%5D+Plugin+documentation+sitemap+references"></a>
<h2 class="underlined_10">[FOR-537] Plugin documentation sitemap references</h2>
<div class="section">
<p>
@@ -623,7 +661,7 @@
<br/>
--tim</p>
</div>
-<a name="N10101"></a><a name="%5BFOR-635%5D+images+not+reproduced+in+PDFs%2C+if+sources+are+in+xdocs%2Fimages+directory"></a>
+<a name="N1010D"></a><a name="%5BFOR-635%5D+images+not+reproduced+in+PDFs%2C+if+sources+are+in+xdocs%2Fimages+directory"></a>
<h2 class="underlined_10">[FOR-635] images not reproduced in PDFs, if sources are in
xdocs/images directory</h2>
<div class="section">
<p>
@@ -631,7 +669,7 @@
</p>
<p>We used to enable images to be placed in the xdocs/images directory. However, now
they are intended to go in the resources/images directory instead. Both methods will work
for html pages, but only the latter method for the PDF pages.</p>
</div>
-<a name="N1010D"></a><a name="%5BFOR-671%5D+Layering+error+of+HTML+headings+breaks+rest+of+the+page+w%2Fo+warning"></a>
+<a name="N10119"></a><a name="%5BFOR-671%5D+Layering+error+of+HTML+headings+breaks+rest+of+the+page+w%2Fo+warning"></a>
<h2 class="underlined_10">[FOR-671] Layering error of HTML headings breaks rest of
the page w/o warning</h2>
<div class="section">
<p>
@@ -693,7 +731,7 @@
<br/>
&lt;/html&gt;</p>
</div>
-<a name="N10119"></a><a name="%5BFOR-731%5D+empty+linkmap.html+document%2C+side-effect+of+workaround+to+FOR-675"></a>
+<a name="N10125"></a><a name="%5BFOR-731%5D+empty+linkmap.html+document%2C+side-effect+of+workaround+to+FOR-675"></a>
<h2 class="underlined_10">[FOR-731] empty linkmap.html document, side-effect of workaround
to FOR-675</h2>
<div class="section">
<p>
@@ -701,7 +739,7 @@
</p>
<p>The main/webapp/resources/stylesheets/linkmap-to-document.xsl has a workaround for
a side-effect to the of the workaround for issue <a href="http://issues.apache.org/jira/browse/FOR-675"
title="upgrading to commons-jxpath-1.2.jar causes failures with linkrewriter protocols site:
etc.">FOR-675</a>.</p>
</div>
-<a name="N10125"></a><a name="%5BFOR-767%5D+Forrestbot+webapp+reports+succesful+even+when+there+are+broken+links"></a>
+<a name="N10131"></a><a name="%5BFOR-767%5D+Forrestbot+webapp+reports+succesful+even+when+there+are+broken+links"></a>
<h2 class="underlined_10">[FOR-767] Forrestbot webapp reports succesful even when there
are broken links</h2>
<div class="section">
<p>
@@ -718,26 +756,6 @@
- ??
<br/>
</p>
-</div>
-<a name="N10131"></a><a name="%5BFOR-861%5D+Update+locationmap+docs+for+working+with+remote+files"></a>
-<h2 class="underlined_10">[FOR-861] Update locationmap docs for working with remote
files</h2>
-<div class="section">
-<p>
-<a href="http://issues.apache.org/jira/browse/FOR-861">http://issues.apache.org/jira/browse/FOR-861</a>
-</p>
-<p>The docs for retrieving content from remote locations [1] have not kept up with
Tims wonderful naming conventions for the locationmap [2]
-<br/>
-
-<br/>
-We need to update the docs to reflect the situation described in [3] (don't miss the correction
in the next message)
-<br/>
-
-<br/>
-[1] <a href="http://forrest.apache.org/docs_0_80/locationmap.html#source-via-http">http://forrest.apache.org/docs_0_80/locationmap.html#source-via-http</a>
-<br/>
-[2] <a href="http://forrest.apache.org/docs_0_80/locationmap.html#namingConvention">http://forrest.apache.org/docs_0_80/locationmap.html#namingConvention</a>
-<br/>
-[3] <a href="http://marc.theaimsgroup.com/?t=114492612100001&r=1&w=2">http://marc.theaimsgroup.com/?t=114492612100001&amp;r=1&amp;w=2</a></p>
</div>
</div>
<!--+
Modified: forrest/site/forrest-issues.pdf
URL: http://svn.apache.org/viewvc/forrest/site/forrest-issues.pdf?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
Binary files - no diff available.
Modified: forrest/site/live-sites.html
URL: http://svn.apache.org/viewvc/forrest/site/live-sites.html?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
--- forrest/site/live-sites.html (original)
+++ forrest/site/live-sites.html Thu Dec 28 22:53:21 2006
@@ -506,7 +506,7 @@
<a href="http://maemo.org/">Maemo</a> -
open development platform to create applications
for Nokia 770 Internet Tablet and other maemo compliant
- handheld devices in the future.</li>
+ handheld devices in the future.</li>
<li>
<a href="http://www.primordion.com/Xholon/">Xholon</a>
@@ -521,13 +521,25 @@
<li>
<a href="http://www.erbox.org/">ER/Box Site</a> An all Java, open source ERP
system built on Compiere and Apache Derby. Some customisations have been <a href="http://www.erbox.org/documentation/Other/ForrestNotes/forrestNotesOverview.html">documented</a>.</li>
+
+<li>
+<a href="http://apfw.sourceforge.net/">Apparatus Framework</a> -
+ An object-oriented software framework written in C++ for
+ embedded applications.</li>
+
+<li>
+<a href="http://www.skiclub-troisdorf.de/">Skiclub
+ Troisdorf-Sieglar e.V.</a> The skiclub aims to provide ski related
+ activities and social events for our members in and around Troisdorf area
+ (near Cologne and Bonn).</li>
+
<!-- <li><link href=""></link></li> -->
</ul>
</div>
-<a name="N101DD"></a><a name="dispatcher"></a>
+<a name="N101E9"></a><a name="dispatcher"></a>
<h2 class="underlined_10">Sites using upcoming Dispatcher</h2>
<div class="section">
<p>The skinning system in versions of Forrest up to and including 0.7 was great,
Modified: forrest/site/live-sites.pdf
URL: http://svn.apache.org/viewvc/forrest/site/live-sites.pdf?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
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=490928&r1=490927&r2=490928
==============================================================================
--- forrest/site/procedures/release/How_to_release.html (original)
+++ forrest/site/procedures/release/How_to_release.html Thu Dec 28 22:53:21 2006
@@ -347,6 +347,10 @@
</li>
+<li>Add relevant information to the
+ <a href="http://issues.apache.org/jira/browse/FOR-868">upgrading notes</a>.
+ </li>
+
<li>
<p>Major changes are listed in the site-author/status.xml using the "importance"
attribute. This will be used to generate the list of top changes for the
Release Notes
@@ -377,7 +381,7 @@
</div>
</div>
-<a name="N10066"></a><a name="PrepProject"></a>
+<a name="N1006D"></a><a name="PrepProject"></a>
<h2 class="underlined_10">Preparing the project for the release</h2>
<div class="section">
<p>In this step the Release Manager starts the process to finalise the outstanding
blocker issues. </p>
@@ -407,7 +411,7 @@
</div>
-<a name="N1008D"></a><a name="PrepRM"></a>
+<a name="N10094"></a><a name="PrepRM"></a>
<h2 class="underlined_10">Preparations for the Release Manager</h2>
<div class="section">
<p>Particularly the Release Manager, but also anyone assisting, needs to be familiar
@@ -448,7 +452,7 @@
</div>
-<a name="N100BB"></a><a name="PrepRelPlan"></a>
+<a name="N100C2"></a><a name="PrepRelPlan"></a>
<h2 class="underlined_10">Preparing the Release Plan</h2>
<div class="section">
<p>Prepare the Release Plan to define the corner stones of the coming release</p>
@@ -484,7 +488,7 @@
</div>
-<a name="N100EE"></a><a name="PrepCodeBase"></a>
+<a name="N100F5"></a><a name="PrepCodeBase"></a>
<h2 class="underlined_10">Preparing the code base</h2>
<div class="section">
<ol>
@@ -527,7 +531,7 @@
</div>
-<a name="N1011C"></a><a name="PrepTrunk"></a>
+<a name="N10123"></a><a name="PrepTrunk"></a>
<h2 class="underlined_10">Preparing your working copy of SVN trunk</h2>
<div class="section">
<div class="fixme">
@@ -575,7 +579,7 @@
</div>
-<a name="N1014D"></a><a name="PrepDistSvn"></a>
+<a name="N10154"></a><a name="PrepDistSvn"></a>
<h2 class="underlined_10">Preparing the "dist" SVN</h2>
<div class="section">
<p>The SVN at
@@ -592,7 +596,7 @@
</div>
-<a name="N10161"></a><a name="adjustDocs"></a>
+<a name="N10168"></a><a name="adjustDocs"></a>
<h2 class="underlined_10">Preparing docs for next release cycle</h2>
<div class="section">
<p>In this phase we get the docs ready for the release. You will
@@ -656,7 +660,7 @@
<li>
-<p>Adjust version-numbers in site.xml.</p>
+<p>Adjust version-numbers in site.xml</p>
<div class="fixme">
<div class="label">Fixme (fso)</div>
@@ -677,9 +681,15 @@
</li>
-
-
+
+<li>
+
+<p>Edit site-author/conf/cli.xconf where it excludes old docs from being generated
(a trick to speed up).
+ Adjust the version numbers. Comment-out these exclusions until after
the release.
+ </p>
+
+</li>
<li>
@@ -712,6 +722,8 @@
</li>
+<li>Temporarily remove the "dev" note from upgrading_xy.xml</li>
+
<li>
<p>Edit the Forrest home page in the "News and events" section and add a text like:</p>
@@ -746,7 +758,7 @@
</div>
-<a name="N101D4"></a><a name="BuildDist"></a>
+<a name="N101E4"></a><a name="BuildDist"></a>
<h2 class="underlined_10">Building the distribution</h2>
<div class="section">
<p>In this phase you build the release candidate to be tested.</p>
@@ -804,7 +816,7 @@
<div class="content">It is not your job to fix bugs and code freeze should not commence
with a broken trunk.</div>
</div>
-<p>If there are bugs that cannot be easily fixed, then call a halt to the release process
and start
+<p>If there are bugs with the build system that cannot be easily fixed, then call a
halt to the release process and start
a discussion on rescheduling options on the dev-list with the template
<a href="rc_did_not_build_what_now.txt">rc_did_not_build_what_now.txt</a>
</p>
@@ -1026,7 +1038,7 @@
</div>
-<a name="N102CA"></a><a name="Testing+the+release+candidate+and+voting"></a>
+<a name="N102DA"></a><a name="Testing+the+release+candidate+and+voting"></a>
<h2 class="underlined_10">Testing the release candidate and voting</h2>
<div class="section">
<p>Get Forrest developers to test the actual distribution on various platforms.</p>
@@ -1084,7 +1096,7 @@
</div>
-<a name="N10306"></a><a name="FinalRel"></a>
+<a name="N10316"></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>
@@ -1151,7 +1163,7 @@
</div>
-<a name="N1034C"></a><a name="UploadAndAnnounce"></a>
+<a name="N1035C"></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
@@ -1307,7 +1319,7 @@
</div>
-<a name="N103FB"></a><a name="cleanup"></a>
+<a name="N1040B"></a><a name="cleanup"></a>
<h2 class="underlined_10">Cleanup</h2>
<div class="section">
<ol>
@@ -1333,6 +1345,10 @@
</li>
+<li>Return the "dev" note to upgrading_xy.xml</li>
+
+<li>Edit site-author/conf/cli.xconf to exclude the old docs again.</li>
+
<li>Commit all of the above changes.</li>
<li>
@@ -1399,7 +1415,7 @@
</div>
-<a name="N10449"></a><a name="conclusion"></a>
+<a name="N1045F"></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=490928&r1=490927&r2=490928
==============================================================================
Binary files - no diff available.
Modified: forrest/site/skin/screen.css
URL: http://svn.apache.org/viewvc/forrest/site/skin/screen.css?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
--- forrest/site/skin/screen.css (original)
+++ forrest/site/skin/screen.css Thu Dec 28 22:53:21 2006
@@ -559,6 +559,7 @@
}
.printlink {
+ position: relative; /* IE bugfix cont'd */
float: right;
}
.printlink br {
Modified: forrest/site/zone.html
URL: http://svn.apache.org/viewvc/forrest/site/zone.html?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
--- forrest/site/zone.html (original)
+++ forrest/site/zone.html Thu Dec 28 22:53:21 2006
@@ -269,6 +269,7 @@
<a href="http://forrest.zones.apache.org/">forrest.zones.apache.org</a>
provides our testing and demonstration area.
It is managed by Apache Forrest committers.
+ The material is intended for developer use only.
</p>
</div>
Modified: forrest/site/zone.pdf
URL: http://svn.apache.org/viewvc/forrest/site/zone.pdf?view=diff&rev=490928&r1=490927&r2=490928
==============================================================================
Binary files - no diff available.
|