Log message:
x11/gtkada: Add user guide and reference manual documentation
The majority of the documentation for gtkada was not getting built. It
turns out that the generation step was omitted from the vendor Makefile.
For the user guide, simply adding this to the top-level makefile fixes the
problem, but the reference manual is the reason it was omitted.
The RM requires Gnat Programming Studio built with Python to generate the
documentation. This created a circular dependency because GPS requires
gtkada to build and python is optional. Secondly, pkgsrc-built python
verions 26 and 27 both cause GPS to core dump. FreeBSD doesn't have this
issue, but it has a different python problem that prevents the documentation
from getting built manually on that system as well.
In the end, the latest generated RM was pulled from libre.adacore.com online
resources and packaged separately. This is not ideal because it represents
gtkada 2.24 which has a couple of API differences from 2.22, but it's the
only full html version of the RM that can be located.
Rebuilding gtkada will result in the gtkada User Guild and Reference
Manual showing up in the <help> menu of GPS. Currently the gtkada submenu
item has an empty submenu.
|