You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@struts.apache.org by Jorge Mascena <jo...@cesar.org.br> on 2003/04/01 15:33:39 UTC
[OT] Is there a taglib documentation generator (Javadoc-like)?
How are the taglibs' api references generated? I believe there must be
some sort of documentation generator, like javadoc, but I can't seem to
find it out.
Jorge Mascena
---------------------------------------------------------------------
To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: struts-user-help@jakarta.apache.org
Re: [OT] Is there a taglib documentation generator (Javadoc-like)?
Posted by James Mitchell <jm...@apache.org>.
I would just copy the relevant files and targets from the build.xml and
replicate it for your build.
Open the build.xml (from the source distribution) and take a look at
'compile.library' target and also the 'compile.website' target.
Just copy and change what you need.
--
James Mitchell
Software Developer/Struts Evangelist
http://www.open-tools.org
----- Original Message -----
From: "Jorge Mascena" <jo...@cesar.org.br>
To: "'Struts Users Mailing List'" <st...@jakarta.apache.org>
Sent: Tuesday, April 01, 2003 2:15 PM
Subject: RES: [OT] Is there a taglib documentation generator (Javadoc-like)?
> Could I get some references on how to do that? I would need to know the
> step-by-step to achieve a documentation similar to the struts taglibs'
> documentation.
>
> I'm developing a taglib and want my documentation to follow the struts
> standards.
>
> Thanks in advance and sorry for the inconvenience.
>
> Jorge Mascena
>
> > -----Mensagem original-----
> > De: James Mitchell [mailto:jmitchell@apache.org]
> > Enviada em: Tuesday, April 01, 2003 10:53 AM
> > Para: Struts Users Mailing List
> > Assunto: Re: [OT] Is there a taglib documentation generator
> > (Javadoc-like)?
> >
> >
> > On Tue, 2003-04-01 at 08:33, Jorge Mascena wrote:
> > > How are the taglibs' api references generated? I believe
> > there must be
> > > some sort of documentation generator, like javadoc, but I
> > can't seem
> > > to find it out.
> >
> > The taglib documentation is generated as part of the site documentaion
> > (userguide/faq/etc) from stylesheets (xsl) from the source
> > (xml) files.
> > Those same files are also what is used to generate the .tld
> > files for deployment. So, basically, we keep the taglib
> > descriptors with the documentation.
> >
> > There was a recent addition to the contrib section which
> > (when configured to build) will generate a javadoc-like view
> > of the taglibs.
> > It also generates a grid view (matrix) of tags and their
> > attributes by package (shortname). Very handy!!
> >
> >
> > >
> > > Jorge Mascena
> > >
> > >
> > >
> > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
> > > For additional commands, e-mail: struts-user-help@jakarta.apache.org
> > --
> > James Mitchell
> > Software Developer/Struts Evangelist
> > http://www.open-tools.org
> >
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: struts-user-help@jakarta.apache.org
> >
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: struts-user-help@jakarta.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: struts-user-help@jakarta.apache.org
RES: [OT] Is there a taglib documentation generator (Javadoc-like)?
Posted by Jorge Mascena <jo...@cesar.org.br>.
Could I get some references on how to do that? I would need to know the
step-by-step to achieve a documentation similar to the struts taglibs'
documentation.
I'm developing a taglib and want my documentation to follow the struts
standards.
Thanks in advance and sorry for the inconvenience.
Jorge Mascena
> -----Mensagem original-----
> De: James Mitchell [mailto:jmitchell@apache.org]
> Enviada em: Tuesday, April 01, 2003 10:53 AM
> Para: Struts Users Mailing List
> Assunto: Re: [OT] Is there a taglib documentation generator
> (Javadoc-like)?
>
>
> On Tue, 2003-04-01 at 08:33, Jorge Mascena wrote:
> > How are the taglibs' api references generated? I believe
> there must be
> > some sort of documentation generator, like javadoc, but I
> can't seem
> > to find it out.
>
> The taglib documentation is generated as part of the site documentaion
> (userguide/faq/etc) from stylesheets (xsl) from the source
> (xml) files.
> Those same files are also what is used to generate the .tld
> files for deployment. So, basically, we keep the taglib
> descriptors with the documentation.
>
> There was a recent addition to the contrib section which
> (when configured to build) will generate a javadoc-like view
> of the taglibs.
> It also generates a grid view (matrix) of tags and their
> attributes by package (shortname). Very handy!!
>
>
> >
> > Jorge Mascena
> >
> >
> >
> ---------------------------------------------------------------------
> > To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: struts-user-help@jakarta.apache.org
> --
> James Mitchell
> Software Developer/Struts Evangelist
> http://www.open-tools.org
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: struts-user-help@jakarta.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: struts-user-help@jakarta.apache.org
Re: [OT] Is there a taglib documentation generator (Javadoc-like)?
Posted by James Mitchell <jm...@apache.org>.
On Tue, 2003-04-01 at 08:33, Jorge Mascena wrote:
> How are the taglibs' api references generated? I believe there must be
> some sort of documentation generator, like javadoc, but I can't seem to
> find it out.
The taglib documentation is generated as part of the site documentaion
(userguide/faq/etc) from stylesheets (xsl) from the source (xml) files.
Those same files are also what is used to generate the .tld files for
deployment. So, basically, we keep the taglib descriptors with the
documentation.
There was a recent addition to the contrib section which (when
configured to build) will generate a javadoc-like view of the taglibs.
It also generates a grid view (matrix) of tags and their attributes by
package (shortname). Very handy!!
>
> Jorge Mascena
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: struts-user-help@jakarta.apache.org
--
James Mitchell
Software Developer/Struts Evangelist
http://www.open-tools.org
---------------------------------------------------------------------
To unsubscribe, e-mail: struts-user-unsubscribe@jakarta.apache.org
For additional commands, e-mail: struts-user-help@jakarta.apache.org