Re: Doxygen Code Documentation

2015-08-31 Thread Derek Atkins
Hi, Matt Graham writes: > G’day all! > > > Whilst there is lot of enthusiasm about documentation flowing around, > I thought I’d ask a general question regarding the last type of > documentation not previously mentioned: The doxygen generated > documentation about

Re: Doxygen Code Documentation

2015-08-31 Thread Derek Atkins
John Ralls writes: > Some programmers, often less-experienced ones, will comment code > liberally to explain what they’re doing. More experienced programmers > often find this irritating because they’re fluent enough in the > programming language that they can understand the

Re: Replacing Docbook

2015-08-31 Thread Mike Evans
On Sat, 29 Aug 2015 16:52:48 +0200 Geert Janssens wrote: > On Saturday 29 August 2015 06:38:53 John Ralls wrote: > > > On Aug 29, 2015, at 5:43 AM, Mike Evans > > > wrote: > > > > > > Another random thought then. > > > > > > I use asciidoc for

Doxygen Code Documentation

2015-08-31 Thread Matt Graham
G’day all! Whilst there is lot of enthusiasm about documentation flowing around, I thought I’d ask a general question regarding the last type of documentation not previously mentioned: The doxygen generated documentation about how the code works (can I call it the API?). I’ve been taking

Re: Doxygen Code Documentation

2015-08-31 Thread John Ralls
> On Aug 31, 2015, at 3:44 AM, Matt Graham wrote: > > G’day all! > > > Whilst there is lot of enthusiasm about documentation flowing around, I > thought I’d ask a general question regarding the last type of documentation > not previously mentioned: The doxygen