3.12. How do breadcrumbs work? Why don't they work locally?
^
@@ -1191,7 +1208,7 @@
are viewing the site locally, there is no domain and so there will be no extra
breadcrumbs, only the ones that are specified in skinconf.xml.
-
+
3.13. How do I make forrest run listen on a different port?
Doing 'forrest -v' will provide verbose build messages to the standard
output.
-
+
5.5. How to help?
^
@@ -1330,7 +1347,7 @@
particularly from newcomers—often, close proximity blinds software developers to
faults that are obvious to everyone else. Don't be shy!
There is a more detailed discussion of this topic in the samples
+ of a freshly seeded site. To see this documentation do the following:
+
+
mkdir seed
+
cd seed
+
forrest seed
+
forrest
+
Read the doc
+ 3. Technical3.1. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
do?
You can configure the proxy in the forrest.properties file. Set the
Modified: forrest/site/docs_0_80/faq.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.html?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
--- forrest/site/docs_0_80/faq.html (original)
+++ forrest/site/docs_0_80/faq.html Fri Sep 16 08:03:53 2005
@@ -986,8 +986,25 @@
</map:select>
</map:match>
+
There is a more detailed discussion of this topic in the samples
+ of a freshly seeded site. To see this documentation do the following:
3.12. How do breadcrumbs work? Why don't they work locally?
^
@@ -1257,7 +1274,7 @@
are viewing the site locally, there is no domain and so there will be no extra
breadcrumbs, only the ones that are specified in skinconf.xml.
-
+
3.13. How do I make forrest run listen on a different port?
3.14. Can I run Forrest with Java debugging turned on?
^
@@ -1285,9 +1302,9 @@
to the forrest.jvmargs property in the forrest.properties
file. Don't forget to ensure the property is uncommented in that file.
-
+
4. Older version: 0.6
-
+
4.1. Some of my files are not being processed because they use common filenames.
^
@@ -1303,9 +1320,9 @@
with this issue (FOR-217).
-
+
5. General
-
+
5.1. What is the relationship between site.xml and book.xml?
^
@@ -1319,7 +1336,7 @@
site.xml-generated menus aren't appropriate. See Menus and
Linking.
-
+
5.2. How do I use DocBook as the XML documentation format?
^
@@ -1365,7 +1382,7 @@
different DTDs, then see Using Forrest for
configuration guidance.
-
+
5.3. How to report which version of Forrest is being used and the properties that are
set?
@@ -1378,7 +1395,7 @@
watch the build messages. Doing 'forrest -v' will provide verbose build
messages.
-
+
5.4. Where are the log files to find more infomation about errors?
Doing 'forrest -v' will provide verbose build messages to the standard
output.
-
+
5.5. How to help?
^
@@ -1408,7 +1425,7 @@
particularly from newcomers—often, close proximity blinds software developers to
faults that are obvious to everyone else. Don't be shy!
There is a more detailed discussion of this topic in the samples
+ of a freshly seeded site. To see this documentation do the following:
+
+
mkdir seed
+
cd seed
+
forrest seed-sample
+
forrest
+
Read the doc
+ 2.19. How to include additional Javascript and CSS files?
Place various resources (e.g. javascript, css) into the
Modified: forrest/site/docs_0_80/howto/howto-dev.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-dev.html?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-dev.html (original)
+++ forrest/site/docs_0_80/howto/howto-dev.html Fri Sep 16 08:03:53 2005
@@ -694,7 +694,9 @@
Now request the special uri localhost:8888/cprofile.html
to see the results. Start at the "index.html" request,
- then follow the processing.
+ then follow the processing. (If the table is empty, then
+ you either forgot to do some requests before looking for results,
+ or forgot to switch on the profiler in sitemap.)
NOTE: Do not forget to turn off the profiler in
Modified: forrest/site/docs_0_80/howto/howto-dev.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-dev.pdf?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/forrest-issues.html
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-issues.html?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
--- forrest/site/forrest-issues.html (original)
+++ forrest/site/forrest-issues.html Fri Sep 16 08:03:53 2005
@@ -192,6 +192,9 @@
[FOR-591] MaxMemory needs increasing
We need to run a memory profiler while forrest is operating.
+
+
[FOR-427] Need licensing element in plugins.xml
@@ -322,7 +330,7 @@
Since plugins can be hosted on different sites they can be released under licenses other than the Apache one. We need an element in plugins.xml that records the type of license a plugin is released under. This element should be used by the plugin install process to verify that the user agrees to the terms of that license before download and installation is started.<br/>
We need a RelaxNG schema for the subset of XHTML identified in:
<br/>
<a href="http://marc.theaimsgroup.com/?l=forrest-dev&m=112489488330888&w=2">http://marc.theaimsgroup.com/?l=forrest-dev&m=112489488330888&w=2</a>
-
-
-
[FOR-572] run a memory profiler while forrest is operating
We need to run a memory profiler while forrest is operating.
[FOR-490] serve multiple sites on a single Forrest instance
Modified: forrest/site/forrest-issues.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-issues.pdf?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/forrest-tuesday.html
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-tuesday.html?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
--- forrest/site/forrest-tuesday.html (original)
+++ forrest/site/forrest-tuesday.html Fri Sep 16 08:03:53 2005
@@ -217,10 +217,19 @@
and notes about the
topic of the day.
+
+ There is a special meeting on Sunday 18 September 2005 starting at 20:00 UTC
+ to decide how to approach xhtml2/views in the core. See the dev mailing list discussions.
+ The channel name will be announced there.
+ See
+ start time
+ and
+ zone overlap.
+
Output plugins enable Forrest to produce
documents in different formats.
-
+
org.apache.forrest.plugin.output.Chart
@@ -812,7 +840,7 @@
0.7
-
+
org.apache.forrest.plugin.output.htmlArea
@@ -840,7 +868,7 @@
0.7
-
+
org.apache.forrest.plugin.output.voice
@@ -869,13 +897,13 @@
0.8-dev
-
+
Internal Plugins
Internal plugins change the core behaviour
of Forrest.
-
+
org.apache.forrest.plugin.internal.view
Modified: forrest/site/pluginDocs/plugins_0_80/index.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/index.pdf?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/tools/forrestbot.html
URL: http://svn.apache.org/viewcvs/forrest/site/tools/forrestbot.html?rev=289574&r1=289573&r2=289574&view=diff
==============================================================================
--- forrest/site/tools/forrestbot.html (original)
+++ forrest/site/tools/forrestbot.html Fri Sep 16 08:03:53 2005
@@ -232,19 +232,15 @@
whole process gets the source docs, builds it, then deploys the site
where you want it to go. It can also notify you afterwards, and it
keeps a log of the build process. To accomplish these tasks Forrestbot
- uses four "workstages" (getsrc, build, deploy, notify) that are
- comprised of "implementations" and
+ uses four "workstages" (getsrc, build, deploy, notify). Each workstage
+ has various "implementations" (e.g. getsrc has getsrc.cvs or getsrc.svn
+ or getsrc.local implementations) which
have various properties that may be set, depending upon the
implementations chosen.
-
-
Fixme (AB)
-
Need a better term than comprised of? Trying give a
-sense of the building blocks used and how they relate to each other.
-
-
+
Using Forrestbot
You need to create a customized buildfile directing Forrestbot's work
@@ -254,14 +250,14 @@
-
+
Creating a buildfile
Within the new buildfile you need to first set properties needed by
the workstages you are going to use and then specify what
implementations will be used by each workstage.
-
Fixme (AB)
+
Fixme (open)
This seems backwards since the properties are dependent
on the implementations - no?
@@ -272,7 +268,7 @@
specifies which implementations we will use and finishes up with
importing the forrestbot.xml file.
-
Fixme (AB)
+
Fixme (open)
Is "default workstage target" the correct term for
default="main"?
@@ -306,7 +302,7 @@
</project>
-
+
Workstages
It is only necessary to include the specific target implementations in
the buildfile if we want to override the default implementations. The
@@ -428,13 +424,13 @@
your own implementation of a workstage, or use any other ant tasks to do
additional work.
-
Fixme (AB)
+
Fixme (open)
How do you create your own implementation? Can you
create a different default target than main - how do you override the
default?
-
+
Workstage Properties
Each workstage implementation is configurable with properties. The
following tables describe each property and whether or not you are
@@ -446,7 +442,7 @@
my-settings.xml) that just sets those properties (don't include it in
CVS/SVN). Then in your project buildfile, have <import
file="my-settings.xml"/>.
-
+
Misc Properties
@@ -477,13 +473,13 @@
-
+
getsrc.clean-workdir
This should be executed before a getsrc implementation is executed.
For example, <target name="getsrc"
depends="getsrc.clean-workdir, getsrc.svn"/>
-
+
getsrc.local
@@ -515,7 +511,7 @@
-
+
getsrc.cvs
@@ -611,7 +607,7 @@
-
+
getsrc.svn
@@ -655,7 +651,7 @@
-
+
build.forrest
@@ -698,7 +694,7 @@
-
+
deploy.local
@@ -730,7 +726,7 @@
-
+
deploy.scp
${user.home}/.ssh/known_hosts must properly recognize the host, so
you should manually make an ssh connection to the host if you never
@@ -777,7 +773,7 @@
-
+
deploy.cvs
This is only available on *nix operating systems.
@@ -874,7 +870,7 @@
-
+
deploy.svn
@@ -944,7 +940,7 @@
-
+
deploy.ftp
@@ -1014,7 +1010,7 @@
-
+
notify
These settings are used by all notify implementations.
@@ -1112,10 +1108,10 @@
-
+
notify.local
No properties.
-
+
notify.email
@@ -1174,7 +1170,7 @@
-
+
Forrestbot design
Forrest and forrestbot use ant buildfiles extensively. Ant 1.6's import
@@ -1205,7 +1201,7 @@
Your buildfile can specify which workstages you want to use, set
properties for them, and do any additional pre- and post-processing.
-
Fixme (AB)
+
Fixme (open)
Which of these (Your buildfile/workstage buildfile) is
the "project buildfile" referred to elsewhere on this page, if any? If it is
"Your buildfile" can I also create workstage buildfiles? If so, how?