Upgrading to Apache Forrest 0.9-dev

This is documentation for development version v0.9-dev (More)

Introduction
Missing project symbols file in some projects

Introduction

Note

This is the development version of Apache Forrest. Developers can obtain it from the Subversion repository. See the notes for obtaining and Building Forrest.

This is a placeholder document for the new version.

Missing project symbols file in some projects

Users of 0.8, and developers with older 0.9-dev, who based their sites on 'forrest seed-basic' rather than 'forrest seed-sample' will be affected by FOR-1075. There was a partially implemented xml catalog with missing symbols file.

You would get the message:

Failed to create InputSource (java.io.FileNotFoundException:
.../src/documentation/resources/schema/symbols-project-v10.ent
(No such file or directory)...

This is just a warning message from the misconfigured xml entity catalog. To silence it, simply copy the file from a new "seed-basic" site, or more directly by cp $FORREST_HOME/main/fresh-site/src/documentation/resources/schema/symbols-project-v10.ent $PROJECT/src/documentation/resources/schema/symbols-project-v10.ent

This "project symbols" ability using xml entities is useful in two ways. To provide commons symbols, words, and phrases, in your source documents (added in v0.8 - FAQ). To configure some Cocoon sitemap components (added in v0.9 - FAQ).