You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-svn@forrest.apache.org by cr...@apache.org on 2008/09/13 11:45:25 UTC
svn commit: r694909 [2/2] - in /forrest/site: ./ docs_0_90/ docs_0_90/howto/
docs_0_90/howto/cvs-ssh/ docs_0_90/howto/multi/ dtdx/ plan/ pluginDocs/
pluginDocs/plugins_0_70/ pluginDocs/plugins_0_80/ pluginDocs/plugins_0_90/
procedures/ procedures/relea...
Added: forrest/site/howto-forrestbot-scp.html
URL: http://svn.apache.org/viewvc/forrest/site/howto-forrestbot-scp.html?rev=694909&view=auto
==============================================================================
--- forrest/site/howto-forrestbot-scp.html (added)
+++ forrest/site/howto-forrestbot-scp.html Sat Sep 13 02:45:20 2008
@@ -0,0 +1,481 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.9-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<title>How to deploy documentation with the Forrestbot "scp" workstage</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">
+<link type="text/css" href="skin/profile.css" rel="stylesheet">
+<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://forrest.apache.org/">forrest</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="index.html">Welcome</a>
+</li>
+<li class="current">
+<a class="selected" href="contrib.html">Developers</a>
+</li>
+<li>
+<a class="unselected" href="versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="unselected" href="pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="unselected" href="tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', 'skin/')" id="menu_1.1Title" class="menutitle">Getting involved</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="contrib.html" title="Everyone is a developer and has something to contribute">Contributing</a>
+</div>
+<div class="menuitem">
+<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists and discussion</a>
+</div>
+<div class="menuitem">
+<a href="issues.html" title="Issue tracker manages known issues and desired enhancements">Reporting bugs and issues</a>
+</div>
+<div class="menuitem">
+<a href="forrest-friday.html" title="ForrestFriday monthly get-together">ForrestFriday IRC</a>
+</div>
+<div class="menuitem">
+<a href="events.html" title="List of upcoming related conferences and meetings">Events</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.6', 'skin/')" id="menu_1.1.6Title" class="menutitle">Project</div>
+<div id="menu_1.1.6" class="menuitemgroup">
+<div class="menuitem">
+<a href="guidelines.html" title="Open development guidelines to encourage participation">Project guidelines</a>
+</div>
+<div class="menuitem">
+<a href="committed.html" title="Notes about contribution">Being committed</a>
+</div>
+<div class="menuitem">
+<a href="roles.html" title="Tasks to keep the project flowing">Project roles</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Resources and Infrastructure</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="asf-infrastructure.html" title="Explain the ASF infrastructure">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists</a>
+</div>
+<div class="menuitem">
+<a href="issues.html" title="Issue tracker manages known issues and desired enhancements">Issue management</a>
+</div>
+<div class="menuitem">
+<a href="svn.html" title="Access to the Subversion (SVN) version control system">Version control</a>
+</div>
+<div class="menuitem">
+<a href="http://forrest.zones.apache.org/" title="Demonstrations and testbed at forrest.zones.apache.org">Demonstrations</a>
+</div>
+<div class="menuitem">
+<a href="gump.html">Gump integration</a>
+</div>
+<div onclick="SwitchMenu('menu_1.2.7', 'skin/')" id="menu_1.2.7Title" class="menutitle">Planning notes</div>
+<div id="menu_1.2.7" class="menuitemgroup">
+<div class="menuitem">
+<a href="plan/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="plan/internal-xhtml.html">Internal XHTML</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="todo.html">Todo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', 'skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Best Practices and Procedures</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Forrestbot scp</div>
+</div>
+<div class="menuitem">
+<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
+</div>
+<div class="menuitem">
+<a href="documentation_bestpractices.html" title="Best practice notes for documentation">Documentation</a>
+</div>
+<div class="menuitem">
+<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
+</div>
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
+<div class="menuitem">
+<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
+</div>
+<div class="menuitem">
+<a href="procedures/release/How_to_release.html" title="Instructions on preparing and creating a new Forrest release.">How to release</a>
+</div>
+<div class="menuitem">
+<a href="procedures/How_to_publish_docs.html" title="Instructions on publishing the Forrest Website">Publishing Forrest documentation</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Proposals</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="proposal-asf-forrestbot.html">ASF Forrestbot</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+<div id="credit2">
+<a href="http://us.apachecon.com/"><img border="0" title="ApacheCon US 2008" alt="ApacheCon US 2008 - logo" src="http://apache.org/ads/ApacheCon/2008-usa-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="howto-forrestbot-scp.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>How to deploy documentation with the Forrestbot "scp" workstage</h1>
+<div id="front-matter">
+<div class="abstract">
+ This How-To describes the building and deployment of a documentation set
+ with the help of the forrestbot "scp" workstage.
+ </div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Intended Audience">Intended Audience</a>
+</li>
+<li>
+<a href="#Purpose">Purpose</a>
+</li>
+<li>
+<a href="#Prerequisites">Prerequisites</a>
+</li>
+<li>
+<a href="#Steps">Steps</a>
+<ul class="minitoc">
+<li>
+<a href="#introduction">Introduction</a>
+</li>
+<li>
+<a href="#settings">The deploy.scp.settings file</a>
+</li>
+<li>
+<a href="#buildfile">The Forrestbot buildfile</a>
+</li>
+<li>
+<a href="#checksums">The Cocoon "checksums" facility</a>
+</li>
+<li>
+<a href="#build">The "build" workstage</a>
+</li>
+<li>
+<a href="#deploy">The "deploy" workstage</a>
+</li>
+<li>
+<a href="#production">Moving the documents into production</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Further Reading">Further Reading</a>
+</li>
+</ul>
+</div>
+</div>
+<a name="N10010"></a><a name="Intended Audience"></a>
+<h2 class="underlined_10">Intended Audience</h2>
+<div class="section">
+<p>
+ Anyone who generates a static documentation set with Forrest will need
+ to deploy the results, whether that be to a remote server or locally.
+ </p>
+</div>
+<a name="N10018"></a><a name="Purpose"></a>
+<h2 class="underlined_10">Purpose</h2>
+<div class="section">
+<p>
+ This howto will explain one method of using the Forrestbot, by way of the
+ worked example for managing a company or private website, and using "Secure Copy (SCP)" to deploy to a remote webserver. The Forrestbot has a number of deployment methods. After you understand the principles then you will be able to apply that to whatever method is relevant.
+ </p>
+<p>
+ The secondary purpose is to explain to ASF committers how to manage
+ project documentation, e.g. for an "Apache Labs" investigation.
+ </p>
+<p>
+ This howto also explains the use of the Apache Cocoon "checksums" facility
+ to only process and deploy the changed files.
+ </p>
+</div>
+<a name="N10026"></a><a name="Prerequisites"></a>
+<h2 class="underlined_10">Prerequisites</h2>
+<div class="section">
+<p>
+ Refer to the <a href="tools/forrestbot.html">Forrestbot</a> documentation.
+ It is not necessary to have thorough knowledge, but a basic understanding
+ will help.
+ </p>
+<p>
+ An account on a server configured to use SSH access.
+ e.g. <a href="http://apache.org/dev/new-committers-guide.html#ssh">ASF Guide for new committers</a>.
+ </p>
+<p>
+ Review the <a href="howto-forrestbot-svn.html">Forrestbot svn</a> howto documentation.
+ That explains more generally how to use a Forrestbot.
+ </p>
+<p>
+ Therefore this "scp" howto can have minimal content.
+ </p>
+</div>
+<a name="N10043"></a><a name="Steps"></a>
+<h2 class="underlined_10">Steps</h2>
+<div class="section">
+<a name="N10048"></a><a name="introduction"></a>
+<h3 class="underlined_5">Introduction</h3>
+<p>
+ This Forrestbot uses the "getsrc.local" workstage to retrieve the sources from the local project workspace filesystem, i.e. from the top-level of your Forrest project site.
+ </p>
+<p>
+ This Forrestbot uses the "deploy.scp" workstage to copy the generated documents
+ to the remote server. They go into a "stage" directory on the web server
+ which has a .htaccess file to enable selected people to review before putting into production.
+ </p>
+<a name="N10055"></a><a name="settings"></a>
+<h3 class="underlined_5">The deploy.scp.settings file</h3>
+<p>
+ Create a file at the top-level of your project site named
+ <span class="codefrag">deploy.scp.settings</span> to provide your ssh credentials.
+ Set its file permissions so that only you can read it.
+ </p>
+<pre class="code"><?xml version="1.0"?>
+<project>
+ <property name="deploy.scp.keyfile" value="/Users/me/.ssh/id_rsa"/>
+ <property name="deploy.scp.passphrase" value="#$!*%#..."/>
+</project></pre>
+<a name="N10066"></a><a name="buildfile"></a>
+<h3 class="underlined_5">The Forrestbot buildfile</h3>
+<p>
+ The Forrestbot buildfile sets some properties and declares the workstages (i.e. Ant targets) that need to be carried out. Of course this is fully explained in the <a href="tools/forrestbot.html">Forrestbot</a>
+ documentation.
+ </p>
+<p>
+ Create a file at the top-level of your project website named, e.g.
+ <span class="codefrag">publish-stage.xml</span>
+
+</p>
+<pre class="code"><?xml version="1.0"?>
+<project name="my-lab-docs" default="main">
+ <property name="getsrc.local.root-dir" location="."/>
+ <target name="getsrc" depends="getsrc.clean-workdir, getsrc.local"/>
+ <property name="deploy.scp.dest"
+ value="username@apache.org:public_html/my-lab/stage"/>
+ <import file="deploy.settings" optional="true"/>
+ <target name="deploy" depends="deploy.scp"/>
+ <property environment="env"/>
+ <import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
+</project></pre>
+<p>
+ So it gets the sources relative to the current directory. Actually
+ it reads the <span class="codefrag">forrest.properties</span> configuration file
+ to find out where other stuff is located.
+ </p>
+<p>
+ It deploys the generated files directly to the user's "public_html" webspace
+ into a "stage" sub-directory. Of course this "deploy.scp.dest" location
+ could be a full pathname to an htdocs directory on the remove remote server.
+ </p>
+<a name="N10087"></a><a name="checksums"></a>
+<h3 class="underlined_5">The Cocoon "checksums" facility</h3>
+<p>
+ Instruct Forrest's Cocoon to use a "checksums" file to record the checksum
+ of each document that it has processed. This enables subsequent builds to
+ only process the documents that have changed. This means that each file's
+ timestamp will only be touched if it is a changed document, which enables
+ the Forrestbot deploy.scp workstage to only deploy the changed files.
+ </p>
+<p>
+ Follow the "<a href="docs_0_90/faq.html#checksums">checksums</a>" FAQ.
+ </p>
+<a name="N10098"></a><a name="build"></a>
+<h3 class="underlined_5">The "build" workstage</h3>
+<p>
+ After doing the usual process to edit source documents, review them with
+ 'forrest run', and ensure that things are in order with 'forrest validate'.
+ </p>
+<p>
+ Now do the build:
+ </p>
+<pre class="code">forrest -f publish-stage.xml build</pre>
+<p>
+ This does the normal site build to generate the complete set of static documents. Watch for errors.
+ </p>
+<p>
+ To review, see the built docs in <span class="codefrag">build/my-lab-docs</span> directory.
+ </p>
+<a name="N100B2"></a><a name="deploy"></a>
+<h3 class="underlined_5">The "deploy" workstage</h3>
+<p>
+ When satisfied, then deploy the built docs:
+ </p>
+<pre class="code">forrest -f publish-satge.xml deploy</pre>
+<p>
+ The files that are being transferred to the remote server will now be listed.
+ </p>
+<a name="N100C3"></a><a name="production"></a>
+<h3 class="underlined_5">Moving the documents into production</h3>
+<p>
+ The reason for deploying the documents into a "stage" directory was so that
+ clients or collaborators could review it before going into production.
+ So ask them to review your people.apache.org/my-lab/stage/ site.
+ When satisfied, then:
+ </p>
+<pre class="code">ssh people.apache.org
+cd publish_html/my-lab/stage
+cp -Rf * ..
+</pre>
+<p>
+ That is it.
+ </p>
+</div>
+<a name="N100D4"></a><a name="Further Reading"></a>
+<h2 class="underlined_10">Further Reading</h2>
+<div class="section">
+<ul>
+
+<li>
+<a href="howto-forrestbot-svn.html">How to deploy documentation with the Forrestbot "svn" workstage</a>
+</li>
+
+<li>
+<a href="tools/forrestbot.html">Forrestbot - automated building and deploying</a>
+</li>
+
+</ul>
+</div>
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2008 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/howto-forrestbot-scp.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/howto-forrestbot-scp.pdf
URL: http://svn.apache.org/viewvc/forrest/site/howto-forrestbot-scp.pdf?rev=694909&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/howto-forrestbot-scp.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/howto-forrestbot-svn.html
URL: http://svn.apache.org/viewvc/forrest/site/howto-forrestbot-svn.html?rev=694909&view=auto
==============================================================================
--- forrest/site/howto-forrestbot-svn.html (added)
+++ forrest/site/howto-forrestbot-svn.html Sat Sep 13 02:45:20 2008
@@ -0,0 +1,488 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.9-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<title>How to deploy documentation with the Forrestbot "svn" workstage</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">
+<link type="text/css" href="skin/profile.css" rel="stylesheet">
+<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://forrest.apache.org/">forrest</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="index.html">Welcome</a>
+</li>
+<li class="current">
+<a class="selected" href="contrib.html">Developers</a>
+</li>
+<li>
+<a class="unselected" href="versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="unselected" href="pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="unselected" href="tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', 'skin/')" id="menu_1.1Title" class="menutitle">Getting involved</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="contrib.html" title="Everyone is a developer and has something to contribute">Contributing</a>
+</div>
+<div class="menuitem">
+<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists and discussion</a>
+</div>
+<div class="menuitem">
+<a href="issues.html" title="Issue tracker manages known issues and desired enhancements">Reporting bugs and issues</a>
+</div>
+<div class="menuitem">
+<a href="forrest-friday.html" title="ForrestFriday monthly get-together">ForrestFriday IRC</a>
+</div>
+<div class="menuitem">
+<a href="events.html" title="List of upcoming related conferences and meetings">Events</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.6', 'skin/')" id="menu_1.1.6Title" class="menutitle">Project</div>
+<div id="menu_1.1.6" class="menuitemgroup">
+<div class="menuitem">
+<a href="guidelines.html" title="Open development guidelines to encourage participation">Project guidelines</a>
+</div>
+<div class="menuitem">
+<a href="committed.html" title="Notes about contribution">Being committed</a>
+</div>
+<div class="menuitem">
+<a href="roles.html" title="Tasks to keep the project flowing">Project roles</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Resources and Infrastructure</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="asf-infrastructure.html" title="Explain the ASF infrastructure">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists</a>
+</div>
+<div class="menuitem">
+<a href="issues.html" title="Issue tracker manages known issues and desired enhancements">Issue management</a>
+</div>
+<div class="menuitem">
+<a href="svn.html" title="Access to the Subversion (SVN) version control system">Version control</a>
+</div>
+<div class="menuitem">
+<a href="http://forrest.zones.apache.org/" title="Demonstrations and testbed at forrest.zones.apache.org">Demonstrations</a>
+</div>
+<div class="menuitem">
+<a href="gump.html">Gump integration</a>
+</div>
+<div onclick="SwitchMenu('menu_1.2.7', 'skin/')" id="menu_1.2.7Title" class="menutitle">Planning notes</div>
+<div id="menu_1.2.7" class="menuitemgroup">
+<div class="menuitem">
+<a href="plan/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="plan/internal-xhtml.html">Internal XHTML</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="todo.html">Todo</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', 'skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Best Practices and Procedures</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Forrestbot svn</div>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
+<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
+</div>
+<div class="menuitem">
+<a href="documentation_bestpractices.html" title="Best practice notes for documentation">Documentation</a>
+</div>
+<div class="menuitem">
+<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
+</div>
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
+<div class="menuitem">
+<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
+</div>
+<div class="menuitem">
+<a href="procedures/release/How_to_release.html" title="Instructions on preparing and creating a new Forrest release.">How to release</a>
+</div>
+<div class="menuitem">
+<a href="procedures/How_to_publish_docs.html" title="Instructions on publishing the Forrest Website">Publishing Forrest documentation</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Proposals</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="proposal-asf-forrestbot.html">ASF Forrestbot</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+<div id="credit2">
+<a href="http://us.apachecon.com/"><img border="0" title="ApacheCon US 2008" alt="ApacheCon US 2008 - logo" src="http://apache.org/ads/ApacheCon/2008-usa-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="howto-forrestbot-svn.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>How to deploy documentation with the Forrestbot "svn" workstage</h1>
+<div id="front-matter">
+<div class="abstract">
+ This How-To describes the building and deployment of a documentation set
+ with the help of the forrestbot "svn" workstage.
+ </div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Intended Audience">Intended Audience</a>
+</li>
+<li>
+<a href="#Purpose">Purpose</a>
+</li>
+<li>
+<a href="#Prerequisites">Prerequisites</a>
+</li>
+<li>
+<a href="#Steps">Steps</a>
+<ul class="minitoc">
+<li>
+<a href="#introduction">Introduction</a>
+</li>
+<li>
+<a href="#follow">Follow along on your local system</a>
+</li>
+<li>
+<a href="#settings">The deploy.svn.settings file</a>
+</li>
+<li>
+<a href="#buildfile">The Forrestbot buildfile</a>
+</li>
+<li>
+<a href="#build">The "build" workstage</a>
+</li>
+<li>
+<a href="#deploy">The "deploy" workstage</a>
+</li>
+<li>
+<a href="#production">Moving the documents into production</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Further Reading">Further Reading</a>
+</li>
+</ul>
+</div>
+</div>
+<a name="N10010"></a><a name="Intended Audience"></a>
+<h2 class="underlined_10">Intended Audience</h2>
+<div class="section">
+<p>
+ Anyone who generates a static documentation set with Forrest will need
+ to deploy the results, whether that be to a remote server or locally.
+ </p>
+</div>
+<a name="N10018"></a><a name="Purpose"></a>
+<h2 class="underlined_10">Purpose</h2>
+<div class="section">
+<p>
+ This howto will explain one method of using the Forrestbot, by way of the
+ worked example for managing the Apache Forrest project website. The Forrestbot has a number of deployment methods. After you understand the principles then you will be able to apply that to whatever method is relevant.
+ </p>
+<p>
+ The secondary purpose is to explain to Forrest committers how to manage
+ our project documentation. Other ASF projects will also find it useful.
+ </p>
+</div>
+<a name="N10023"></a><a name="Prerequisites"></a>
+<h2 class="underlined_10">Prerequisites</h2>
+<div class="section">
+<p>
+ Refer to the <a href="tools/forrestbot.html">Forrestbot</a> documentation.
+ It is not necessary to have thorough knowledge, but a basic understanding
+ will help.
+ </p>
+</div>
+<a name="N1002F"></a><a name="Steps"></a>
+<h2 class="underlined_10">Steps</h2>
+<div class="section">
+<a name="N10034"></a><a name="introduction"></a>
+<h3 class="underlined_5">Introduction</h3>
+<p>
+ In this document "we/our" refers to the Apache Forrest project committers, who
+ manage the documentation. Even though other developers can help to
+ enhance the documentation by way of contributed patches, only the set of
+ committers can deploy (publish) it.
+ </p>
+<p>
+ Our source documents are managed in the project's Subversion (SVN) version control system. Each committer has a local SVN working copy on their office computer. We can prepare source changes and review them with 'forrest run' and 'forrest validate-xdocs'. When satisfied we 'svn commit' those changes. Our Forrestbot uses the "getsrc.local" workstage to retrieve the sources from the local svn checkout.
+ </p>
+<p>
+ The generated static documents which form the website are also stored in SVN. So our Forrestbot uses the "deploy.svn" workstage to deploy the generated documents. To publish the website, a regular cron job on the apache.org server automatically does 'svn update' in the website's document space. Elegant.
+ </p>
+<p>
+ That is what we call a "local forrestbot". Each committer can conduct
+ the workstages on their local computer. This enables a distributed team to manage the documentation.
+ </p>
+<p>
+ We have another Forrestbot on our "zone"
+ <a href="http://forrest.zones.apache.org/">demonstration server</a>.
+ It runs automatically via cron each hour. Its workstages are not described in this howto, but essentially it gets the sources using the "getsrc.svn" workstage and it deploys the results to the local webserver htdocs directory on that machine using the "deploy.local" workstage. See that <a href="http://svn.apache.org/repos/asf/forrest/zone/htdocs/ft/forrest-docs.xml">buildfile</a>.
+ </p>
+<a name="N10052"></a><a name="follow"></a>
+<h3 class="underlined_5">Follow along on your local system</h3>
+<p>
+ You have all the sources for the Forrest project in your Forrest distribution in the "$FORREST_HOME/site-author" directory. If you are using the release then you have a snapshot of the documentation. Of course if you have SVN trunk then you are up-to-date.
+ </p>
+<p>
+ The Forrestbot build files for our site are also available. This means that you can run the "build" workstage. However you will not be able to do the "deploy" worskstage unless you are a Forrest committer.
+ </p>
+<p>
+ There is a brief explanation of how to publish our site in the document
+ <a href="http://svn.apache.org/repos/asf/forrest/trunk/etc/publishing_our_site.txt">$FORREST_HOME/etc/publishing_our_site.txt</a>
+
+</p>
+<a name="N10066"></a><a name="settings"></a>
+<h3 class="underlined_5">The deploy.svn.settings file</h3>
+<p>
+ As explained in the above document, each committer needs a
+ <span class="codefrag">deploy.svn.settings</span> file to provide their credentials.
+ </p>
+<pre class="code"><?xml version="1.0"?>
+<project>
+ <property name="deploy.svn.user" value="myApacheUsername"/>
+ <property name="deploy.svn.password" value="mySvnPassword"/>
+</project></pre>
+<a name="N10077"></a><a name="buildfile"></a>
+<h3 class="underlined_5">The Forrestbot buildfile</h3>
+<p>
+ The Forrestbot buildfile sets some properties and declares the workstages (i.e. Ant targets) that need to be carried out. Of course this is fully explained in the <a href="tools/forrestbot.html">Forrestbot</a>
+ documentation.
+ </p>
+<p>
+ Our buildfile is at
+ <a href="http://svn.apache.org/repos/asf/forrest/trunk/site-author/publish.xml">$FORREST_HOME/site-author/publish.xml</a>
+ ...
+ </p>
+<pre class="code"><?xml version="1.0"?>
+<project name="forrest-docs" default="main">
+ <property name="getsrc.local.root-dir" location="."/>
+ <target name="getsrc" depends="getsrc.clean-workdir, getsrc.local"/>
+ <import file="../deploy.svn.settings" optional="true"/>
+ <property name="deploy.svn.url"
+ value="https://svn.apache.org/repos/asf/forrest/site"/>
+ <target name="deploy" depends="deploy.svn"/>
+ <property environment="env"/>
+ <import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
+</project></pre>
+<p>
+ So it gets the sources relative to the current directory. Actually
+ it reads the <span class="codefrag">forrest.properties</span> configuration file
+ to find out where other stuff is located.
+ </p>
+<p>
+ It deploys the generated files directly to the forrest/site SVN repository.
+ </p>
+<a name="N10099"></a><a name="build"></a>
+<h3 class="underlined_5">The "build" workstage</h3>
+<p>
+ After doing the usual process to edit source documents, review them with
+ 'forrest run', and ensure that things are in order with 'forrest validate'.
+ </p>
+<p>
+ Now do the build:
+ </p>
+<pre class="code">cd $FORREST_HOME/site-author
+forrest -f publish.xml build</pre>
+<p>
+ This does the normal site build to generate the complete set of static documents. Watch for errors.
+ </p>
+<p>
+ To review, see the built docs in <span class="codefrag">build/forrest-docs</span> directory.
+ </p>
+<a name="N100B3"></a><a name="deploy"></a>
+<h3 class="underlined_5">The "deploy" workstage</h3>
+<p>
+ When satisfied, then deploy the built docs:
+ </p>
+<pre class="code">forrest -f publish.xml deploy -Ddeploy.svn.commit-message="my commit message"</pre>
+<p>
+ If no commit message is supplied, then forrestbot will use a default.
+ </p>
+<p>
+ Now don't get frightened. It might seem like nothing is happening.
+ The first time that the "deploy" worskstage is used it will need to
+ do an 'svn checkout' of the site repository. This will take some time.
+ On subsequent deploys, it will need to do an 'svn update'. So be patient.
+ </p>
+<p>
+ The files that are being committed will now be listed. That is it.
+ They are now in the "<a href="http://svn.apache.org/repos/asf/forrest/site">forrest/site</a>" SVN repository.
+ </p>
+<a name="N100CE"></a><a name="production"></a>
+<h3 class="underlined_5">Moving the documents into production</h3>
+<p>
+ Next a cron job on the server will automatically publish it.
+ However, if quicker turnaround is required, then do this:
+ </p>
+<pre class="code">ssh people.apache.org
+cd /www/forrest.apache.org
+umask 002
+svn update</pre>
+<p>
+ Next an rsync cronjob will publish it to the production webserver.
+ See other <a href="http://apache.org/dev/project-site.html">notes</a>
+ about how the ASF project websites are managed.
+ </p>
+</div>
+<a name="N100E3"></a><a name="Further Reading"></a>
+<h2 class="underlined_10">Further Reading</h2>
+<div class="section">
+<ul>
+
+<li>
+<a href="howto-forrestbot-scp.html">How to deploy documentation with the Forrestbot "scp" workstage</a>
+</li>
+
+<li>
+<a href="tools/forrestbot.html">Forrestbot - automated building and deploying</a>
+</li>
+
+</ul>
+</div>
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2008 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/howto-forrestbot-svn.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/howto-forrestbot-svn.pdf
URL: http://svn.apache.org/viewvc/forrest/site/howto-forrestbot-svn.pdf?rev=694909&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/howto-forrestbot-svn.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Modified: forrest/site/howto-howto.html
URL: http://svn.apache.org/viewvc/forrest/site/howto-howto.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/howto-howto.html (original)
+++ forrest/site/howto-howto.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menupage">
<div class="menupagetitle">Write a How-to</div>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/howto-howto.pdf
URL: http://svn.apache.org/viewvc/forrest/site/howto-howto.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/issues.html
URL: http://svn.apache.org/viewvc/forrest/site/issues.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/issues.html (original)
+++ forrest/site/issues.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/issues.pdf
URL: http://svn.apache.org/viewvc/forrest/site/issues.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/license.pdf
URL: http://svn.apache.org/viewvc/forrest/site/license.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/linkmap.html
URL: http://svn.apache.org/viewvc/forrest/site/linkmap.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/linkmap.html (original)
+++ forrest/site/linkmap.html Sat Sep 13 02:45:20 2008
@@ -410,6 +410,16 @@
<ul>
<li>
+<a href="howto-forrestbot-svn.html">Forrestbot svn</a> ___________________ <em>forrestbot-svn</em> : Publish documentation with Forrestbot svn workstage</li>
+</ul>
+
+<ul>
+<li>
+<a href="howto-forrestbot-scp.html">Forrestbot scp</a> ___________________ <em>forrestbot-scp</em> : Publish documentation with Forrestbot scp workstage</li>
+</ul>
+
+<ul>
+<li>
<a href="subversion_bestpractices.html">Subversion</a> ___________________ <em>svnBP</em> : Best practice notes for Subversion</li>
</ul>
Modified: forrest/site/linkmap.pdf
URL: http://svn.apache.org/viewvc/forrest/site/linkmap.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/live-sites.pdf
URL: http://svn.apache.org/viewvc/forrest/site/live-sites.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/mail-lists.pdf
URL: http://svn.apache.org/viewvc/forrest/site/mail-lists.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/mirrors.pdf
URL: http://svn.apache.org/viewvc/forrest/site/mirrors.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/plan/index.html
URL: http://svn.apache.org/viewvc/forrest/site/plan/index.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/plan/index.html (original)
+++ forrest/site/plan/index.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="../howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="../howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="../howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="../subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', '../skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', '../skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="../zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/plan/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/plan/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/plan/internal-xhtml.html
URL: http://svn.apache.org/viewvc/forrest/site/plan/internal-xhtml.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/plan/internal-xhtml.html (original)
+++ forrest/site/plan/internal-xhtml.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="../howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="../howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="../howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="../subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', '../skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', '../skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="../zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/plan/internal-xhtml.pdf
URL: http://svn.apache.org/viewvc/forrest/site/plan/internal-xhtml.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_70/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_70/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_70/usingPlugins.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_70/usingPlugins.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_80/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_90/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_90/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_90/pluginInfrastructure.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_90/pluginInfrastructure.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_90/usingPlugins.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_90/usingPlugins.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/procedures/How_to_publish_docs.html
URL: http://svn.apache.org/viewvc/forrest/site/procedures/How_to_publish_docs.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/procedures/How_to_publish_docs.html (original)
+++ forrest/site/procedures/How_to_publish_docs.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="../howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="../howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="../howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="../subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_selected_1.3.5', '../skin/')" id="menu_selected_1.3.5Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Committer notes</div>
-<div id="menu_selected_1.3.5" class="selectedmenuitemgroup" style="display: block;">
+<div onclick="SwitchMenu('menu_selected_1.3.7', '../skin/')" id="menu_selected_1.3.7Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Committer notes</div>
+<div id="menu_selected_1.3.7" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="../zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
@@ -301,14 +307,18 @@
<p>
This builds the documentation locally then deploys it by committing it
to the
- <a href="https://svn.apache.org/repos/asf/forrest/site">forrest/site
+ <a href="http://svn.apache.org/repos/asf/forrest/site">forrest/site
SVN</a>. Then a cronjob on the server will automatically publish it.
- However, if instant turnaround is required, then do this:
+ However, if quicker turnaround is required, then do this:
</p>
<pre class="code">ssh people.apache.org
cd /www/forrest.apache.org
svn update</pre>
<p>
+ See more detailed <a href="../howto-forrestbot-svn.html">explanation</a> of this
+ procedure.
+ </p>
+<p>
Publishing documentation for a particular plugin is done by:
</p>
<pre class="code">cd plugins/myPluginName
@@ -324,7 +334,7 @@
</p>
</div>
-<a name="N1005B"></a><a name="OrgDoc"></a>
+<a name="N10062"></a><a name="OrgDoc"></a>
<h2 class="underlined_10">original docs</h2>
<div class="section">
<p>
Modified: forrest/site/procedures/How_to_publish_docs.pdf
URL: http://svn.apache.org/viewvc/forrest/site/procedures/How_to_publish_docs.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
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?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/procedures/release/How_to_release.html (original)
+++ forrest/site/procedures/release/How_to_release.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="../../howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="../../howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="../../howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="../../subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="../../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_selected_1.3.5', '../../skin/')" id="menu_selected_1.3.5Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Committer notes</div>
-<div id="menu_selected_1.3.5" class="selectedmenuitemgroup" style="display: block;">
+<div onclick="SwitchMenu('menu_selected_1.3.7', '../../skin/')" id="menu_selected_1.3.7Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Committer notes</div>
+<div id="menu_selected_1.3.7" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="../../zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/procedures/release/How_to_release.pdf
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/How_to_release.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/proposal-asf-forrestbot.html
URL: http://svn.apache.org/viewvc/forrest/site/proposal-asf-forrestbot.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/proposal-asf-forrestbot.html (original)
+++ forrest/site/proposal-asf-forrestbot.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/proposal-asf-forrestbot.pdf
URL: http://svn.apache.org/viewvc/forrest/site/proposal-asf-forrestbot.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/roles.html
URL: http://svn.apache.org/viewvc/forrest/site/roles.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/roles.html (original)
+++ forrest/site/roles.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/roles.pdf
URL: http://svn.apache.org/viewvc/forrest/site/roles.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/subversion_bestpractices.html
URL: http://svn.apache.org/viewvc/forrest/site/subversion_bestpractices.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/subversion_bestpractices.html (original)
+++ forrest/site/subversion_bestpractices.html Sat Sep 13 02:45:20 2008
@@ -176,6 +176,12 @@
<div class="menuitem">
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
+<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
<div class="menupage">
<div class="menupagetitle">Subversion</div>
</div>
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/subversion_bestpractices.pdf
URL: http://svn.apache.org/viewvc/forrest/site/subversion_bestpractices.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/svn.html
URL: http://svn.apache.org/viewvc/forrest/site/svn.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/svn.html (original)
+++ forrest/site/svn.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/svn.pdf
URL: http://svn.apache.org/viewvc/forrest/site/svn.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/thanks.pdf
URL: http://svn.apache.org/viewvc/forrest/site/thanks.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/todo.html
URL: http://svn.apache.org/viewvc/forrest/site/todo.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/todo.html (original)
+++ forrest/site/todo.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_1.3.5', 'skin/')" id="menu_1.3.5Title" class="menutitle">Committer notes</div>
-<div id="menu_1.3.5" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
+<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
Modified: forrest/site/todo.pdf
URL: http://svn.apache.org/viewvc/forrest/site/todo.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/eclipse.pdf
URL: http://svn.apache.org/viewvc/forrest/site/tools/eclipse.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/forrestbar.pdf
URL: http://svn.apache.org/viewvc/forrest/site/tools/forrestbar.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/forrestbot-web-interface.pdf
URL: http://svn.apache.org/viewvc/forrest/site/tools/forrestbot-web-interface.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/forrestbot.html
URL: http://svn.apache.org/viewvc/forrest/site/tools/forrestbot.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/tools/forrestbot.html (original)
+++ forrest/site/tools/forrestbot.html Sat Sep 13 02:45:20 2008
@@ -231,6 +231,9 @@
<li>
<a href="#Forrestbot+Design">Forrestbot Design</a>
</li>
+<li>
+<a href="#refs">Further Reading</a>
+</li>
</ul>
</div>
</div>
@@ -1137,6 +1140,22 @@
<span class="codefrag"><import></span> task (see the example above).
</p>
</div>
+
+<a name="N106B6"></a><a name="refs"></a>
+<h2 class="underlined_10">Further Reading</h2>
+<div class="section">
+<ul>
+
+<li>
+<a href="../howto-forrestbot-svn.html">How to deploy documentation with the Forrestbot "svn" workstage</a>
+</li>
+
+<li>
+<a href="../howto-forrestbot-scp.html">How to deploy documentation with the Forrestbot "scp" workstage</a>
+</li>
+
+</ul>
+</div>
</div>
<!--+
Modified: forrest/site/tools/forrestbot.pdf
URL: http://svn.apache.org/viewvc/forrest/site/tools/forrestbot.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/tools/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/xxe.pdf
URL: http://svn.apache.org/viewvc/forrest/site/tools/xxe.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/versions/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/versions/index.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/who.pdf
URL: http://svn.apache.org/viewvc/forrest/site/who.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/zone.html
URL: http://svn.apache.org/viewvc/forrest/site/zone.html?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
--- forrest/site/zone.html (original)
+++ forrest/site/zone.html Sat Sep 13 02:45:20 2008
@@ -177,6 +177,12 @@
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
+<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
+</div>
+<div class="menuitem">
+<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
+</div>
+<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
@@ -185,8 +191,8 @@
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
-<div onclick="SwitchMenu('menu_selected_1.3.5', 'skin/')" id="menu_selected_1.3.5Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Committer notes</div>
-<div id="menu_selected_1.3.5" class="selectedmenuitemgroup" style="display: block;">
+<div onclick="SwitchMenu('menu_selected_1.3.7', 'skin/')" id="menu_selected_1.3.7Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Committer notes</div>
+<div id="menu_selected_1.3.7" class="selectedmenuitemgroup" style="display: block;">
<div class="menupage">
<div class="menupagetitle">Zone management</div>
</div>
Modified: forrest/site/zone.pdf
URL: http://svn.apache.org/viewvc/forrest/site/zone.pdf?rev=694909&r1=694908&r2=694909&view=diff
==============================================================================
Binary files - no diff available.