Re: [fpc-devel] convert comment help to fpcdoc

2011-07-19 Thread Michalis Kamburelis
2011/7/17 Sven Barth : > On 17.07.2011 08:08, Felipe Monteiro de Carvalho wrote: >> >> Since we are talking about help stuff, (in another thread) >> >> Do we have any tool to convert documentation written in javadoc style >> (those comments in the source code) to fpdoc xml? I like to write my >> do

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-19 Thread Marco van de Voort
In our previous episode, Wimpie Nortje said: > > > Are you aware of NaturalDocs (www.naturaldocs.org)? > > I use it because it doesn't clutter up the source code with unreadable > javadoc tags. The comments are naturally formatted. They seem to be just > normal comments if you are not aware that

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-18 Thread Wimpie Nortje
On 2011/07/18 12:00 PM, Marco van de Voort wrote: No, it is more wiki like tags in an XML format. But that is out of source docs, what is currently most prefered by the documentation author. (and I like it more to) Are you aware of NaturalDocs (www.naturaldocs.org)? I use it because it doesn

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-18 Thread Marco van de Voort
In our previous episode, Michael Schnell said: > > Do we have any tool to convert documentation written in javadoc style > > (those comments in the source code) to fpdoc xml? I like to write my > > documentation as comments... > As several different help formats are used and can be created from the

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-18 Thread Michael Schnell
On 07/17/2011 08:08 AM, Felipe Monteiro de Carvalho wrote: Since we are talking about help stuff, (in another thread) Do we have any tool to convert documentation written in javadoc style (those comments in the source code) to fpdoc xml? I like to write my documentation as comments... As several

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-17 Thread Graeme Geldenhuys
On 17 July 2011 12:38, Michael Van Canneyt wrote: > > The entire purpose of fpdoc is not to have the documentation clutter up the > sources. Especially true if you start adding images or diagrams (graphs, UML, screenshots etc) inside your documentation too. Documentation belongs outside the sourc

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-17 Thread Graeme Geldenhuys
On 17 July 2011 12:28, Hans-Peter Diettrich wrote: > > I've been working on PasDoc for a while (PasDoc2), and ended up in adding > documentation in external files. But inline documentation makes sense in the > implementation section, which is not handled by PasDoc. The tiOPF had all its document

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-17 Thread Michael Van Canneyt
On Sun, 17 Jul 2011, Felipe Monteiro de Carvalho wrote: Since we are talking about help stuff, (in another thread) Do we have any tool to convert documentation written in javadoc style (those comments in the source code) to fpdoc xml? I like to write my documentation as comments... There is

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-17 Thread Hans-Peter Diettrich
Felipe Monteiro de Carvalho schrieb: Since we are talking about help stuff, (in another thread) Do we have any tool to convert documentation written in javadoc style (those comments in the source code) to fpdoc xml? I like to write my documentation as comments... I've been working on PasDoc fo

Re: [fpc-devel] convert comment help to fpcdoc

2011-07-17 Thread Sven Barth
On 17.07.2011 08:08, Felipe Monteiro de Carvalho wrote: Since we are talking about help stuff, (in another thread) Do we have any tool to convert documentation written in javadoc style (those comments in the source code) to fpdoc xml? I like to write my documentation as comments... I don't kno