[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Documentation generated by doxygen and Debian Policy



-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Am 19.04.2012 16:16, schrieb Boris Pek:
> Thanks all for answers.

You're welcome.

> I was searching for: /doxyfilter -g This command generates Doxyfile
> which is necessary for Doxygen.
> 
>> However I can't find anywhere in the Policy that it's an actual 
>> requirement to re-generate this kind of files at build-time.
> 
> So do I. That's why I've asked here should I make a bug report or
> not?

I would say no, because putting something like this inside
debian/rules will (re)generate the documentation (html, LaTeX,
manpages) during pkg-build:

You need to add doxygen-latex and graphviz as build-deps.

override_dh_auto_build:
	dh_auto_build
	cd doc
	rm -rf html/
	qmake
	make
	./doxyfilter -g
	sed -i -e's/GENERATE_LATEX.*= NO/GENERATE_LATEX = YES/' \
		-e's/GENERATE_MAN.*= NO/GENERATE_MAN = YES/' ./Doxyfile
	doxygen ./Doxyfile
	cd ..

It's just up to you including the generated stuff inside the -doc pkg.

> Best regards, Boris

Feel free to ask me if you need some further help about packaging all
the stuff.

Cheers,
  Björn
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iF0EAREIAAYFAk+QIdIACgkQ3u1SIc8s7PU4qAD0DzeIGuvk7m7T3CaTxWjgrqMM
TeamW1rzjbej+jGFrgEAq+tZxB+jVXlyfHiM68QoPD69UeWGCd/3gysAojiHK3c=
=A7/s
-----END PGP SIGNATURE-----


Reply to: