patch applied, please check that everyting works well.
On Mon, Sep 03, 2001 at 09:33:54PM +1000, David Crossley wrote:
> Please find two attached patches for entity catalogs.
> - raise default verbosity level to 2
> - explain messages at each verbosity level
> - explain how to extend the default properties to suit local needs
> - show example local configuration for Simplified DocBook
> and full DocBook DTDs
> - list of platforms with reports of successful usage
> regards, David Crossley
> Index: CatalogManager.properties
> RCS file: /home/cvspublic/xml-cocoon2/webapp/resources/entities/CatalogManager.properties,v
> retrieving revision 1.3
> diff -u -r1.3 CatalogManager.properties
> --- CatalogManager.properties 2001/08/31 11:44:13 1.3
> +++ CatalogManager.properties 2001/09/03 10:59:11
> @@ -7,18 +7,23 @@
> # available to the Java classpath and to automatically adjust the
> # "catalogs" pathname to suit your local directory structure.
> -# verbosity ... level of messages for status/debug
> -# messages go to STDOUT
> +# verbosity ... level of messages for status/debug (messages go to STDOUT)
> # 0 (none) .. 3 (maximum)
> +# The following messages are provided ...
> +# 0 = none
> +# 1 = ?
> +# 2 = 1+, Loading catalog, Resolved public, Resolved system
> +# 3 = 2+, Catalog does not exist, resolvePublic, resolveSystem
> +# TODO cocoon-dev: determine all messages at each level
> # catalogs ... list of initial catalogs to load
> # use full pathnames
> # pathname separator is always semi-colon (;) regardless of operating system
> # directory separator is always slash (/) regardless of operating system
> # prefer ... we prefer to use Public Identifiers for entity resolution
> Index: catalog.xml
> RCS file: /home/cvspublic/xml-cocoon2/xdocs/catalog.xml,v
> retrieving revision 1.2
> diff -u -r1.2 catalog.xml
> --- catalog.xml 2001/08/31 11:44:13 1.2
> +++ catalog.xml 2001/09/03 10:59:56
> @@ -5,9 +5,8 @@
> The SAX
Parser interface provides an
> hook to allow an application to resolve the external entities. The Sun
> @@ -356,10 +362,7 @@
CatalogManager.propertiesfile is > included with the distribution (see the Build Notes below). >
catalogsentry in the default properties file > - (see notes inside the properties file). > -
> + If you suspect problems, then you can raise the level of the
verbosity property (to 2 or 3) and watch the messages going
> + to stdout when @docname@ starts and operates. You would also do this to
> + detect any misconfiguration of your own catalogs.
> Use the following options to your build command ... > @@ -385,14 +395,81 @@ >> >
> - If you see messages going to STDOUT when @docname@ starts
> + If you see an error message going to STDOUT when @docname@ starts
Cannot find CatalogManager.properties) then this means that
> the properties file is not available to the Java classpath. Please ensure
> - that you build as described above.
> + that you build as described above, or edit and move the properties file
> + into place manually.
> + You can add your own catalog by appending another full pathname to
> + the
catalogs property in the default properties file
> + (see notes inside the properties file).
> + The actual "catalog" files have a powerful set of directives. > + For example, the CATALOG directive facilitates the > + inclusion of a sub-ordinate catalog. The list of resources below will > + lead to further information about catalog usage. > +> + > +
> + We use the Simplified DocBook XML DTD for some of our documentation. > + Here are the few steps that we followed to configure @docname@ to be able > + to process our XML instances. > +> + > +
/usr/local/sgml/docbook/simple/sdocbook.cat> + with a single entry for the Simplified DocBook XML DTD > +
catalogsproperty in the > +
CatalogManager.propertiesfile > +
> + We could similarly configure @docname@ for the full DocBook XML DTD and
> + related entities. In fact, the DocBook distribution already contains a
> + catalog file. We need only append the pathname to our
> + property.
> + There are a few important starting points for > + further information about using and configuring > + the DocBook DTDs. > +> + > +
org.apache.cocoon.components.resolverclasses > + automatically load the default catalog, thereby leaving the > +
propertiesconfig file totally free for local use. >
> @@ -438,29 +518,6 @@ > > > > -
> - Some relevant past discussion on @docname@ mailing lists ... > -> - > -