crossley 2003/09/20 00:08:05 Modified: targets/forrest faq.html faq.pdf Log: Add FAQ about Java maxmemory. Revision Changes Path 1.27 +47 -27 xml-site/targets/forrest/faq.html Index: faq.html =================================================================== RCS file: /home/cvs/xml-site/targets/forrest/faq.html,v retrieving revision 1.26 retrieving revision 1.27 diff -u -r1.26 -r1.27 --- faq.html 19 Sep 2003 07:45:04 -0000 1.26 +++ faq.html 20 Sep 2003 07:08:05 -0000 1.27 @@ -25,15 +25,15 @@ <!--================= 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 action="search.cmd" method="get"> +<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 size="15" name="query" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif" class="spacer"><input name="Search" value="Search" type="submit"> +<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">Powered by Apache Lucene</font></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif" class="spacer"></td> +<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> @@ -228,6 +228,7 @@ <li> <a href="wiki-sample.html">Wiki Reference</a> </li> + </ul> </li> @@ -344,6 +345,11 @@ <span class="codefrag">cygpath.exe: *** can't create title mutex, Win32 error 6</span>. </a> </li> +<li> +<a name="maxmemory-menu"></a><a href="#maxmemory"> + How can i specify the amount of memory to be used by Java? + </a> +</li> </ul> <br> </li> @@ -452,13 +458,13 @@ </li> </ol> </div> -<a name="N100A4"></a><a name="Answers"></a> +<a name="N100A9"></a><a name="Answers"></a> <h3>Answers</h3> <div style="margin-left: 0 ; border: 2px"> -<a name="N100A8"></a><a name="getting_started"></a> +<a name="N100AD"></a><a name="getting_started"></a> <h4>1. Building Forrest</h4> <div style="margin-left: 0 ; border: 2px"> -<a name="N100AC"></a><a name="checked_out_now_what"></a> +<a name="N100B1"></a><a name="checked_out_now_what"></a> <h5>1.1. I have checked out a working copy of xml-forrest CVS, now what? <span style="float: right"><a href="#checked_out_now_what-menu">^</a></span> @@ -477,7 +483,7 @@ further step-by-step assistance in getting started with Forrest for your project. </p> </div> -<a name="N100CA"></a><a name="cygwin_mutex_error"></a> +<a name="N100CF"></a><a name="cygwin_mutex_error"></a> <h5>1.2. When running ./build.sh in cygwin, I get an error: cygpath.exe: *** can't create title mutex, Win32 error 6. @@ -489,11 +495,25 @@ to be a bug in cygwin</a>. Please use the .bat script instead. </p> </div> +<a name="N100E1"></a><a name="maxmemory"></a> +<h5>1.3. + How can i specify the amount of memory to be used by Java? + <span style="float: right"><a href="#maxmemory-menu">^</a></span> +</h5> +<div style="margin-left: 15 ; border: 2px"> +<p> + Set the <span class="codefrag">maxmemory</span> property in the + <span class="codefrag">forrest.properties</span> file. Like many other properties + you can copy them from the default configuration at + <span class="codefrag">src/resources/fresh-site/forrest.properties</span> + +</p> +</div> </div> -<a name="N100DC"></a><a name="technical"></a> +<a name="N100F2"></a><a name="technical"></a> <h4>2. Technical</h4> <div style="margin-left: 0 ; border: 2px"> -<a name="N100E0"></a><a name="PDF-output"></a> +<a name="N100F6"></a><a name="PDF-output"></a> <h5>2.1. How can I get at it to generate one pdf-file out of the whole site or selected pages of the site ?<span style="float: right"><a href="#PDF-output-menu">^</a></span> </h5> @@ -509,7 +529,7 @@ "Full PDF" and "Full HTML". </p> </div> -<a name="N100E8"></a><a name="clickable-email-adress"></a> +<a name="N100FE"></a><a name="clickable-email-adress"></a> <h5>2.2. How can I get at it that generated html-pages show a 'clickable' email-adress (of the author-element)<span style="float: right"><a href="#clickable-email-adress-menu">^</a></span> </h5> @@ -519,7 +539,7 @@ and edit the "headers/authors" template. </p> </div> -<a name="N100F3"></a><a name="CVS_revison_tags"></a> +<a name="N10109"></a><a name="CVS_revison_tags"></a> <h5>2.3. How can I get at it that generated html-pages show the revision tag of cvs ? <span style="float: right"><a href="#CVS_revison_tags-menu">^</a></span> </h5> @@ -531,7 +551,7 @@ http://xml.apache.org/forrest/your-project.html</a> </p> </div> -<a name="N10101"></a><a name="ignoring_javadocs"></a> +<a name="N10117"></a><a name="ignoring_javadocs"></a> <h5>2.4. How do I stop Forrest breaking on links to external files that may not exist, like javadocs? @@ -571,7 +591,7 @@ </div> </div> </div> -<a name="N10132"></a><a name="link_raw"></a> +<a name="N10148"></a><a name="link_raw"></a> <h5>2.5. How do I link to raw files such as config.txt and brochure.pdf? <span style="float: right"><a href="#link_raw-menu">^</a></span> </h5> @@ -584,7 +604,7 @@ project for a demonstration of this ability. </p> </div> -<a name="N1013D"></a><a name="build_msg_a"></a> +<a name="N10153"></a><a name="build_msg_a"></a> <h5>2.6. What do the numbers in square brackets mean when Forrest lists each document that it has built? <span style="float: right"><a href="#build_msg_a-menu">^</a></span> @@ -602,7 +622,7 @@ This is the number of links that were gathered from that page. </p> </div> -<a name="N1014A"></a><a name="pdf_images"></a> +<a name="N10160"></a><a name="pdf_images"></a> <h5>2.7. Images don't display in PDFs. How do I fix this?<span style="float: right"><a href="#pdf_images-menu">^</a></span> </h5> <div style="margin-left: 15 ; border: 2px"> @@ -642,7 +662,7 @@ Forrest</div> </div> </div> -<a name="N1017C"></a><a name="index.html"></a> +<a name="N10192"></a><a name="index.html"></a> <h5>2.8. The tab link in my site incorrectly assumes that 'index.html' is present in the linked-to directory. How do I fix this? @@ -667,7 +687,7 @@ </map:match> </pre> </div> -<a name="N1019A"></a><a name="headless_operation"></a> +<a name="N101B0"></a><a name="headless_operation"></a> <h5>2.9. When generating PNG images from SVG, I get an error: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable. <span style="float: right"><a href="#headless_operation-menu">^</a></span> @@ -680,7 +700,7 @@ </p> <pre class="code">forrest -Dforrest.jvmargs=-Djava.awt.headless=true site</pre> </div> -<a name="N101B0"></a><a name="xsp"></a> +<a name="N101C6"></a><a name="xsp"></a> <h5>2.10. How do I enable XSP processing?<span style="float: right"><a href="#xsp-menu">^</a></span> </h5> <div style="margin-left: 15 ; border: 2px"> @@ -724,10 +744,10 @@ <p>See also the <a href="http://wiki.cocoondev.org/Wiki.jsp?page=AddingXSPToForrest">AddingXSPToForrest</a> Wiki page.</p> </div> </div> -<a name="N101E7"></a><a name="old_faqs"></a> +<a name="N101FD"></a><a name="old_faqs"></a> <h4>3. Older versions</h4> <div style="margin-left: 0 ; border: 2px"> -<a name="N101EB"></a><a name="unresolved_project.home"></a> +<a name="N10201"></a><a name="unresolved_project.home"></a> <h5>3.1. When invoking Forrest 0.4 from the forrest.antproxy.xml, the build fails because ${project.home} isn't resolved. @@ -747,7 +767,7 @@ <classpath refid="forrest-classpath"/> <jvmarg value="-Dforrest.home=${forrest.home}"/></pre> </div> -<a name="N10201"></a><a name="odd_html"></a> +<a name="N10217"></a><a name="odd_html"></a> <h5>3.2. After upgrading to 0.4 my HTML looks significantly different, and table widths are wrong. What happened? @@ -767,7 +787,7 @@ <doctype-system>http://www.w3.org/TR/html4/loose.dtd</doctype-system> </pre> </div> -<a name="N10214"></a><a name="validation_error-doctype_root_null"></a> +<a name="N1022A"></a><a name="validation_error-doctype_root_null"></a> <h5>3.3. When building my project, I get an validation error: Document root element "site", must match DOCTYPE root "null".. @@ -788,7 +808,7 @@ listed to prevent an attempt at DTD-based validation. </p> </div> -<a name="N10231"></a><a name="building_error-custom_sitemap"></a> +<a name="N10247"></a><a name="building_error-custom_sitemap"></a> <h5>3.4. When building my project, I get any of these errors: menu.xmap (The system cannot find the file specified) @@ -803,10 +823,10 @@ </p> </div> </div> -<a name="N10246"></a><a name="general"></a> +<a name="N1025C"></a><a name="general"></a> <h4>4. General</h4> <div style="margin-left: 0 ; border: 2px"> -<a name="N1024A"></a><a name="generating_menus"></a> +<a name="N10260"></a><a name="generating_menus"></a> <h5>4.1. What is the relation between site.xml and book.xml? <span style="float: right"><a href="#generating_menus-menu">^</a></span> @@ -822,7 +842,7 @@ <span class="codefrag">site.xml</span>-generated menus aren't appropriate. </p> </div> -<a name="N10261"></a><a name="docbook"></a> +<a name="N10277"></a><a name="docbook"></a> <h5>4.2. How do I use DocBook as the xml documentation format? <span style="float: right"><a href="#docbook-menu">^</a></span> @@ -867,7 +887,7 @@ for configuration guidance. </p> </div> -<a name="N1027F"></a><a name="how_can_I_help"></a> +<a name="N10295"></a><a name="how_can_I_help"></a> <h5>4.3. How can I help? <span style="float: right"><a href="#how_can_I_help-menu">^</a></span> 1.22 +674 -520 xml-site/targets/forrest/faq.pdf <<Binary file>>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
