i like Ant javadoc as a follow-up task for javac ..(part of the build process)
you create the package/class
javadoc task will automatically create 'linted html'
ANTS javadoc also has ability to read css stylesheet so you can
bold method explanations
italicise annotations

http://ant.apache.org/manual/CoreTasks/javadoc.html

prob the only thing ant javadoc wont do is translate to german,swedish,french..

you would also need to add in examples..

another format would be pdf which would easily be accomplished thru FOP

Martin Gainty 
______________________________________________ 
Verzicht und Vertraulichkeitanmerkung/Note de déni et de confidentialité
 
Diese Nachricht ist vertraulich. Sollten Sie nicht der vorgesehene Empfaenger 
sein, so bitten wir hoeflich um eine Mitteilung. Jede unbefugte Weiterleitung 
oder Fertigung einer Kopie ist unzulaessig. Diese Nachricht dient lediglich dem 
Austausch von Informationen und entfaltet keine rechtliche Bindungswirkung. 
Aufgrund der leichten Manipulierbarkeit von E-Mails koennen wir keine Haftung 
fuer den Inhalt uebernehmen.
Ce message est confidentiel et peut être privilégié. Si vous n'êtes pas le 
destinataire prévu, nous te demandons avec bonté que pour satisfaire informez 
l'expéditeur. N'importe quelle diffusion non autorisée ou la copie de ceci est 
interdite. Ce message sert à l'information seulement et n'aura pas n'importe 
quel effet légalement obligatoire. Étant donné que les email peuvent facilement 
être sujets à la manipulation, nous ne pouvons accepter aucune responsabilité 
pour le contenu fourni.




> Date: Mon, 3 Aug 2009 08:52:27 -0600
> From: devli...@hanik.com
> To: users@tomcat.apache.org
> Subject: Re: Tribes
> 
> I will work on better docs, in the mean time, quick start is here
> 
> http://tomcat.apache.org/tomcat-6.0-doc/tribes/introduction.html
> 
> 
> On 08/03/2009 06:02 AM, nash4403X wrote:
> > Filip-  Needless to say a product is as good as its documentation.
> >
> > I wanted to try tribes but without proper docs/articles and my limited
> > knowledge it's tough and make me look at other options. All I wanted to do
> > is messaging with help of tribes in between 5 tomcat instances.
> > I wanted to have some code in my startup to instantiate the channel and when
> > required all instances should receive or send messages to one another.
> >
> > Can you do the write up of an article on how to do this?
> >
> > I understand your valuable time and I volunteer to do an article on tribes
> > for messaging but only if I understand? Can you help please?
> >
> >
> >
> > Filip Hanik - Dev Lists wrote:
> >    
> >> that is cause *one* of my flaws as a developer is that I'm not very good
> >> at writing and maintaining docs
> >> there is a bit more here
> >> http://tomcat.apache.org/tomcat-6.0-doc/config/cluster-channel.html
> >>
> >> the rest is in the code of the library, which isn't that big.
> >> if you have any specific questions let me know
> >>
> >> Filip
> >>
> >> Jorge Medina wrote:
> >>      
> >>> Is there a way to get more documentation on the Tribes package ?
> >>> I would like to reuse the dynamic membership discovery feature of
> >>> Tribes, but many of the links are not working on the page
> >>> http://tomcat.apache.org/tomcat-6.0-doc/tribes/introduction.html
> >>>
> >>> Thanks
> >>>
> >>> -Jorge
> >>>
> >>>
> >>>        
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: users-unsubscr...@tomcat.apache.org
> >> For additional commands, e-mail: users-h...@tomcat.apache.org
> >>
> >>
> >>
> >>      
> >
> >    
> 

_________________________________________________________________
Get your vacation photos on your phone!
http://windowsliveformobile.com/en-us/photos/default.aspx?&OCID=0809TL-HM

Reply via email to