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

[Paul J. <pau...@gm...>]

Doxygen is excellent and especially useful for C/C++ or "like-minded"
languages.   A few years ago I switched to developing
most of my code in Python and while Doxygen can handle this, it is not
ideal, in that case I turn to Sphinx which is ideal
for Python but also useful for general purpose API documentation:
http://sphinx-doc.org/    It is based on docutils and
reStructuredText, while I'm not the biggest fan of reStructuredText the
Sphinx additions make it very usable.

If you are looking for some REST API documentation tools I'd point you to
Swagger: https://helloreverb.com/developers/swagger

Paul Joireman

On Tue, Oct 7, 2014 at 7:21 AM, Robert Heller <he...@de...> wrote:

> At Mon, 6 Oct 2014 22:03:20 -0700 Tom Johnson <tom...@gm...>
> wrote:
>
> >
> >
> >
> > Are document generators for APIs dead? When I look over the possible
> > options out there, everything seems built about 10 years ago. I don't see
> > anything new coming out of this genre of tools. I find this odd, given
> that
> > APIs themselves are exploding in popularity.
> >
> > I'm guessing that most new APIs today are REST APIs, and none of the
> > current document generators really address REST?
> >
> > Can someone clue me in as to why there aren't more recently developed
> > tools? Doxygen seems to be the best of them, but even Doxygen seems a bit
> > dated to me.
>
> Define 'dated'...  What are you expecting?
>
> OTOH: "If it ain't broke, don't fix it."...
>
> >
> > Tom
> > ---------------------
> > 801-822-2241
> > blog: idratherbewriting.com
> > twitter: tomjohnson
> >
> > MIME-Version: 1.0
> >
> >
> ------------------------------------------------------------------------------
> > Meet PCI DSS 3.0 Compliance Requirements with EventLog Analyzer
> > Achieve PCI DSS 3.0 Compliant Status with Out-of-the-box PCI DSS Reports
> > Are you Audit-Ready for PCI DSS 3.0 Compliance? Download White paper
> > Comply to PCI DSS 3.0 Requirement 10 and 11.5 with EventLog Analyzer
> >
> http://pubads.g.doubleclick.net/gampad/clk?id=154622311&iu=/4140/ostg.clktrk
> > MIME-Version: 1.0
> >
> > _______________________________________________
> > Doxygen-users mailing list
> > Dox...@li...
> > https://lists.sourceforge.net/lists/listinfo/doxygen-users
> >
> >
>
> --
> Robert Heller             -- 978-544-6933
> Deepwoods Software        -- Custom Software Services
> http://www.deepsoft.com/  -- Linux Administration Services
> he...@de...       -- Webhosting Services
>
>
>
> ------------------------------------------------------------------------------
> Meet PCI DSS 3.0 Compliance Requirements with EventLog Analyzer
> Achieve PCI DSS 3.0 Compliant Status with Out-of-the-box PCI DSS Reports
> Are you Audit-Ready for PCI DSS 3.0 Compliance? Download White paper
> Comply to PCI DSS 3.0 Requirement 10 and 11.5 with EventLog Analyzer
>
> http://pubads.g.doubleclick.net/gampad/clk?id=154622311&iu=/4140/ostg.clktrk
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>



-- 
Paul W. Joireman
pau...@gm...

----------------------------------------------------------------
'Am I not destroying my enemies when I make friends of them? ."
-- Abraham Lincoln 1809-1865