You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by ja...@apache.org on 2006/03/14 09:45:31 UTC
svn commit: r385760 [7/8] - in /xerces/xerces-p/trunk/docs/forrest-docs: ./
build/ build/site/ build/site/images/ build/site/samples/ build/site/skin/
build/site/skin/css/ build/site/skin/images/ build/site/skin/scripts/
build/site/skin/translations/ b...
Added: xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/error.log
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/error.log?rev=385760&view=auto
==============================================================================
(empty)
Added: xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/flow.log
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/flow.log?rev=385760&view=auto
==============================================================================
(empty)
Added: xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/idgen.log
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/idgen.log?rev=385760&view=auto
==============================================================================
(empty)
Added: xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/linkrewriter.log
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/linkrewriter.log?rev=385760&view=auto
==============================================================================
(empty)
Added: xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/sitemap.log
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/sitemap.log?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/sitemap.log (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/sitemap.log Tue Mar 14 00:45:06 2006
@@ -0,0 +1,45 @@
+WARN (2006-03-14) 14:09.44:559 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1e1dadb' not found
+WARN (2006-03-14) 14:09.45:439 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1ecfe07' not found
+WARN (2006-03-14) 14:09.47:323 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@951a0' not found
+WARN (2006-03-14) 14:09.47:918 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@4ab2f' not found
+WARN (2006-03-14) 14:09.48:816 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@89e2f1' not found
+WARN (2006-03-14) 14:09.49:916 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1efc208' not found
+WARN (2006-03-14) 14:09.50:231 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@746ad0' not found
+WARN (2006-03-14) 14:09.50:674 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@5b38d7' not found
+WARN (2006-03-14) 14:09.51:095 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@12f9bcd' not found
+WARN (2006-03-14) 14:09.51:234 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1afd9cc' not found
+WARN (2006-03-14) 14:09.51:454 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@a010ba' not found
+WARN (2006-03-14) 14:09.51:762 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1a5e68a' not found
+WARN (2006-03-14) 14:09.52:037 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@705d28' not found
+WARN (2006-03-14) 14:09.52:372 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@dfc362' not found
+WARN (2006-03-14) 14:09.52:637 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@8f3d27' not found
+WARN (2006-03-14) 14:09.52:914 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1603522' not found
+WARN (2006-03-14) 14:09.53:135 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1d8e9e' not found
+WARN (2006-03-14) 14:09.53:151 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@7e5130' not found
+WARN (2006-03-14) 14:09.53:306 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@11710be' not found
+WARN (2006-03-14) 14:09.53:991 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@d2d58b' not found
+WARN (2006-03-14) 14:09.54:069 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@413fc6' not found
+WARN (2006-03-14) 14:09.54:378 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@c4afc4' not found
+WARN (2006-03-14) 14:09.54:769 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1faa614' not found
+WARN (2006-03-14) 14:09.54:890 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@f2c96c' not found
+WARN (2006-03-14) 14:09.55:178 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@511e0a' not found
+WARN (2006-03-14) 14:09.55:302 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@5bd978' not found
+WARN (2006-03-14) 14:09.55:682 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1be1041' not found
+WARN (2006-03-14) 14:09.55:838 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@b655a' not found
+WARN (2006-03-14) 14:09.55:935 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@7787a5' not found
+WARN (2006-03-14) 14:09.56:464 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1017ca1' not found
+WARN (2006-03-14) 14:09.56:757 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@107f742' not found
+WARN (2006-03-14) 14:09.59:380 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@10ce397' not found
+WARN (2006-03-14) 14:09.59:484 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@9c6201' not found
+WARN (2006-03-14) 14:09.59:943 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@cd51ad' not found
+WARN (2006-03-14) 14:10.00:378 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1f528ab' not found
+WARN (2006-03-14) 14:10.00:527 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@13a95af' not found
+WARN (2006-03-14) 14:10.00:787 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1e06de8' not found
+WARN (2006-03-14) 14:10.00:839 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@b64f2e' not found
+WARN (2006-03-14) 14:10.00:894 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1408325' not found
+WARN (2006-03-14) 14:10.00:983 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@863941' not found
+WARN (2006-03-14) 14:10.01:264 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@1eeba19' not found
+WARN (2006-03-14) 14:10.01:310 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@395aaf' not found
+WARN (2006-03-14) 14:10.01:409 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@13c952f' not found
+WARN (2006-03-14) 14:10.01:480 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@127d15e' not found
+WARN (2006-03-14) 14:10.01:524 [sitemap.action.sourcetype] (Unknown-URI) Unknown-thread/SourceTypeAction: Source 'org.apache.excalibur.source.impl.FileSource@9db0e2' not found
Added: xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/xmlform.log
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/build/webapp/WEB-INF/logs/xmlform.log?rev=385760&view=auto
==============================================================================
(empty)
Added: xerces/xerces-p/trunk/docs/forrest-docs/forrest.properties
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/forrest.properties?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/forrest.properties (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/forrest.properties Tue Mar 14 00:45:06 2006
@@ -0,0 +1,129 @@
+# Copyright 2002-2005 The Apache Software Foundation or its licensors,
+# as applicable.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+##############
+# Properties used by forrest.build.xml for building the website
+# These are the defaults, un-comment them only if you need to change them.
+##############
+
+# Prints out a summary of Forrest settings for this project
+#forrest.echo=true
+
+# Project name (used to name .war file)
+project.name=Xerces-P
+
+# Specifies name of Forrest skin to use
+# See list at http://forrest.apache.org/docs/skins.html
+#project.skin=pelt
+
+# Descriptors for plugins and skins
+# comma separated list, file:// is supported
+#forrest.skins.descriptors=http://forrest.apache.org/skins/skins.xml,file:///c:/myskins/skins.xml
+#forrest.plugins.descriptors=http://forrest.apache.org/plugins/plugins.xml,http://forrest.apache.org/plugins/whiteboard-plugins.xml
+
+##############
+# behavioural properties
+#project.menu-scheme=tab_attributes
+#project.menu-scheme=directories
+
+##############
+# layout properties
+
+# Properties that can be set to override the default locations
+#
+# Parent properties must be set. This usually means uncommenting
+# project.content-dir if any other property using it is uncommented
+
+#project.status=status.xml
+#project.content-dir=src/documentation
+#project.raw-content-dir=${project.content-dir}/content
+#project.conf-dir=${project.content-dir}/conf
+#project.sitemap-dir=${project.content-dir}
+#project.xdocs-dir=${project.content-dir}/content/xdocs
+#project.resources-dir=${project.content-dir}/resources
+#project.stylesheets-dir=${project.resources-dir}/stylesheets
+#project.images-dir=${project.resources-dir}/images
+#project.schema-dir=${project.resources-dir}/schema
+#project.skins-dir=${project.content-dir}/skins
+#project.skinconf=${project.content-dir}/skinconf.xml
+#project.lib-dir=${project.content-dir}/lib
+#project.classes-dir=${project.content-dir}/classes
+#project.translations-dir=${project.content-dir}/translations
+
+##############
+# validation properties
+
+# This set of properties determine if validation is performed
+# Values are inherited unless overridden.
+# e.g. if forrest.validate=false then all others are false unless set to true.
+#forrest.validate=true
+#forrest.validate.xdocs=${forrest.validate}
+#forrest.validate.skinconf=${forrest.validate}
+#forrest.validate.sitemap=${forrest.validate}
+#forrest.validate.stylesheets=${forrest.validate}
+#forrest.validate.skins=${forrest.validate}
+#forrest.validate.skins.stylesheets=${forrest.validate.skins}
+
+# *.failonerror=(true|false) - stop when an XML file is invalid
+#forrest.validate.failonerror=true
+
+# *.excludes=(pattern) - comma-separated list of path patterns to not validate
+# e.g.
+#forrest.validate.xdocs.excludes=samples/subdir/**, samples/faq.xml
+#forrest.validate.xdocs.excludes=
+
+
+##############
+# General Forrest properties
+
+# The URL to start crawling from
+#project.start-uri=linkmap.html
+
+# Set logging level for messages printed to the console
+# (DEBUG, INFO, WARN, ERROR, FATAL_ERROR)
+#project.debuglevel=ERROR
+
+# Max memory to allocate to Java
+#forrest.maxmemory=64m
+
+# Any other arguments to pass to the JVM. For example, to run on an X-less
+# server, set to -Djava.awt.headless=true
+#forrest.jvmargs=
+
+# The bugtracking URL - the issue number will be appended
+#project.bugtracking-url=http://issues.apache.org/bugzilla/show_bug.cgi?id=
+#project.bugtracking-url=http://issues.apache.org/jira/browse/
+
+# The issues list as rss
+#project.issues-rss-url=
+
+#I18n Property. Based on the locale request for the browser.
+#If you want to use it for static site then modify the JVM system.language
+# and run once per language
+#project.i18n=true
+
+# The names of plugins that are required to build the project
+# comma separated list (no spaces)
+# You can request a specific version by appending "-VERSION" to the end of
+# the plugin name. If you exclude a version number the latest released version
+# will be used, however, be aware that this may be a development version. In
+# a production environment it is recomended that you specify a known working
+# version.
+# Run "forrest available-plugins" for a list of plug-ins currently available
+project.required.plugins=org.apache.forrest.plugin.output.pdf
+
+# Proxy configuration
+# proxy.host=
+# proxy.port=
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/README.txt
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/README.txt?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/README.txt (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/README.txt Tue Mar 14 00:45:06 2006
@@ -0,0 +1,7 @@
+This is the base documentation directory.
+
+skinconf.xml # This file customizes Forrest for your project. In it, you
+ # tell forrest the project name, logo, copyright info, etc
+
+sitemap.xmap # Optional. This sitemap is consulted before all core sitemaps.
+ # See http://forrest.apache.org/docs/project-sitemap.html
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/classes/CatalogManager.properties
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/classes/CatalogManager.properties?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/classes/CatalogManager.properties (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/classes/CatalogManager.properties Tue Mar 14 00:45:06 2006
@@ -0,0 +1,57 @@
+# Copyright 2002-2005 The Apache Software Foundation or its licensors,
+# as applicable.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#=======================================================================
+# CatalogManager.properties for Catalog Entity Resolver.
+#
+# This is the default properties file for your project.
+# This facilitates local configuration of application-specific catalogs.
+# If you have defined any local catalogs, then they will be loaded
+# before Forrest's core catalogs.
+#
+# See the Apache Forrest documentation:
+# http://forrest.apache.org/docs/your-project.html
+# http://forrest.apache.org/docs/validation.html
+
+# verbosity:
+# The level of messages for status/debug (messages go to standard output).
+# The setting here is for your own local catalogs.
+# The verbosity of Forrest's core catalogs is controlled via
+# main/webapp/WEB-INF/cocoon.xconf
+#
+# The following messages are provided ...
+# 0 = none
+# 1 = ? (... not sure yet)
+# 2 = 1+, Loading catalog, Resolved public, Resolved system
+# 3 = 2+, Catalog does not exist, resolvePublic, resolveSystem
+# 10 = 3+, List all catalog entries when loading a catalog
+# (Cocoon also logs the "Resolved public" messages.)
+verbosity=1
+
+# catalogs ... list of additional catalogs to load
+# (Note that Apache Forrest will automatically load its own default catalog
+# from main/webapp/resources/schema/catalog.xcat)
+# Use either full pathnames or relative pathnames.
+# pathname separator is always semi-colon (;) regardless of operating system
+# directory separator is always slash (/) regardless of operating system
+catalogs=../resources/schema/catalog.xcat
+
+# relative-catalogs
+# If false, relative catalog URIs are made absolute with respect to the
+# base URI of the CatalogManager.properties file. This setting only
+# applies to catalog URIs obtained from the catalogs property in the
+# CatalogManager.properties file
+# Example: relative-catalogs=[yes|no]
+relative-catalogs=no
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/conf/cli.xconf
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/conf/cli.xconf?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/conf/cli.xconf (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/conf/cli.xconf Tue Mar 14 00:45:06 2006
@@ -0,0 +1,318 @@
+<?xml version="1.0"?>
+<!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!--+
+ | This is the Apache Cocoon command line configuration file.
+ | Here you give the command line interface details of where
+ | to find various aspects of your Cocoon installation.
+ |
+ | If you wish, you can also use this file to specify the URIs
+ | that you wish to generate.
+ |
+ | The current configuration information in this file is for
+ | building the Cocoon documentation. Therefore, all links here
+ | are relative to the build context dir, which, in the build.xml
+ | file, is set to ${build.context}
+ |
+ | Options:
+ | verbose: increase amount of information presented
+ | to standard output (default: false)
+ | follow-links: whether linked pages should also be
+ | generated (default: true)
+ | precompile-only: precompile sitemaps and XSP pages, but
+ | do not generate any pages (default: false)
+ | confirm-extensions: check the mime type for the generated page
+ | and adjust filename and links extensions
+ | to match the mime type
+ | (e.g. text/html->.html)
+ |
+ | Note: Whilst using an xconf file to configure the Cocoon
+ | Command Line gives access to more features, the use of
+ | command line parameters is more stable, as there are
+ | currently plans to improve the xconf format to allow
+ | greater flexibility. If you require a stable and
+ | consistent method for accessing the CLI, it is recommended
+ | that you use the command line parameters to configure
+ | the CLI. See documentation at:
+ | http://cocoon.apache.org/2.1/userdocs/offline/
+ | http://wiki.apache.org/cocoon/CommandLine
+ |
+ +-->
+
+<cocoon verbose="true"
+ follow-links="true"
+ precompile-only="false"
+ confirm-extensions="false">
+
+ <!--+
+ | The context directory is usually the webapp directory
+ | containing the sitemap.xmap file.
+ |
+ | The config file is the cocoon.xconf file.
+ |
+ | The work directory is used by Cocoon to store temporary
+ | files and cache files.
+ |
+ | The destination directory is where generated pages will
+ | be written (assuming the 'simple' mapper is used, see
+ | below)
+ +-->
+ <context-dir>.</context-dir>
+ <config-file>WEB-INF/cocoon.xconf</config-file>
+ <work-dir>../tmp/cocoon-work</work-dir>
+ <dest-dir>../site</dest-dir>
+
+ <!--+
+ | A checksum file can be used to store checksums for pages
+ | as they are generated. When the site is next generated,
+ | files will not be written if their checksum has not changed.
+ | This means that it will be easier to detect which files
+ | need to be uploaded to a server, using the timestamp.
+ +-->
+ <!-- <checksums-uri>build/work/checksums</checksums-uri>-->
+
+ <!--+
+ | Broken link reporting options:
+ | Report into a text file, one link per line:
+ | <broken-links type="text" report="filename"/>
+ | Report into an XML file:
+ | <broken-links type="xml" report="filename"/>
+ | Ignore broken links (default):
+ | <broken-links type="none"/>
+ |
+ | Two attributes to this node specify whether a page should
+ | be generated when an error has occured. 'generate' specifies
+ | whether a page should be generated (default: true) and
+ | extension specifies an extension that should be appended
+ | to the generated page's filename (default: none)
+ |
+ | Using this, a quick scan through the destination directory
+ | will show broken links, by their filename extension.
+ +-->
+ <broken-links type="xml"
+ file="../brokenlinks.xml"
+ generate="false"
+ extension=".error"
+ show-referrers="true"/>
+
+ <!--+
+ | Load classes at startup. This is necessary for generating
+ | from sites that use SQL databases and JDBC.
+ | The <load-class> element can be repeated if multiple classes
+ | are needed.
+ +-->
+ <!--
+ <load-class>org.firebirdsql.jdbc.Driver</load-class>
+ -->
+
+ <!--+
+ | Configures logging.
+ | The 'log-kit' parameter specifies the location of the log kit
+ | configuration file (usually called logkit.xconf.
+ |
+ | Logger specifies the logging category (for all logging prior
+ | to other Cocoon logging categories taking over)
+ |
+ | Available log levels are:
+ | DEBUG: prints all level of log messages.
+ | INFO: prints all level of log messages except DEBUG
+ | ones.
+ | WARN: prints all level of log messages except DEBUG
+ | and INFO ones.
+ | ERROR: prints all level of log messages except DEBUG,
+ | INFO and WARN ones.
+ | FATAL_ERROR: prints only log messages of this level
+ +-->
+ <!-- <logging log-kit="WEB-INF/logkit.xconf" logger="cli" level="ERROR" /> -->
+
+ <!--+
+ | Specifies the filename to be appended to URIs that
+ | refer to a directory (i.e. end with a forward slash).
+ +-->
+ <default-filename>index.html</default-filename>
+
+ <!--+
+ | Specifies a user agent string to the sitemap when
+ | generating the site.
+ |
+ | A generic term for a web browser is "user agent". Any
+ | user agent, when connecting to a web server, will provide
+ | a string to identify itself (e.g. as Internet Explorer or
+ | Mozilla). It is possible to have Cocoon serve different
+ | content depending upon the user agent string provided by
+ | the browser. If your site does this, then you may want to
+ | use this <user-agent> entry to provide a 'fake' user agent
+ | to Cocoon, so that it generates the correct version of your
+ | site.
+ |
+ | For most sites, this can be ignored.
+ +-->
+ <!--
+ <user-agent>Cocoon Command Line Environment 2.1</user-agent>
+ -->
+
+ <!--+
+ | Specifies an accept string to the sitemap when generating
+ | the site.
+ | User agents can specify to an HTTP server what types of content
+ | (by mime-type) they are able to receive. E.g. a browser may be
+ | able to handle jpegs, but not pngs. The HTTP accept header
+ | allows the server to take the browser's capabilities into account,
+ | and only send back content that it can handle.
+ |
+ | For most sites, this can be ignored.
+ +-->
+
+ <accept>*/*</accept>
+
+ <!--+
+ | Specifies which URIs should be included or excluded, according
+ | to wildcard patterns.
+ |
+ | These includes/excludes are only relevant when you are following
+ | links. A link URI must match an include pattern (if one is given)
+ | and not match an exclude pattern, if it is to be followed by
+ | Cocoon. It can be useful, for example, where there are links in
+ | your site to pages that are not generated by Cocoon, such as
+ | references to api-documentation.
+ |
+ | By default, all URIs are included. If both include and exclude
+ | patterns are specified, a URI is first checked against the
+ | include patterns, and then against the exclude patterns.
+ |
+ | Multiple patterns can be given, using muliple include or exclude
+ | nodes.
+ |
+ | The order of the elements is not significant, as only the first
+ | successful match of each category is used.
+ |
+ | Currently, only the complete source URI can be matched (including
+ | any URI prefix). Future plans include destination URI matching
+ | and regexp matching. If you have requirements for these, contact
+ | dev@cocoon.apache.org.
+ +-->
+
+ <exclude pattern="**/"/>
+ <exclude pattern="**apidocs**"/>
+ <exclude pattern="api/**"/>
+
+<!--
+ This is a workaround for FOR-284 "link rewriting broken when
+ linking to xml source views which contain site: links".
+ See the explanation there and in declare-broken-site-links.xsl
+-->
+ <exclude pattern="site:**"/>
+ <exclude pattern="ext:**"/>
+ <exclude pattern="**/site:**"/>
+ <exclude pattern="**/ext:**"/>
+
+ <!-- Exclude tokens used in URLs to ASF mirrors (interpreted by a CGI) -->
+ <exclude pattern="[preferred]/**"/>
+ <exclude pattern="[location]"/>
+
+ <!-- <include-links extension=".html"/>-->
+
+ <!--+
+ | <uri> nodes specify the URIs that should be generated, and
+ | where required, what should be done with the generated pages.
+ | They describe the way the URI of the generated file is created
+ | from the source page's URI. There are three ways that a generated
+ | file URI can be created: append, replace and insert.
+ |
+ | The "type" attribute specifies one of (append|replace|insert):
+ |
+ | append:
+ | Append the generated page's URI to the end of the source URI:
+ |
+ | <uri type="append" src-prefix="documents/" src="index.html"
+ | dest="build/dest/"/>
+ |
+ | This means that
+ | (1) the "documents/index.html" page is generated
+ | (2) the file will be written to "build/dest/documents/index.html"
+ |
+ | replace:
+ | Completely ignore the generated page's URI - just
+ | use the destination URI:
+ |
+ | <uri type="replace" src-prefix="documents/" src="index.html"
+ | dest="build/dest/docs.html"/>
+ |
+ | This means that
+ | (1) the "documents/index.html" page is generated
+ | (2) the result is written to "build/dest/docs.html"
+ | (3) this works only for "single" pages - and not when links
+ | are followed
+ |
+ | insert:
+ | Insert generated page's URI into the destination
+ | URI at the point marked with a * (example uses fictional
+ | zip protocol)
+ |
+ | <uri type="insert" src-prefix="documents/" src="index.html"
+ | dest="zip://*.zip/page.html"/>
+ |
+ | This means that
+ | (1)
+ |
+ | In any of these scenarios, if the dest attribute is omitted,
+ | the value provided globally using the <dest-dir> node will
+ | be used instead.
+ +-->
+ <!--
+ <uri type="replace"
+ src-prefix="samples/"
+ src="hello-world/hello.html"
+ dest="build/dest/hello-world.html"/>
+ -->
+
+ <!--+
+ | <uri> nodes can be grouped together in a <uris> node. This
+ | enables a group of URIs to share properties. The following
+ | properties can be set for a group of URIs:
+ | * follow-links: should pages be crawled for links
+ | * confirm-extensions: should file extensions be checked
+ | for the correct mime type
+ | * src-prefix: all source URIs should be
+ | pre-pended with this prefix before
+ | generation. The prefix is not
+ | included when calculating the
+ | destination URI
+ | * dest: the base destination URI to be
+ | shared by all pages in this group
+ | * type: the method to be used to calculate
+ | the destination URI. See above
+ | section on <uri> node for details.
+ |
+ | Each <uris> node can have a name attribute. When a name
+ | attribute has been specified, the -n switch on the command
+ | line can be used to tell Cocoon to only process the URIs
+ | within this URI group. When no -n switch is given, all
+ | <uris> nodes are processed. Thus, one xconf file can be
+ | used to manage multiple sites.
+ +-->
+ <uris name="mirrors" follow-links="false">
+ <uri type="append" src="mirrors.html"/>
+ </uris>
+
+ <!--+
+ | File containing URIs (plain text, one per line).
+ +-->
+ <!--
+ <uri-file>uris.txt</uri-file>
+ -->
+</cocoon>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/mirrors.cgi
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/mirrors.cgi?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/mirrors.cgi (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/mirrors.cgi Tue Mar 14 00:45:06 2006
@@ -0,0 +1,23 @@
+#!/bin/sh
+
+# Copyright 2002-2004 The Apache Software Foundation or its licensors,
+# as applicable.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Wrapper script around mirrors.cgi script
+# (we must change to that directory in order for python to pick up the
+# python includes correctly)
+# Copied from Stefan's http://www.apache.org/~bodewig/mirror.html
+cd /www/www.apache.org/dyn/mirrors
+/www/www.apache.org/dyn/mirrors/mirrors.cgi $*
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/semantic.cache
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/semantic.cache?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/semantic.cache (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/semantic.cache Tue Mar 14 00:45:06 2006
@@ -0,0 +1,14 @@
+;; Object content/
+;; SEMANTICDB Tags save file
+(semanticdb-project-database-file "content/"
+ :tables (list
+ (semanticdb-table "test1.html"
+ :major-mode 'html-mode
+ :tags 'nil
+ :file "test1.html"
+ )
+ )
+ :file "semantic.cache"
+ :semantic-tag-version "2.0pre3"
+ :semanticdb-version "2.0pre3"
+ )
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/download.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/download.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/download.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/download.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,103 @@
+<?xml version="1.0" standalone="no"?>
+
+<!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+
+<document>
+ <header>
+ <title>Downloading &PROJECT_NAME;</title>
+ </header>
+ <body>
+
+<section>
+<title>Downloading &PROJECT_NAME;</title>
+ <section>
+<title>Getting the source code</title>
+ <p> The most current stable source code for &PROJECT_NAME; can be
+ downloaded from <a
+ href="http://xml.apache.org/dist/xerces-p/stable/"> here </a>
+ </p>
+ </section>
+
+ <section>
+<title>Verifying the release</title>
+ <p> The current &PROJECT_NAME; maintainer, Jason E. Stewart
+ (<a
+ href="mailto:jasons@apache.org">jasons@apache.org</a>), signs
+ every release with his <a
+ href="http://www.gnupg.org/">GnuPG</a> public key. This is to
+ help you ensure that you are installing only officially
+ sanctioned code, from the official maintainer. By downloading
+ the source code and signature from one location (<a
+ href="http://www.apache.org/info/20010519-hack.html">possibly
+ open to attack</a>) and the public key from an official key
+ server, you greatly reduce the chance of installing software
+ that is dangerous to you.
+ </p>
+
+ <section>
+<title>Getting the Public key</title>
+ <p> You can use any keyserver you wish, such as <a
+ href="http://www.keyserver.net/">www.keyserver.net</a>, and
+ search for <em>jasons@apache.org</em> or you can get the
+ key<a
+ href="http://dtype.org:11371/pks/lookup?search=jasons%40apache.org&op=index">
+ here </a>.
+ </p>
+ </section>
+ <section>
+<title>Using PGP to verify the code</title>
+ <ol>
+ <li>Add the key to your keyring: <code>
+pgpk -a key_file
+</code></li>
+ <li>Verify the source code file <code>
+pgpv XML-Xerces-X.Y.Z XML-Xerces-X.Y.Z.asc
+</code></li>
+ <li>If you receive any other response than: <em>Good
+ signature</em>, something went wrong, so don't trust the
+ file.
+ </li>
+ </ol>
+ </section>
+ <section>
+<title>Using GnuPG to verify the code</title>
+ <ol>
+ <li>Import the key to your keyring: <code>
+gpg --import key_file
+</code></li>
+ <li>Verify the source code file <code>
+gpg --verify XML-Xerces-X.Y.Z XML-Xerces-X.Y.Z.asc
+</code></li>
+ <li>If you receive any other response than: <em>gpg: Good
+ signature</em>, something went wrong, so don't trust the
+ file.
+ </li>
+ </ol>
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group-logo.gif
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group-logo.gif?rev=385760&view=auto
==============================================================================
Binary file - no diff available.
Propchange: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group.svg
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group.svg?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group.svg (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/group.svg Tue Mar 14 00:45:06 2006
@@ -0,0 +1,82 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--
+ SVG Anteater logo
+
+To get started with SVG, I'd recommend getting the Adobe SVG plugin, and the
+xml-batik CVS module. Then have a look at the xml-batik/samples files. Use the
+SVG spec (http://www.w3.org/TR/SVG/) as a reference.
+-->
+
+<!-- See Forrest Issue: FOR-229
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN"
+"http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"
+[
+ <!ATTLIST svg xmlns:for CDATA #FIXED "http://apache.org/forrest">
+ <!ENTITY % textExt "|for:group-name">
+ <!ELEMENT for:group-name (#PCDATA)>
+]>
+-->
+<svg xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xsl:version="1.0"
+ xmlns:for="http://apache.org/forrest"
+ width="220" height="65" >
+ <title>Anteater logo</title>
+
+ <defs>
+
+ <!--
+ <radialGradient id="radialGradient">
+ <stop style="stop-color:gold" offset="0"/>
+ <stop style="stop-color:orange" offset=".5"/>
+ <stop style="stop-color:crimson" offset="1"/>
+ </radialGradient>
+ <linearGradient id="linearGradient">
+ <stop style="stop-color:gold" offset="0"/>
+ <stop style="stop-color:orange" offset=".5"/>
+ <stop style="stop-color:crimson" offset="1"/>
+ </linearGradient>
+ -->
+
+ <linearGradient id="gradient" x1="0" y1="0" x2="0" y2="1">
+ <stop style="stop-color:white" offset="0"/>
+ <stop style="stop-color:lightgreen" offset="1"/>
+ </linearGradient>
+
+ <filter id="shadowFilter" filterUnits="objectBoundingBox" width="1.4" height="1.4">
+ <!-- Takes the alpha channel (black outline of the text), blurs it and saves as 'blur' -->
+ <feGaussianBlur in="SourceAlpha" stdDeviation="2 2" result="blur"/>
+ <!-- Takes saved 'blur' and offsets it by 4 pixels, saves as 'offsetBlur' -->
+ <feOffset in="blur" dx="4" dy="4" result="offsetBlur"/>
+ <!-- Merges SourceGraphic (original image) and 'offsetBlur', putting the
+ former 'over' the latter, and using the merged result as the finished
+ image -->
+ <feComposite in="SourceGraphic" in2="offsetBlur" operator="over"/>
+ </filter>
+
+ </defs>
+
+ <g filter="url(#shadowFilter)" fill="url(#gradient)">
+ <text x="40%" y="60%" style="font-size:24pt; font-family:Verdana ; text-anchor: middle">
+ <for:group-name />
+ </text>
+ </g>
+</svg>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/icon.png
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/icon.png?rev=385760&view=auto
==============================================================================
Binary file - no diff available.
Propchange: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/icon.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project-logo.gif
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project-logo.gif?rev=385760&view=auto
==============================================================================
Binary file - no diff available.
Propchange: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project.svg
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project.svg?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project.svg (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/project.svg Tue Mar 14 00:45:06 2006
@@ -0,0 +1,82 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--
+ SVG Anteater logo
+
+To get started with SVG, I'd recommend getting the Adobe SVG plugin, and the
+xml-batik CVS module. Then have a look at the xml-batik/samples files. Use the
+SVG spec (http://www.w3.org/TR/SVG/) as a reference.
+-->
+
+<!-- See Forrest Issue: FOR-229
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN"
+"http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"
+[
+ <!ATTLIST svg xmlns:for CDATA #FIXED "http://apache.org/forrest">
+ <!ENTITY % textExt "|for:project-name">
+ <!ELEMENT for:project-name (#PCDATA)>
+]>
+-->
+<svg xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xsl:version="1.0"
+ xmlns:for="http://apache.org/forrest"
+ width="420" height="65" >
+ <title>Anteater logo</title>
+
+ <defs>
+
+ <!--
+ <radialGradient id="radialGradient">
+ <stop style="stop-color:gold" offset="0"/>
+ <stop style="stop-color:orange" offset=".5"/>
+ <stop style="stop-color:crimson" offset="1"/>
+ </radialGradient>
+ <linearGradient id="linearGradient">
+ <stop style="stop-color:gold" offset="0"/>
+ <stop style="stop-color:orange" offset=".5"/>
+ <stop style="stop-color:crimson" offset="1"/>
+ </linearGradient>
+ -->
+
+ <linearGradient id="gradient" x1="0" y1="0" x2="0" y2="1">
+ <stop style="stop-color:white" offset="0"/>
+ <stop style="stop-color:lightgreen" offset="1"/>
+ </linearGradient>
+
+ <filter id="shadowFilter" filterUnits="objectBoundingBox" width="1.4" height="1.4">
+ <!-- Takes the alpha channel (black outline of the text), blurs it and saves as 'blur' -->
+ <feGaussianBlur in="SourceAlpha" stdDeviation="2 2" result="blur"/>
+ <!-- Takes saved 'blur' and offsets it by 4 pixels, saves as 'offsetBlur' -->
+ <feOffset in="blur" dx="4" dy="4" result="offsetBlur"/>
+ <!-- Merges SourceGraphic (original image) and 'offsetBlur', putting the
+ former 'over' the latter, and using the merged result as the finished
+ image -->
+ <feComposite in="SourceGraphic" in2="offsetBlur" operator="over"/>
+ </filter>
+
+ </defs>
+
+ <g filter="url(#shadowFilter)" fill="url(#gradient)">
+ <text x="100%" y="60%" style="font-size:24pt; font-family:Verdana ; text-anchor: end" >
+ <for:project-name />
+ </text>
+ </g>
+</svg>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/usemap.gif
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/usemap.gif?rev=385760&view=auto
==============================================================================
Binary file - no diff available.
Propchange: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/images/usemap.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/index.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/index.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/index.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,461 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>Welcome to &PROJECT_NAME;</title>
+ </header>
+ <body>
+<section>
+<title>Xerces Perl: The Perl API to the Apache Xerces XML parser</title>
+ <section>
+<title>Current Release: &XERCES_P_NAME; &XERCES_P_VERSION;</title>
+ <p>
+&XERCES_P_NAME; is the Perl API to the Apache project's Xerces XML
+parser. It is implemented using the Xerces C++ API, and it provides
+access to <em>most</em> of the C++ API from Perl.
+ </p>
+ <p>
+Because it is based on &XERCES_C_NAME;, &XERCES_P_NAME; provides a
+validating XML parser that makes it easy to give your application the
+ability to read and write XML data. Classes are provided for parsing,
+generating, manipulating, and validating XML documents. &XERCES_P_NAME;
+is faithful to the XML 1.0 recommendation and associated standards
+(DOM levels 1, 2, and 3, SAX 1 and 2, Namespaces, and W3C XML
+Schema). The parser provides high performance, modularity, and
+scalability, and provides full support for Unicode.
+ </p>
+ <p>
+&XERCES_P_NAME; implements the vast majority of the Xerces-C API (if
+you notice any discrepancies please mail the <a href="mailto:&XERCES_P_LIST;">
+list</a>). The exception is some functions in the C++ API which
+either have better Perl counterparts (such as file I/O) or which
+manipulate internal C++ information that has no role in the Perl
+module.
+ </p>
+ <p>
+The majority of the API is created automatically using
+<a href="http://www.swig.org/">Simplified Wrapper Interface
+Generator (SWIG)</a>. However, care has been taken to make most
+method invocations natural to perl programmers, so a number of rough
+C++ edges have been smoothed over (See the <a href="#perl-api">Special Perl API Features</a> section).
+ </p>
+ </section>
+ <section>
+<title>Support</title>
+ <p>The online users mailing list is the place for any
+ questions. It is at: &XERCES_P_LIST;</p>
+ </section>
+ <section>
+<title>Available Platforms</title>
+ <p>
+The code has been tested on the following platforms:
+ </p>
+ <ul>
+ <li>Linux</li>
+ <li>Cygwin</li>
+ <li>Windows</li>
+ <li>Mac OS X</li>
+ <li>BSD</li>
+ <li>Solaris </li>
+ <li>AIX </li>
+ <li>Tru64 </li>
+ </ul>
+ </section>
+ <section>
+<title>Build Requirements</title>
+ <section>
+<title>ANSI C++ compiler</title>
+ <p>Builds are known to work with the GNU C compiler, and other platform
+ specific compilers (such as VC++ on Windows and Forte on
+ Solaris). Contributions in this area are always welcome :-).
+ </p>
+ </section>
+ <section>
+<title>Perl5</title>
+ <note>Required version: 5.6.0</note>
+ <p>&XERCES_P_NAME; now supports Unicode. Since Unicode support wasn't
+ added to Perl until 5.6.0, you will need to upgrade in order to use this
+ and future versions of &XERCES_P_NAME;. Upgrading to at least to the
+ latest stable release, 5.6.1, is recommended.
+ </p>
+ <p>If you plan on using Unicode, I <em>strongly</em> recommend upgrading
+ to Perl-5.8.x, the latest stable version. There have been significant
+ improvements to Perl's Unicode support.
+ </p>
+ </section>
+ <section>
+<title>The Apache Xerces C++ XML Parser</title>
+ <note>Required version: &XERCES_C_VERSION;</note>
+ <p>(which can be downloaded from <a href="http://www.apache.org/dist/xml/xerces-c/">
+ the apache archive</a>) You'll need both the library and header files,
+ and to set up any environment variables that will direct the
+ &XERCES_P_NAME; build to the directories where these reside.
+ </p>
+ </section>
+ </section>
+ <section>
+<title>Prepare for the build</title>
+ <section>
+<title>Download &XERCES_P_NAME;</title>
+ <p>Download the release and it's digital signature, from<a href="http://xml.apache.org/dist/xerces-p/stable">
+ the apache Xerces-C archive</a>.
+ </p>
+ </section>
+ <section>
+<title>Verify the archive</title>
+ <p>Optionally verify the release using the supplied digital signature (see
+ <a href="http://xml.apache.org/xerces-p/download.html">the apache
+ Xerces-Perl archive</a> for details)
+ </p>
+ </section>
+ <section>
+<title>Unpack the archive</title>
+ <p>Unpack the archive in a directory of your choice. Example
+ (for UNIX):
+ </p>
+ <ul>
+ <li><code>tar zxvf XML-Xerces-&XERCES_P_VERSION;.tar.gz</code></li>
+ <li><code>cd XML-Xerces-&XERCES_P_VERSION;</code></li>
+ </ul>
+ </section>
+ <section>
+<title>Getting &XERCES_C_NAME;</title>
+ <p>If the Xerces-C library and header files are installed on your system
+ directly, e.g. via an rpm or deb package, proceed to the directions for
+ building &XERCES_P_NAME;.
+ </p>
+ <p>Otherwise, you must download &XERCES_C_NAME; from www.apache.org. If
+ there is a binary available for your architecture, you may use it,
+ otherwise you must build it from source. If you wish to make
+ &XERCES_C_NAME; available to other applications, you may install it
+ however it is not necessary to do so in order to build &XERCES_P_NAME;.
+ To build &XERCES_P_NAME; from an uninstalled &XERCES_C_NAME; set the
+ XERCESCROOT environment variable the top-level directory of the source
+ directory (i.e. the same value it needs to be to build &XERCES_C_NAME;):
+ </p>
+ <source>
+ export XERCESCROOT=/home/jasons/xerces-&XERCES_C_VERSION;/
+ </source>
+
+ <p>OPTIONAL: If you choose to install &XERCES_C_NAME; on your system, you
+ need to set the XERCES_INCLUDE and XERCES_LIB environment variables:
+ </p>
+
+ <source><![CDATA[
+ export XERCES_INCLUDE=/usr/include/xerces
+ export XERCES_LIB=/usr/lib
+ ]]></source>
+
+ </section>
+ </section>
+ <section>
+<title>Build &XERCES_P_NAME;</title>
+ <ol>
+ <li>Go to the XML-Xerces-&XERCES_P_VERSION; directory.</li>
+ <li>Build &XERCES_P_NAME; as you would any perl package that you
+ might get from CPAN:</li>
+ <li><ul>
+ <li><code>perl Makefile.PL</code></li>
+ <li><code>make</code></li>
+ <li><code>make test</code></li>
+ <li><code>make install</code></li>
+ </ul></li>
+ </ol>
+ </section>
+ <section>
+<title>Using &XERCES_P_NAME;</title>
+ <p>&XERCES_P_NAME; implements the vast majority of the Xerces-C API (if you
+ notice any discrepancies please mail the list). Documentation for this API
+ are sadly not available in POD format, but the Xerces-C html documentation
+ is available <a href="http://xml.apache.org/xerces-c/apiDocs/index.html">online</a>.
+ </p>
+ <p>For more information, see the examples in the samples/ directory.
+ and the test scripts located in the t/ directory.
+ </p>
+ </section>
+ <section id="perl-api">
+<title>Special Perl API Features</title>
+ <p>Even though &XERCES_P_NAME; is based on the C++ API, it has been modified
+ in a few ways to make it more accessible to typical Perl usage, primarily in
+ the handling:
+ </p>
+ <ul>
+ <li><a href="#string">String I/O</a> (Perl strings versus XMLch arrays)</li>
+ <li><a href="#list">List I/O</a> (Perl lists versus DOM_NodeList's)</li>
+ <li><a href="#hash">Hash I/O</a> (Perl hashes versus DOM_NamedNodeMap's)</li>
+ <li><a href="#list-hash-io">Combined List/Hash classes</a></li>
+ <li><a href="#void-pointer">void* handling</a></li>
+ <li><a href="#serialize">DOM Serialization API</a></li>
+ <li><a href="#handlers">Implementing Perl handlers for C++ event callbacks</a></li>
+ <li><a href="#exceptions">handling C++ exceptions</a></li>
+ <li><a href="#unicode-constants">XML::Xerces::XMLUni unicode constants</a></li>
+ </ul>
+
+ <section id="string">
+<title>String I/O</title>
+
+ <p>The native data type for Xerces-C is the XMLCh* which is a
+ UTF16 encoded string and in Perl strings are encoded in
+ UTF8. All conversion back and forth between Perl and Xerces-C is
+ handled automatically by &XERCES_P_NAME;.
+ </p>
+
+ <p>In fact a lot of effort is made to convert Perl variables
+ into strings before passing them to Xerces-C. So any method
+ that accepts an XMLCh* in Xerces-C will accept any non-undef
+ value using Perl's built-in stringification mechanism.
+ </p>
+ </section>
+
+ <section id="list">
+<title>List I/O</title>
+ <p>Any function that in the C++ API returns a <code>DOMNodeList</code>
+ (e.g. <code>getChildNodes()</code> and <code>getElementsByTagName()</code>
+ for example) will return different types if they are called in a list
+ context or a scalar context. In a scalar context, these functions return a
+ reference to a <code>XML::Xerces::DOMNodeList</code>, just like in C++
+ API. However, in a list context they will return a Perl list of
+ <code>XML::Xerces::DOM_Node</code> references. For example:
+ </p>
+ <source><![CDATA[
+ # returns a reference to a XML::Xerces::DOMNodeList
+ my $node_list_ref = $doc->getElementsByTagName('foo');
+
+ # returns a list of XML::Xerces::DOMNode's
+ my @node_list = $doc->getElementsByTagName('foo');
+ ]]></source>
+ </section>
+
+ <section id="hash">
+<title>Hash I/O</title>
+ <p>Any function that in the C++ API returns a
+ <code>DOMNamedNodeMap</code> (<code>getEntities()</code> and
+ <code>getAttributes()</code> for example) will return different types if
+ they are called in a list context or a scalar context. In a scalar
+ context, these functions return a reference to a
+ <code>XML::Xerces::DOMNamedNodeMap</code>, just like in C++ API. However,
+ in a list context they will return a Perl hash. For example:
+ </p>
+ <source><![CDATA[
+ # returns a reference to a XML::Xerces::DOMNamedNodeMap
+ my $attr_map_ref = $element_node->getAttributes();
+
+ # returns a hash of the attributes
+ my %attrs = $element_node->getAttributes();
+ ]]></source>
+ </section>
+
+ <section id="list-hash-io">
+<title>Combined List/Hash classes (XMLAttDefList)</title>
+ <p>Any function that in the C++ API returns a XMLAttDefList
+ (getAttDefList() for SchemaElementDecl and DTDElementDecl), will
+ always return an instance of XML::Xerces::XMLAttDefList. However,
+ there are two Perl specific API methods that can be invoked on the
+ object: to_list() and to_hash().
+ </p>
+ <source><![CDATA[
+ # get the XML::Xerces::XMLAttDefList.
+ my $attr_list = $element_decl->getAttDefList();
+
+ # return a list of XML::Xerces::XMLAttDef instances
+ my @list = $attr_list->to_list();
+
+ # returns a hash of the attributes, where the keys are the
+ # result of calling getFullName() on the attributes, and the
+ # values are the XML::Xerces::XMLAttDef instances.
+ my %attrs = $attr_list->to_hash();
+ ]]></source>
+ </section>
+
+ <section id="void-pointer">
+<title>Void* handling</title>
+
+ <p>Any function in the C++ API that accepts a void*, for example
+ setProperty() in DOMBuilder and SAX2XMLReader, must be handled
+ specially. Currently, all void* methods convert their arguments
+ to a string before passing them to Xerces-C. In the future, when
+ other data types are needed, this functionality will be
+ expanded. If you locate a case in which you need this support,
+ please alert the development team (<a href="mailto:&XERCES_P_LIST;">&XERCES_P_LIST;</a>).</p>
+
+ </section>
+
+ <section id="serialize">
+<title>Serialize API</title>
+ <p>The DOMWriter class is used for serializing DOM hierarchies. See
+ t/DOMWriter.t or <a href="domprint.html"> samples/DOMPrint.pl</a>
+ for details.
+ </p>
+ <p>For less complex usage, just use the serialize() method defined for all
+ DOMNode subclasses.
+ </p>
+ </section>
+
+ <section id="handlers">
+<title>Implementing {Document,Content,Error}Handlers from Perl</title>
+ <p>Thanks to suggestions from Duncan Cameron, &XERCES_P_NAME; now has a
+ handler API that matches the currently used semantics of other Perl XML
+ API's. There are three classes available for application writers:
+ </p>
+ <ul>
+ <li>PerlErrorHandler (SAX 1/2 and DOM 1)</li>
+ <li>PerlDocumentHandler (SAX 1)</li>
+ <li>PerlContentHandler (SAX 2)</li>
+ </ul>
+ <p>Using these classes is as simple as creating a perl subclass of the
+ needed class, and redefining any needed methods. For example, to override
+ the default fatal_error() method of the PerlErrorHandler class we can
+ include this piece of code within our application:
+ </p>
+ <source><![CDATA[
+ package MyErrorHandler;
+ @ISA = qw(XML::Xerces::PerlErrorHandler);
+ sub fatal_error {die "Oops, I got an error\n";}
+
+ package main;
+ my $dom = new XML::Xerces::DOMParser;
+ $dom->setErrorHandler(MyErrorHandler->new());
+ ]]></source>
+ </section>
+
+ <section id="exceptions">
+<title>Handling exceptions ({XML,DOM,SAX}Exception's)</title>
+ <p>Some errors occur outside parsing and are not caught by the parser's
+ ErrorHandler. &XERCES_P_NAME; provides a way for catching these errors
+ using the PerlExceptionHandler class. Usually the following code
+ is enough for catching exceptions:
+ </p>
+ <source><![CDATA[
+ eval{$parser->parser($my_file)};
+ XML::Xerces::error($@) if $@;
+ ]]></source>
+ <p>Wrap any code that might throw an exception inside an eval{...} and
+ call XML::Xerces::error() passing $@, if $@ is set.
+ </p>
+ <p>There are a default methods that prints out an error message and calls
+ die(), but if more is needed, see the files t/XMLException.t,
+ t/SAXException.t, and t/DOMException.t for details on how to roll your own
+ handler.
+ </p>
+ </section>
+
+ <section id="unicode-constants">
+<title>XML::Xerces::XMLUni unicode constants</title>
+ <p>XML::Xerces uses many constant values for setting of features, and
+ properties, such as for XML::Xerces::SAX2XMLReader::setFeature(). You can
+ hard code the strings or integers into your programs but this will make
+ them vulnerable to an API change. Instead, use the constants defined in
+ the XML::Xerces::XMLUni class. If the API changes, the constants will be
+ updated to reflect that change. See the file docs/UMLUni.txt for a
+ complete listing of the constant names and their values.
+ </p>
+ </section>
+ </section>
+ <section>
+<title>Sample Code</title>
+ <p>&XERCES_P_NAME; comes with a number of sample applications:
+ </p>
+ <ul>
+ <li><a href="samples/saxcount.html">SAXCount.pl</a>: Uses the SAX interface to
+ output a count of the number of elements in an XML document</li>
+ <li><a href="samples/sax2count.html">SAX2Count.pl</a>: Uses the SAX2 interface
+ to output a count of the number of elements in an XML document</li>
+ <li><a href="samples/domcount.html">DOMCount.pl</a>: Uses the DOM interface to
+ output a count of the number of elements in an XML document</li>
+ <li><a href="samples/domprint.html">DOMPrint.pl</a>: Uses the DOM interface to
+ output a pretty-printed version of an XML file to STDOUT </li>
+ <li><a href="samples/domcreate.html">DOMCreate.pl</a>: Creates a simple XML
+ document using the DOM interface and writes it to STDOUT</li>
+ <li><a href="samples/dom2hash.html">DOM2hash.pl</a>: Uses the DOM interface to
+ convert the file to a simple hash of lists representation</li>
+ <li><a href="samples/enumval.html">EnumVal.pl</a>: Parses and input XML document
+ and outputs the DTD information to STDOUT</li>
+ <li><a href="samples/senumval.html">SEnumVal.pl</a>: Parses and input XML document
+ and outputs the XML Schema information to STDOUT</li>
+ </ul>
+ </section>
+ <section>
+<title>Development Tools</title>
+ <note>These are only for internal &XERCES_P_NAME; development. If
+ your intention is solely to use &XERCES_P_NAME; to write XML
+ applications in Perl, you will <em>NOT</em> need these
+ tools.</note>
+ <section>
+<title>SWIG</title>
+ <p>
+<a href="http://www.swig.org/">
+Simplified Wrapper Interface Generator (SWIG)</a> is an open source
+tool by David Beazley of the University of Chicago for automatically
+generating Perl wrappers for C and C++ libraries (i.e. *.a or *.so for
+UNIX, *.dll for Windoes). You can get the source from <a href="http://www.swig.org/">
+the SWIG home page</a> and then build it for your platform.
+ </p>
+ <p>
+You will only need this if the include Xerces.C and &XERCES_P_NAME;
+files do not work for your perl distribution. The pre-generated files
+have been created by SWIG 1.3 and work under Perl-5.6 or later.
+ </p>
+ <p>
+This port will only work with SWIG 1.3.28 or later.
+ </p>
+ <p>
+If your planning to use SWIG, you can set the environment variable
+SWIG to the full path to the SWIG executable before running <code>perl
+Makefile.pl</code>. For example:
+ </p>
+ <source><![CDATA[
+ export SWIG=/usr/local/bin/swig
+ ]]></source>
+ <p>
+This is only necessary if it isn't in your path or you have more than
+one version installed.
+ </p>
+ </section>
+ </section>
+ <section>
+<title>Acknowledgements</title>
+
+ <p>The Xerces development team would like to provide special
+ acknowledgment to the following companies for their gracious
+ financial support:</p>
+
+ <note label="BBC: XML-Xerces-2.7">
+ The <a href="http://www.bbc.co.uk/">British Broadcasting
+ Corporation</a> provided support for the XML-Xerces-2.7 release
+ that has enabled patching a number of SAX-related Unicode bugs.
+ </note>
+
+ <note label="Cluster Technology: XML-Xerces-2.6">
+ <a href="http://clustertech.com/">Cluster Technology
+ Limited</a> provided support for the XML-Xerces-2.6 release and
+ for invaluable testing to help eliminate the major memory leaks
+ that existed prior to the 2.6 release.
+ </note>
+
+ </section>
+</section>
+
+ </body>
+</document>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/mirrors.html
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/mirrors.html?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/mirrors.html (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/mirrors.html Tue Mar 14 00:45:06 2006
@@ -0,0 +1,144 @@
+<!--
+ Copyright 2001-2005 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!-- Note: To understand how this template is used, see the documentation
+ at http://forrest.apache.org/howto/howto-asf-mirror.html
+-->
+<html>
+ <head>
+ <title>Obtain the Apache Forrest distribution</title>
+ </head>
+ <body>
+<h1><a name="how" />How to download</h1>
+<p class="note">
+Please realise that Forrest is still pre-1.0 release version.
+It is certainly usable for those who are prepared to move with it.
+See more notes about <a href="index.html#status">status</a>.
+</p>
+<p>Use the links below to download a distribution of Apache Forrest from
+one of our mirrors. It is good practice to
+<a href="[location]#verify">verify the integrity</a>
+of the distribution files.</p>
+
+<p>Apache Forrest is distributed as a <code>zip</code> archive (for Windows) and
+as a <code>tar.gz</code> archive (for UNIX). The contents are the same,
+the only difference is the line-endings of all text files.
+</p>
+<p>The distribution contains all of the source code, documentation,
+and resources, together with the pre-built ready-to-run forrest binary.
+</p>
+
+<h1><a name="closest" />Current official release (closest mirror site selected automatically)</h1>
+
+<p>You are currently using <b>[preferred]</b>. If you encounter a
+problem with this mirror, then please select another. If all
+mirrors are failing, there are backup mirrors at the end of the list.
+See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
+</p>
+
+<form action="[location]" method="get" id="SelectMirror">
+Other mirrors: <select name="Preferred">
+<!--[if-any http] [for http]-->
+<option value="[http]">[http]</option>
+<!--[end] [end]-->
+<!--[if-any ftp] [for ftp]-->
+<option value="[ftp]">[ftp]</option>
+<!--[end] [end]-->
+<!--[if-any backup] [for backup]-->
+<option value="[backup]">[backup] (backup)</option>
+<!--[end] [end]-->
+</select>
+<input type="submit" value="Change" />
+</form>
+
+<p>The current release is Apache Forrest 0.7 (see the
+<a href="[preferred]/forrest/RELEASE-NOTES-0.7.txt">release notes</a>).</p>
+
+<ul>
+<li>For UNIX operating systems:
+<a href="[preferred]/forrest/apache-forrest-0.7.tar.gz">apache-forrest-0.7.tar.gz</a>
+[<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.tar.gz.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.tar.gz.md5">MD5</a>]</li>
+
+<li>For Windows operating systems:
+<a href="[preferred]/forrest/apache-forrest-0.7.zip">apache-forrest-0.7.zip</a>
+[<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.zip.asc">PGP</a>]
+[<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.zip.md5">MD5</a>]</li>
+</ul>
+
+<h1><a name="svn" />Snapshots of current development and head SVN repository</h1>
+
+<p>If you want to use the latest Apache Forrest features, the source code is under
+version control with Subversion (read how to
+<a href="site:documentation/developers/build">obtain</a> your working copy). There are
+also compressed source
+<a href="http://svn.apache.org/snapshots/forrest/">snapshots</a> that are
+packed every 6 hours.
+</p>
+
+<h1><a name="archive" />Archive of old releases</h1>
+
+<p>Older releases are available in the <a
+href="http://archive.apache.org/dist/forrest/">archive</a>. Those
+releases are only provided as historical artefacts. We strongly
+recommend to not use those releases, but upgrade to the most recent release.
+</p>
+
+<h1><a name="verify" />Verify releases</h1>
+
+<p>It is essential that you verify the integrity of the downloaded
+files using the PGP and MD5 signatures. MD5 verification ensures the
+file was not corrupted during the download process. PGP verification
+ensures that the file came from a certain person.</p>
+
+<p>The PGP signatures can be verified using
+<a href="http://www.pgpi.org/">PGP</a> or
+<a href="http://www.gnupg.org/">GPG</a>.
+First download the Apache Forrest
+<a href="http://svn.apache.org/repos/asf/forrest/trunk/KEYS">KEYS</a>
+as well as the <code>asc</code> signature file for the particular
+distribution. It is important that you get these files from the ultimate
+trusted source - the main ASF distribution site, rather than from a mirror.
+Then verify the signatures using ...</p>
+
+<pre>
+% pgpk -a KEYS
+% pgpv apache-forrest-X.Y.tar.gz.asc
+
+<em>or</em>
+
+% pgp -ka KEYS
+% pgp apache-forrest-X.Y.tar.gz.asc
+
+<em>or</em>
+
+% gpg --import KEYS
+% gpg --verify apache-forrest-X.Y.tar.gz.asc
+</pre>
+
+<p>To verify the MD5 signature on the files, you need to use a program
+called <code>md5</code> or <code>md5sum</code>, which is
+included in many unix distributions. It is also available as part of
+<a href="http://www.gnu.org/software/textutils/textutils.html">GNU
+Textutils</a>. Windows users can get binary md5 programs from <a
+href="http://www.fourmilab.ch/md5/">here</a>, <a
+href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or
+<a href="http://www.slavasoft.com/fsum/">here</a>.</p>
+
+<p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
+
+</body>
+</html>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/dom2hash.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/dom2hash.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/dom2hash.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/dom2hash.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,72 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: DOM2Hash</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: DOM2Hash</title>
+
+ <section>
+<title>DOM2Hash</title>
+
+ <p> DOM2Hash, illustrates how to traverse a DOM tree in memory
+ and convert that tree to a simple recursive hash table data
+ structure.</p>
+
+ <section>
+<title>Running DOM2Hash</title>
+
+ <p>The DOM2Hash sample illustrates how convert a DOM tree
+ to another format. To run DOM2Hash, enter the following</p>
+<source>perl DOM2Hash.pl <XML file></source>
+ <p>Here is a sample output from DOM2Hash</p>
+<source>perl DOM2Hash.pl roles.xml
+<![CDATA[
+$VAR1 = {
+ 'node_name' => 'contributors',
+ 'children' => [
+ {
+ 'node_name' => 'person',
+ 'attributes' => {
+ 'Role' => 'manager'
+ }
+ }
+ ],
+ 'attributes' => {
+ 'xmlns' => 'contributors'
+ }
+ };
+]]>
+</source>
+
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcount.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcount.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcount.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcount.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,84 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: DOMCount</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: DOMCount</title>
+
+ <section>
+<title>DOMCount</title>
+ <p>DOMCount uses the provided DOM API to parse an XML file,
+ constructs the DOM tree and walks through the tree counting
+ the elements (using just one API call).</p>
+
+ <section>
+<title>Running DOMCount</title>
+
+ <p>The DOMCount sample parses an XML file and prints out a count of the number of
+ elements in the file. To run DOMCount, enter the following </p>
+<source>perl DOMCount.pl <XML file></source>
+ <p>The following parameters may be set from the command line </p>
+<source>
+Usage:
+ perl DOMCount.pl [options] <XML file | List file>
+
+This program invokes the DOM parser, builds the DOM tree,
+and then prints the number of elements found in each XML file.
+
+Options:
+ -l Indicate the input file is a List File that has a list of xml files.
+ Default to off (Input file is an XML file).
+ -v=xxx Validation scheme [always | never | auto*].
+ -n Enable namespace processing. Defaults to off.
+ -s Enable schema processing. Defaults to off.
+<!--
+ -f Enable full schema constraint checking. Defaults to off.
+ -locale=ll_CC specify the locale, default: en_US
+ -p Print out names of elements and attributes encountered.
+-->
+ -h Show this help.
+
+ * = Default if not provided explicitly.
+</source>
+ <p><em>-v=always</em> will force validation<br/>
+ <em>-v=never</em> will not use any validation<br/>
+ <em>-v=auto</em> will validate if a DOCTYPE declaration or a schema declaration is present in the XML document</p>
+ <p>Here is a sample output from DOMCount</p>
+<source>cd samples/data
+perl DOMCount.pl -v=always personal.xml
+personal.xml: 20 ms (37 elems)</source>
+
+ <note>The time reported by the system may be different, depending on your
+ processor type.</note>
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcreate.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcreate.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcreate.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domcreate.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,77 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: DOMCreate</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: DOMCreate</title>
+
+ <section>
+<title>DOMCreate</title>
+
+ <p> DOMCreate, illustrates how you can create a DOM tree in
+ memory from scratch. It then prints the the tree that was just
+ created.</p>
+
+ <section>
+<title>Running DOMCreate</title>
+
+ <p>The DOMCreate sample illustrates how you can create a DOM tree
+ in memory from scratch. To run DOMCreate, enter the following</p>
+<source>perl DOMCreate.pl</source>
+ <p>Here is a sample output from DOMCreate</p>
+<source>perl DOMCreate.pl
+<![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
+<!DOCTYPE contributors SYSTEM "contributors.dtd">
+<contributors xmlns="contributors">
+
+ <person Role="manager">
+ <name>Mike Pogue</name>
+ <email>mpogue@us.ibm.com</email>
+ </person>
+
+ <person Role="developer">
+ <name>Tom Watson</name>
+ <email>rtwatson@us.ibm.com</email>
+ </person>
+
+ <person Role="tech writer">
+ <name>Susan Hardenbrook</name>
+ <email>susanhar@us.ibm.com</email>
+ </person>
+
+</contributors>
+]]>
+</source>
+
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xerces.apache.org
For additional commands, e-mail: commits-help@xerces.apache.org