Re: Reference Doc From Java Sources [Was Check Source]

2002-01-31 Thread Stefano Mazzocchi
Sylvain Wallez wrote: > > Stefano Mazzocchi wrote: > > > > >I'm going to spend some time taking a good look at your doclet today > >and to the other doclet implementations available. > > > Do you know xdoclet at http://xdoclet.sourceforge.net/ ? I just took a look at it (along with the DBDocl

Re: Reference Doc From Java Sources [Was Check Source]

2002-01-31 Thread Sylvain Wallez
Stefano Mazzocchi wrote: >I'm going to spend some time taking a good look at your doclet today >and to the other doclet implementations available. > Do you know xdoclet at http://xdoclet.sourceforge.net/ ? Sylvain -- Sylvain Wallez Anyware Technologies - http://www.anyware-tech.com -

Re: Reference Doc From Java Sources [Was Check Source]

2002-01-31 Thread Stefano Mazzocchi
Bernhard Huber wrote: > >But the fact that we use javadocs syntax and javadoc tools might be > >wrong! > > > >Now, I see two possible syntaxes: > > > >1) turn javadoc tag into namespaced ones (might becoming a black art) > > > > > >2) write our own 'special-comment' with nested XML documentation

Re: Reference Doc From Java Sources [Was Check Source]

2002-01-30 Thread Bernhard Huber
Hi, > >*this* is what we need: the ability to write our documentation with the >code and the ability to factor it out and aggregate it coherently with >our own. > yep. > > >But the fact that we use javadocs syntax and javadoc tools might be >wrong! > >Now, I see two possible syntaxes: > >1) turn

Re: Reference Doc From Java Sources [Was Check Source]

2002-01-30 Thread Stefano Mazzocchi
Bernhard Huber wrote: > > Hi, > > > > >What about coming out with a more-or-less standard extention to the > >javadoc system and provide namespaces? for example: > > > > /** > > * This is my comment. > > * > > * @namespace:cocoon http://apache.org/cocoon/2.0/ > > * @cocoon:deprecated no > >

Re: Reference Doc From Java Sources [Was Check Source]

2002-01-29 Thread Bernhard Huber
Hi, > >What about coming out with a more-or-less standard extention to the >javadoc system and provide namespaces? for example: > > /** > * This is my comment. > * > * @namespace:cocoon http://apache.org/cocoon/2.0/ > * @cocoon:deprecated no > * @namespace:xsp http://apache.org/xsp/1.0/ > *

Re: Reference Doc From Java Sources [Was Check Source]

2002-01-29 Thread Stefano Mazzocchi
Bernhard Huber wrote: > > Hi, > > as noted by david there were some js problems, i removed the js refs > from the sample pages, > so a second try trigger some discussion about more accurate reference > documentation. > > I try to summarize what I have done, i make a distro available under > htt

Reference Doc From Java Sources [Was Check Source]

2002-01-28 Thread Bernhard Huber
Hi, as noted by david there were some js problems, i removed the js refs from the sample pages, so a second try trigger some discussion about more accurate reference documentation. I try to summarize what I have done, i make a distro available under http://members.a1.net/berni_huber/ref-docs/i