Taglib of util request, reponse, etc.

[LEBRETON Philippe <ph...@cti-paysloire.cnamts.fr>]

I can't found the documentation of the taglib request, response, util
etc.

The Util Taglib don't work wiht my taglib.xml file :
I want get the date of day and request the database with this value.

Help me
Thanks

Re: Taglib of util request, reponse, etc.

[Echoes <ec...@free.fr>]

Uli Mayring wrote:
> 
> On Thu, 12 Oct 2000, Echoes wrote:
> 
> > > > I can't found the documentation of the taglib request, response, util
> > > > etc.
> > >
> > > Look in {$COCOON_HOME}/src/org/apache/cocoon/processor/xsp/library/java
> >
> >  I'm sory but I think it's a bad answer. Source code is *not*
> > documentation
> > for the user. It can be documentation for another developer.
> 
> Two things:
> 
> 1.) It's a good answer, because this is the only documentation available.

 ;-( There should be user doc.

> 2.) Anyone wanting to use the Servlet API should be considered a
> developer.

 Yes. But not a cocoon developer. I just want to think about my app
internals.
 
> >  I know writing docs consumes lots of time, but it's a good way to have
> > more and more people using these tools. If you produce no docs, you're
> > doomed as a public project.
> 
> I agree. But I think cocoon has enough users by now - this project's
> survival is not questionable anymore, at least not due to lack of interest
> from users. What the project needs is more developers, users are plenty :)

 I hope it won't fail, 'cause i'm benning a fairly large project with
it...
And cocoon needs technical writers.

 Regards

	Eugene

Re: Taglib of util request, reponse, etc.

[Uli Mayring <ul...@denic.de>]

On Thu, 12 Oct 2000, Echoes wrote:

> > > I can't found the documentation of the taglib request, response, util
> > > etc.
> >
> > Look in {$COCOON_HOME}/src/org/apache/cocoon/processor/xsp/library/java
> 
>  I'm sory but I think it's a bad answer. Source code is *not*
> documentation
> for the user. It can be documentation for another developer.

Two things:

1.) It's a good answer, because this is the only documentation available.
2.) Anyone wanting to use the Servlet API should be considered a
developer.

>  I know writing docs consumes lots of time, but it's a good way to have
> more and more people using these tools. If you produce no docs, you're
> doomed as a public project.

I agree. But I think cocoon has enough users by now - this project's
survival is not questionable anymore, at least not due to lack of interest
from users. What the project needs is more developers, users are plenty :)

Ulrich

-- 
Ulrich Mayring
DENIC eG, Softwareentwicklung

Re: Taglib of util request, reponse, etc.

["Pier P. Fumagalli" <pi...@betaversion.org>]

Donald Ball <ba...@webslingerZ.com> wrote:

> On Thu, 12 Oct 2000, Echoes wrote:
> 
>>> fwiw, i've marked up at least one of my logicsheets using xspdoc elements,
>>> but i have had no luck integrating it into the stylebook documentation
>>> build procedure. if someone can help me do that, i'll mark up other
>>> logicsheets using xspdoc.
>> 
>> It sounds interesting, but what is xspdoc ? (Is there a doc on this
>> somewhere ;-) ? )
> 
> documentation on documentation? surely you jest. if you search for xspdoc
> or "xsp doc" in the mailing list archives, you might find an older thread
> about it. basically, i came up with in idea for embedding comments in a
> logicsheet by putting them in a seperate namespace. you can sort of see it
> in action by running
> 
> java org.apache.xalan.xslt.Process
> -in ./src/org/apache/cocoon/processor/xsp/library/sql/esql.xsl
> -xsl ./skins/xml.apache.org/stylesheets/xspdoc2document.xsl
> 
> the result of that needs to be transformed by document2html.xsl before
> it's HTML tho. anyway, i can't figure out how to put this into the build
> docs procedure for cocoon. help is welcome (i've copied pier on this in
> case he has any helpful suggestions).

dunno anything about ant and its integration w/ stylebook...
sorry... :(

    pier

Re: Taglib of util request, reponse, etc.

[Donald Ball <ba...@webslingerZ.com>]

On Thu, 12 Oct 2000, Echoes wrote:

> > fwiw, i've marked up at least one of my logicsheets using xspdoc elements,
> > but i have had no luck integrating it into the stylebook documentation
> > build procedure. if someone can help me do that, i'll mark up other
> > logicsheets using xspdoc.
> 
>  It sounds interesting, but what is xspdoc ? (Is there a doc on this
> somewhere ;-) ? )

documentation on documentation? surely you jest. if you search for xspdoc
or "xsp doc" in the mailing list archives, you might find an older thread
about it. basically, i came up with in idea for embedding comments in a
logicsheet by putting them in a seperate namespace. you can sort of see it
in action by running

java org.apache.xalan.xslt.Process
 -in ./src/org/apache/cocoon/processor/xsp/library/sql/esql.xsl
 -xsl ./skins/xml.apache.org/stylesheets/xspdoc2document.xsl 

the result of that needs to be transformed by document2html.xsl before
it's HTML tho. anyway, i can't figure out how to put this into the build
docs procedure for cocoon. help is welcome (i've copied pier on this in
case he has any helpful suggestions).

- donald

Re: Taglib of util request, reponse, etc.

[Echoes <ec...@free.fr>]

Donald Ball wrote:
> 
> >  I'm sory but I think it's a bad answer. Source code is *not*
> > documentation
> > for the user. It can be documentation for another developer.
> >  I know writing docs consumes lots of time, but it's a good way to have
> > more and more people using these tools. If you produce no docs, you're
> > doomed as a public project.
> 
> i concur. are you volunteering? :)

 If i became familiar enough with cocoon internals, why not. But this is
not my top priority.

> fwiw, i've marked up at least one of my logicsheets using xspdoc elements,
> but i have had no luck integrating it into the stylebook documentation
> build procedure. if someone can help me do that, i'll mark up other
> logicsheets using xspdoc.

 It sounds interesting, but what is xspdoc ? (Is there a doc on this
somewhere ;-) ? )

	Eugene

Re: Taglib of util request, reponse, etc.

[Donald Ball <ba...@webslingerZ.com>]

On Thu, 12 Oct 2000, Echoes wrote:

> Ulrich Mayring wrote:
> > 
> > LEBRETON Philippe wrote:
> > >
> > > I can't found the documentation of the taglib request, response, util
> > > etc.
> > 
> > Look in {$COCOON_HOME}/src/org/apache/cocoon/processor/xsp/library/java
> 
>  I'm sory but I think it's a bad answer. Source code is *not*
> documentation
> for the user. It can be documentation for another developer.
>  I know writing docs consumes lots of time, but it's a good way to have
> more and more people using these tools. If you produce no docs, you're
> doomed as a public project.

i concur. are you volunteering? :)

fwiw, i've marked up at least one of my logicsheets using xspdoc elements,
but i have had no luck integrating it into the stylebook documentation
build procedure. if someone can help me do that, i'll mark up other
logicsheets using xspdoc.

- donald

Re: Taglib of util request, reponse, etc.

[Echoes <ec...@free.fr>]

Ulrich Mayring wrote:
> 
> LEBRETON Philippe wrote:
> >
> > I can't found the documentation of the taglib request, response, util
> > etc.
> 
> Look in {$COCOON_HOME}/src/org/apache/cocoon/processor/xsp/library/java

 I'm sory but I think it's a bad answer. Source code is *not*
documentation
for the user. It can be documentation for another developer.
 I know writing docs consumes lots of time, but it's a good way to have
more and more people using these tools. If you produce no docs, you're
doomed as a public project.

 Just my 2 cents.

	Eugene

Re: Taglib of util request, reponse, etc.

[Ulrich Mayring <ul...@denic.de>]

LEBRETON Philippe wrote:
> 
> I can't found the documentation of the taglib request, response, util
> etc.

Look in {$COCOON_HOME}/src/org/apache/cocoon/processor/xsp/library/java

Ulrich

-- 
Ulrich Mayring
DENIC eG, Systementwicklung