Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm
Date: Wed, 26 Jul 2000 09:02:19 -0400 (EDT)
From: Kevin Sonney <kevin@webslingerz.com>
To: cocoon-dev@xml.apache.org
Cc: matt@sergeant.org
Subject: Re: idea for documenting xsp logicsheets
In-Reply-To: <Pine.LNX.4.21.0007260357070.864-100000@localhost.localdomain>
Message-ID: <Pine.LNX.4.21.0007260859130.1224-100000@snorlax2.webslingerz.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII

On Wed, 26 Jul 2000, Donald Ball wrote:
> assuming we could configure the xsp processor to ignore the xspdoc
> elements (either by stripping them when doing the XSLT transform or adding
> "strip xspdoc elements" rules to the xsp to java stylesheet), all we'd
> need to generate concise docs is a simple stylesheet like this:

Why strip them? I would rather somrthing like :

<xspdoc:desc>Here's the JDBC Driver</xspdoc:desc>

be placed in the java code as a *REAL* comment :

/* Here's the JDBC Driver */

This would make it a little more debug freindly when I'm gutting the
auto-generated java files tracking down an error.

> obviously we could elaborate a bit on the elements and attributes of the
> xspdoc namespace, but that's the gist. any thoughts from other logicsheet
> authors? worthwhile to pursue?

+1 from this end. I'd also make things a bit more client freindly, when I
hand projects off to their final maintainers.

-- 
- Kevin Sonney
  kevin@webslingerZ.com