Re: autogenerate html documentation out of .ads file

[Niklas Holsti <niklas.holsti@tidorum.invalid>]

On 2019-11-12 21:09, Per Sandberg wrote:
> "gnatdoc" (normally part of the gnat-installation) will do the trick.
> /P

There is also (or used to be) a tool called "gnathtml.pl", which is a 
Perl script that generates HTML that looks rather like the Ada source, 
but has cross-links.

I haven't used "gnatdoc" much, but IIRC its output is more like Doxygen 
output, which I don't like. YMMV.

> On 2019-11-12 18:07, Alain De Vos wrote:
>> The file mylibrary.ads contains a list of functions which the outside 
>> world can call.
>> Can I autogenerate a .html file out of this mylibrarya.ads file in 
>> order the let the outside world know this library is available ?

IMO a well-commented .ads file is good enough for that part of the 
outside world that consists of programmers who want to use the package 
(it may not be enough for code reviewers and cross-readers). No 
automatic HTML generator can add the rationales, descriptions, and 
discussions, which IMO are the essential info for using a package 
_correctly_.

--
Niklas Holsti
niklas holsti tidorum fi
       .      @       .