gpgme 1.7.0 "make" does not make lang/qt/doc/generated/latex/refman.pdf

[Andre Heinecke]

Hi,

On Wednesday 12 October 2016 17:58:05 Daniel Kahn Gillmor wrote:
> using gpgme 1.7.0, after a "make", i can coax a nice-looking PDF
> reference manual for libqgpgme by doing:

I think that the PDF is way too large. A lot of the documentation is for 
private (All classes starting with QGpgME are private) API and It is very 
repetitive as the Jobs all follow the same pattern. It would probably better 
to explain the pattern in general and then list the available Jobs and how to 
use them. I want to work on this with doxgen but I did not find the time yet 
;-)

>   (cd lang/qt/doc/generated/latex && make)
> 
> This creates refman.pdf in the mentioned directory.
> 
> I would have expected this pdf to be built automatically, at the same
> time as the rest of the stuff in that directory.  Is there a reason it's
> not done automatically?

Requires Latex and we don't check for latex. yet :-). Also this would slow 
down the build further and I find the HTML documentation more useful as it's 
better interlinked.

> I'm afraid i'm not enough of a doxygen wizard to know the right
> incantations in Makefile.am or Doxyfile to ensure that it gets built
> during a standard run, but it would be nice if it were!

The gentoo package maintainer requested that the doc is not built by default. 
I think if we add an explict configure option to enable the qt doc we could 
also then generate the pdf / check for latex.

Regards,
Andre

-- 
Andre Heinecke |  ++49-541-335083-262  | http://www.intevation.de/
Intevation GmbH, Neuer Graben 17, 49074 Osnabrück | AG Osnabrück, HR B 18998
Geschäftsführer: Frank Koormann, Bernhard Reiter, Dr. Jan-Oliver Wagner
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 630 bytes
Desc: This is a digitally signed message part.
URL: </pipermail/attachments/20161014/c572f211/attachment.sig>