Re: [Doxygen-users] are document generators dead?

2014-10-07 Thread Paul Joireman
everb.com/developers/swagger Paul Joireman On Tue, Oct 7, 2014 at 7:21 AM, Robert Heller wrote: > At Mon, 6 Oct 2014 22:03:20 -0700 Tom Johnson > wrote: > > > > > > > > > Are document generators for APIs dead? When I look over the possible > > options out th

Re: [Doxygen-users] Doxygen .txt file inclusion

2014-01-06 Thread Paul Joireman
Thomas, I frequently inlcuded doxygen marked up documentation in a file with a dox extension and that was automatically picked up by Doxygen (last tried with 1.8.0). The documentation does have to be enclosed in a doxygen comment block but /** Your comment here */ Would this suit your needs.

Re: [Doxygen-users] Avoiding repeat function documentation in Doxygen

2013-02-04 Thread Paul Joireman
Dude (nice nickname) One possible solution is to place conditional guards around your prototypes in the files where you don't want them included: /* @cond ONLY_INCLUDE_THE_FOLLOWING_IF_I_DEFINE_THIS_NAME */ Function prototypes go here /* @endcond */ Place these two comments around what you don