Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.c > #93159

Re: Doxygen

From Randy Howard <rhoward.mx@EverybodyUsesIt.com>
Newsgroups comp.lang.c
Subject Re: Doxygen
Date 2016-09-03 13:43 -0500
Organization Aioe.org NNTP Server
Message-ID <nqf5l7$dvb$1@gioia.aioe.org> (permalink)
References <e4f25064-cfc4-44e9-a762-d9c5905b6fd2@googlegroups.com>

Show all headers | View raw


On 9/3/16 6:13 AM, Malcolm McLean wrote:
> I've been experimenting with Doxygen.
>
> It's produced a nice doc for my binary image library
>
> http://malcolmmclean.github.io/binaryimagelibrary/
>
> Anyone else had any good or bad experiences with it?
>

It's rather amazing just how poor Doxygen is, given that is
often portrayed as the best of such tools.

It's a difficult thing to automate docs in such a way that
produces good results, stays current and correct with code
changes, and doesn't make the source look horrific.

Unfortunately, doxygen doesn't really address any of those
desires well. That said, nothing else does either, except
manual labor. It's a real problem, and one that doesn't seem
to interest people enough to do well.




-- 
Randy Howard
(replace the obvious text in the obvious way if you wish to contact me 
directly)

Back to comp.lang.c | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


Thread

Doxygen Malcolm McLean <malcolm.mclean5@btinternet.com> - 2016-09-03 04:13 -0700
  Re: Doxygen Richard Heathfield <rjh@cpax.org.uk> - 2016-09-03 15:51 +0100
    Re: Doxygen David Brown <david.brown@hesbynett.no> - 2016-09-03 18:25 +0200
  Re: Doxygen Randy Howard <rhoward.mx@EverybodyUsesIt.com> - 2016-09-03 13:43 -0500
    Re: Doxygen Ian Collins <ian-news@hotmail.com> - 2016-09-04 08:34 +1200
      Re: Doxygen Malcolm McLean <malcolm.mclean5@btinternet.com> - 2016-09-03 18:10 -0700
        Re: Doxygen Ian Collins <ian-news@hotmail.com> - 2016-09-04 13:41 +1200
        Re: Doxygen Gareth Owen <gwowen@gmail.com> - 2016-09-04 09:05 +0100
      Re: Doxygen Tim Rentsch <txr@alumni.caltech.edu> - 2016-09-04 14:39 -0700
  Re: Doxygen jacobnavia <jacob@jacob.remcomp.fr> - 2016-09-05 00:25 +0200
    Re: Doxygen Gareth Owen <gwowen@gmail.com> - 2016-09-05 06:28 +0100
      Re: Doxygen Gareth Owen <gwowen@gmail.com> - 2016-09-05 07:00 +0100
    Re: Doxygen David Brown <david.brown@hesbynett.no> - 2016-09-05 09:07 +0200
      Re: Doxygen Malcolm McLean <malcolm.mclean5@btinternet.com> - 2016-09-05 00:26 -0700
        Re: Doxygen David Brown <david.brown@hesbynett.no> - 2016-09-05 10:51 +0200
  Doxygen "Rick C. Hodgin" <rick.c.hodgin@gmail.com> - 2016-09-04 17:29 -0700

csiph-web