Return-Path: <wwwrun@vipserver.vipsurf.de>
Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm
Delivered-To: mailing list cocoon-dev@xml.apache.org
Received: (qmail 38200 invoked from network); 3 Jan 2000 07:51:32 -0000
Received: from vipserver.vipsurf.de (root@195.127.252.133)
  by 63.211.145.10 with SMTP; 3 Jan 2000 07:51:32 -0000
Received: (from wwwrun@localhost)
	by vipserver.vipsurf.de (8.9.3/8.9.3) id IAA20190;
	Mon, 3 Jan 2000 08:50:54 +0100
Date: Mon, 3 Jan 2000 08:50:54 +0100
Message-Id: <200001030750.IAA20190@vipserver.vipsurf.de>
To: cocoon-dev@xml.apache.org
Subject: Improvements
From: apfarr@vipsurf.de

Hi,

looking at Cocoon for the first time, I have to tell you that this is really a remarkable piece of software! Congratulations!

There are only a few minor problems you should fix:

1.
the document-v10.dtd you are using for documentation sets the section titles in attributes (e.g. <s1 title="anytitle">. That generates problems if you want to use entity-references in titles, what is often the case in non-english languages. It would be better to have the title as a required element of the section. If you are using a XML-Editor (e.g. SoftQuad XMetaL, ArborText Adept) that is also much handier for editing.  

2. The build with ant works fine. The only thing I can't generate is the javadoc-Docu. The routine is called, but doesn't do anything. Any idea?
(it tells me: 
javadoc executing 
Completed in 1 seconds)

3.
Cocoon doesn't resolve relative Entity-declarations, when the DTD-reference is relative
e.g.
XML-File
<?xml version="1.0"?>
<?DOCTYPE test SYSTEM "dtds/doctypes/test.dtd">
....

DTD-File (test.dtd)
<!ENTITY % HTMLlat1 PUBLIC
   "-//W3C//ENTITIES Latin 1 for XHTML//EN"
   "../../Entities/xhtml-lat1.ent">
%HTMLlat1;

I haven't looked at the code yet, but usually this error occurs, when you don't set the System-ID of the SAX-Inputstream. Take a look at your producer code, that's where I would try to locate it.

4.
The Output-Transformer swallows Entities. If you are using the same XML-File and Stylesheet that produces correct results with Xalan command-line, the output of Cocoon swallows the Entities. This seems to be a problem with the formatter-code. I've read, that Xerces has a configuration flag "http://apache.org/xml/features/dom/create-entity-ref-nodes" that enables different entity-reference procesing. This might be the root of all evil.

Armin Pfarr
apfarr@vipsurf.de