To publish from trunk/site-author/

Do once:
# create $FORREST_HOME/deploy.svn.settings which looks like:
<?xml version="1.0"?>
<project>
  <property name="deploy.svn.user" value="myApacheUsername"/>
  <property name="deploy.svn.user" value="myPassword"/>
</project>


# Make changes to sources, and then test, then commit.
# Use the forrestbot to build and then deploy to svn.apache.org ...

# forrest -f publish.xml build
# verify files in build/forrest-[docs|site]
# forrest -f publish.xml deploy -Ddeploy.svn.commit-message="my commit message"

Now the files are in SVN at forrest/site
Periodically the real website files are updated from there.
You do not have to do anything else.

-----------------------

To publish documentation from a non-trunk branch:

# check out the branch (e.g. svn co https://svn.apache.org/repos/asf/forrest/branches/forrest_07_branch)
# make sure $FORREST_HOME is set (it uses this to find deploy.svn.settings)
# Do the steps above within this branch

-----------------------

To publish documentation from the 0.6 branch:

(this is unique because it does not have split docs/site, but currently we still need to publish it)

# cd forrest_06_branch
# forrest -f publish_docs.xml build
# forrest -f publish_docs.xml deploy -Ddeploy.svn.commit-message="my commit message"


To publish from trunk/site-author/

Do once:
# create $FORREST_HOME/deploy.svn.settings which looks like:
<?xml version="1.0"?>
<project>
  <property name="deploy.svn.user" value="myApacheUsername"/>
  <property name="deploy.svn.user" value="myPassword"/>
</project>


# Make changes to sources, and then test, then commit.
# Use the forrestbot to build and then deploy to svn.apache.org ...

# forrest -f publish.xml build
# verify files in build/forrest-docs
# forrest -f publish.xml deploy -Ddeploy.svn.commit-message="my commit message"

Now the files are in SVN at forrest/site
Periodically the real website files are updated from there.
You do not have to do anything else.

Tidy the instructions to use forrestbot to deploy our website docs. No need to mess with documentation in the branches anymore.
Tidy the instructions to use forrestbot to deploy our website docs.
No need to mess with documentation in the branches anymore.


git-svn-id: 36dcc065b18e9ace584b1c777eaeefb1d96b1ee8@209816 13f79535-47bb-0310-9956-ffa450edef68
