crossley 2004/01/07 15:51:41 Added: targets/forrest build.html build.pdf Log: Add missing files. Revision Changes Path 1.1 xml-site/targets/forrest/build.html Index: build.html =================================================================== <!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"> <title>Building Forrest</title> <link type="text/css" href="skin/page.css" rel="stylesheet"> </head> <body text="#000000" bgcolor="#FFFFFF"> <!--================= start Navigation Path ==================--> <table summary="navigation path" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img height="1" width="5" alt="" src="skin/images/spacer.gif" class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial, Helvetica, Sans-serif"><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></font></td> </tr> <tr> <td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> </table> <!--================= end Navigation Path ==================--> <!--================= start Banner ==================--> <table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <!--================= start Group Logo ==================--> <td bgcolor="#294563"><a href="http://xml.apache.org/";><img border="0" class="logoImage" alt="Apache XML" src="images/group-logo.gif"></a></td> <!--================= end Group Logo ==================--> <!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#294563"><a href="http://xml.apache.org/forrest/";><img border="0" class="logoImage" alt="Forrest" src="images/project-logo.gif"></a></td> <!--================= end Project Logo ==================--> <!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#294563"> <form target="_blank" action="http://www.google.com/search"; method="get"> <table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F"> <tr> <td colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="xml.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> <br> <font face="Arial, Helvetica, Sans-serif" size="2" color="white"> the Apache XML site </font></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td><img alt="" border="0" height="10" width="9" src="skin/images/search-left.gif"></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0" height="10" width="9" src="skin/images/search-right.gif"></td> </tr> </table> </form> </td> <!--================= start Search ==================--><td bgcolor="#294563"><img height="10" width="10" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" bgcolor="#294563" colspan="2"> <!--================= start Tabs ==================--> <div class="tab"> <table summary="tab bar" border="0" cellpadding="0" cellspacing="0"> <tr> <td width="6"><img alt="" height="8" width="6" src="skin/images/spacer.gif"></td><td valign="bottom"> <table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0" cellspacing="0"> <tr> <td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b><a class="base-selected" href="index.html">Home</a></b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="skin/images/tabSel-right.gif"></td> </tr> </table> </td><td width="6"><img alt="" height="8" width="6" src="skin/images/spacer.gif"></td><td valign="bottom"> <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0"> <tr> <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a class="base-not-selected" href="community/index.html">Community</a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td> </tr> <tr> <td colspan="3" height="1"></td> </tr> </table> </td><td width="6"><img alt="" height="8" width="6" src="skin/images/spacer.gif"></td><td valign="bottom"> <table summary="non selected tab" style="height: 1.6em" border="0" cellpadding="0" cellspacing="0"> <tr> <td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a class="base-not-selected" href="community/howto/index.html">How-to</a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="skin/images/tab-right.gif"></td> </tr> <tr> <td colspan="3" height="1"></td> </tr> </table> </td> </tr> </table> </div> <!--================= end Tabs ==================--> </td><td bgcolor="#294563"><img alt="" width="1" height="1" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> </table> <!--================= end Banner ==================--> <!--================= start Menu, NavBar, Content ==================--> <table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> <td valign="top"> <table summary="menu" border="0" cellspacing="0" cellpadding="0"> <tr> <!--================= start left top NavBar ==================--> <td rowspan="3" valign="top"> <table summary="blue line" border="0" cellpadding="0" cellspacing="0"> <tr> <td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica, Sans-serif"> </font></td> </tr> <tr> <td bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> </table> </td> <!--================= end left top NavBar ==================--><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F"> <!--================= start Menu items ==================--> <div class="menu"> <ul> <li> <font color="#CFDCED">About</font> <ul> <li> <a href="index.html">Index</a> </li> <li> <a href="license.html">License</a> </li> <li> <a href="http://www.apache.org/dyn/closer.cgi/xml/forrest/";>Download</a> </li> <li> <a href="who.html">Who we are</a> </li> <li> <a href="faq.html">FAQs</a> </li> <li> <a href="changes.html">Changes</a> </li> <li> <a href="todo.html">Todo</a> </li> <li> <a href="live-sites.html">Example sites</a> </li> </ul> </li> <li> <font color="#CFDCED">Documentation</font> <ul> <li> <a href="your-project.html">Using Forrest</a> </li> <li> <a href="validation.html">XML Validation</a> </li> <li> <a href="linking.html">Menus and Linking</a> </li> <li> <a href="sitemap-ref.html">Sitemap Reference</a> </li> <li> <a href="skin-package.html">Skin Packages</a> </li> <li> <a href="forrest-contract.html">Our Contract</a> </li> <li> <a href="compliance.html">Standards Compliance</a> </li> <li> <a href="dtd-docs.html">DTD documentation</a> </li> <li> <a href="cap.html">Sourcetype Action</a> </li> <li> <a href="forrestbar.html">The ForrestBar</a> </li> <li> <a href="forrestbot.html">Forrestbot (CVS)</a> </li> <li> <a href="forrestbot-old.html">Forrestbot (stable)</a> </li> <li> <a href="upgrading_05.html">Upgrading to 0.5</a> </li> </ul> </li> <li> <font color="#CFDCED">Older Docs</font> <ul> <li> <a href="primer.html">Forrest Primer</a> </li> <li> <a href="libre-intro.html">Libre</a> </li> <li> <a href="dreams.html">Dream list</a> </li> </ul> </li> <li> <font color="#CFDCED">Some Samples</font> <ul> <li> <a href="document-v12.html">document-v12</a> </li> <li> <a href="wiki-sample.html">Wiki Reference</a> </li> </ul> </li> <li> <font color="#CFDCED">Getting Involved</font> <ul> <li> <a href="contrib.html">Contributing</a> </li> <li> <span class="sel"><font color="#ffcc00">Building Forrest</font></span> </li> <li> <a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a> </li> <li> <a href="mail-lists.html">Mail lists</a> </li> <li> <a href="mail-archives.html">Mail Archives</a> </li> <li> <a href="http://issues.cocoondev.org/jira/secure/BrowseProject.jspa?id=10000";>Bugs and Issues</a> </li> <li> <a href="forrest-issues.html">Open Issues</a> </li> </ul> </li> <li> <font color="#CFDCED">Related projects</font> <ul> <li> <a href="http://jakarta.apache.org/gump/";>Apache Gump</a> </li> <li> <a href="http://cocoon.apache.org/";>Apache Cocoon</a> </li> <li> <a href="http://cocoon.apache.org/lenya/";>Apache Lenya</a> </li> <li> <a href="http://www.krysalis.org/";>Krysalis Centipede</a> </li> </ul> </li> </ul> </div> <!--================= end Menu items ==================--> </td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td valign="bottom" align="left" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10" width="10" alt="" src="skin/images/spacer.gif" class="spacer"></td><td valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt="" src="skin/images/menu-right.gif"></td> </tr> <tr> <td height="1" bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> </table> </td><td valign="top" width="100%"> <table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0"> <!--================= start middle NavBar ==================--> <tr> <td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td align="left" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif"> </font><img width="10" height="8" alt="" src="skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif"> </font><img width="10" height="8" alt="" src="skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <tr> <td colspan="4" bgcolor="#294563"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <!--================= end middle NavBar ==================--> <!--================= start Content==================--> <tr> <td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td><td colspan="2" align="left" width="100%"> <div class="content"> <table class="title" summary=""> <tr> <td valign="middle"> <h1>Building Forrest</h1> </td><td nowrap="nowrap" width="40" align="center"><a class="dida" href="build.pdf"><img alt="PDF" src="skin/images/pdfdoc.gif" class="skin"><br> PDF</a></td> </tr> </table> <ul class="minitoc"> <li> <a href="#getting_from_source">Getting the Forrest source</a> <ul class="minitoc"> <li> <a href="#Step-by-step+cvs+instructions+for+Windows">Step-by-step cvs instructions for Windows</a> </li> <li> <a href="#Step-by-step+cvs+instructions+for+Unix">Step-by-step cvs instructions for Unix</a> </li> </ul> </li> <li> <a href="#building">Building and Installing Forrest</a> </li> </ul> <a name="N10013"></a><a name="getting_from_source"></a> <h3>Getting the Forrest source</h3> <div style="margin-left: 0 ; border: 2px"> <a name="N10019"></a><a name="Step-by-step+cvs+instructions+for+Windows"></a> <h4>Step-by-step cvs instructions for Windows</h4> <div style="margin-left: 0 ; border: 2px"> <ol> <li>Download a recent release of WinCVS (homepage is <a href="http://www.wincvs.org/";>http://www.wincvs.org/</a>); </li> <li>Install it;</li> <li>Start it;</li> <li>Click on Admin->Preferences;</li> <li> In "Enter the CVSROOT:" enter "<span class="codefrag">:pserver:[EMAIL PROTECTED]:/home/cvspublic</span>" (without quotes);</li> <li>In "Authentication:" choose "passwd file on the cvs server";</li> <li>Click "Ok";</li> <li>Click Admin->Login;</li> <li> When asked for the password: answer "<span class="codefrag">anoncvs</span>" (without quotes);</li> <li> Click "Create->Checkout module";</li> <li>Module name and path on the server is "<span class="codefrag">xml-forrest</span>" (no quotes);</li> <li>Choose a dir to put the source code in;</li> <li>Click "Ok";</li> <li>If everything goes well, messages will start to appear in the log window;</li> <li>Wait until you see "<span class="codefrag">*****CVS exited normally with code 0*****</span>" in the log window;</li> <li>The Forrest source is now on your harddrive.</li> </ol> </div> <a name="N10063"></a><a name="Step-by-step+cvs+instructions+for+Unix"></a> <h4>Step-by-step cvs instructions for Unix</h4> <div style="margin-left: 0 ; border: 2px"> <ol> <li>Make sure you have a CVS client package installed on your Unix system.</li> <li>Start the shell of your choice.</li> <li>Enter "<span class="codefrag">cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login</span>".</li> <li>When asked for the password: answer "<span class="codefrag">anoncvs</span>".</li> <li>Enter "<span class="codefrag">cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic -z3 checkout xml-forrest</span>". This will create a directory called "<span class="codefrag">xml-forrest</span>" where the Forrest source will be stored.</li> <li>Wait until cvs has finished.</li> <li>The Forrest source is now on your harddrive.</li> </ol> <p>In case you want to update your Forrest source tree to the current version, change to the "<span class="codefrag">xml-forrest</span>" directory and invoke "<span class="codefrag">cvs -z3 update -d -P</span>".</p> </div> </div> <a name="N10098"></a><a name="building"></a> <h3>Building and Installing Forrest</h3> <div style="margin-left: 0 ; border: 2px"> <p> To build Forrest, type <span class="codefrag">build</span> on Windows, or <span class="codefrag">./build.sh</span> on Unix. If everything is successful, you should see a message like this: </p> <pre class="code"> *----------------------------------------------------------------- | installation notice *----------------------------------------------------------------- | You have succesfully built the shell-bat distribution of Forrest. | Please find it at: ./build/dist/shbat | Please copy the contents to the install directory of your choice | Please have the environment variable FORREST_HOME point to it. | It is recommended to add | unix: $FORREST_HOME/bin: to your $PATH | win: %FORREST_HOME%\bin; to your %PATH% | Calling | unix: $FORREST_HOME/bin/forrest -projecthelp | win: %FORREST_HOME%\bin\forrest -projecthelp | will list options for the 'forrest' command | More help at http://xml.apache.org/forrest/ and [EMAIL PROTECTED] *----------------------------------------------------------------- </pre> <p> You now have the binary distribution built in <span class="codefrag">build/dist/shbat</span>. Copy it somewhere more sensible if you like (e.g. <span class="codefrag">/usr/local/forrest</span> on Unix), though if you intend to update your Forrest from CVS, leaving it where it is would be best.</p> <p> As the message says, you need to add the distribution's <span class="codefrag">bin/</span> ("binary") directory to your PATH variable, so the <span class="codefrag">'forrest'</span> command is available everywhere: </p> <pre class="code"> ~/apache/xml-forrest$ export FORREST_HOME=`pwd`/build/dist/shbat ~/apache/xml-forrest$ export PATH=$PATH:$FORREST_HOME/bin </pre> <p> After updating the Forrest source from CVS, or after you have made changes, you will need to build forrest again. In Windows, run <span class="codefrag">build clean</span> then <span class="codefrag">build</span>. In Unix, run <span class="codefrag">./build.sh clean</span> then <span class="codefrag">./build.sh</span> </p> </div> <div class="attribution">by Dave Brondsema</div> </div> </td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> </tr> <!--================= end Content==================--> </table> </td> </tr> </table> <!--================= end Menu, NavBar, Content ==================--> <!--================= start Footer ==================--> <table summary="footer" cellspacing="0" cellpadding="0" width="100%" border="0"> <tr> <td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td> </tr> <tr> <td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font size="2" face="Arial, Helvetica, Sans-Serif">Copyright © 2002-2003 The Apache Software Foundation. All rights reserved.<script type="text/javascript" language="JavaScript"><!-- document.write(" - "+"Last Published: " + document.lastModified); // --></script></font></td> </tr> <tr> <td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td> </tr> </table> <!--================= end Footer ==================--> </body> </html> 1.1 xml-site/targets/forrest/build.pdf <<Binary file>>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
