Re: Documentation generated by doxygen and Debian Policy

2012-04-20 Thread Boris Pek
>> You need to add doxygen-latex and graphviz as build-deps. > > Rather as Build-Depends-Indep. > >> override_dh_auto_build: > > which would also run when building only the arch-dep packages. rather: > > build-doc: > >> cd doc ;\ >> rm -rf html/ ;\ >> qmake ;\ >>

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Charles Plessy
Le Thu, Apr 19, 2012 at 05:02:13PM +0200, Thibaut Paumard a écrit : > Le 19/04/12 16:20, Charles Plessy a écrit : > > > > I think that there is a consensus that generated files must be regenerable, > > and > > that it is a bug if their build system is broken. The best way to ensure > > this > >

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Thibaut Paumard
Le 19/04/12 16:31, Björn Esser a écrit : > 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'

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Thibaut Paumard
Le 19/04/12 16:20, Charles Plessy a écrit : > Le Thu, Apr 19, 2012 at 03:57:59PM +0200, Thibaut Paumard a écrit : >> >> I believe it is generally accepted that every file that can be >> (re)generated during the build process should be, for various reasons. > > Hi all, > > I think that there is a

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Björn Esser
-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

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Charles Plessy
Le Thu, Apr 19, 2012 at 03:57:59PM +0200, Thibaut Paumard a écrit : > > I believe it is generally accepted that every file that can be > (re)generated during the build process should be, for various reasons. Hi all, I think that there is a consensus that generated files must be regenerable, and

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Boris Pek
Thanks all for answers. 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

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Björn Esser
-BEGIN PGP SIGNED MESSAGE- Hash: SHA256 As stated in my previous message, this is the way to generate the needed Doxyfile: cd doc (inside the tarball-basedir ) qmake ( produce Makefile ) make ( build ./doxyfilter ) ./doxyfilter -g ( generates Doxyfile ) after this some sed-magic to enabl

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Thibaut Paumard
Le 19/04/12 15:18, Boris Pek a écrit : >>> I found that in package qxmpp is used HTML documentation from upstream >>> tarball. >>> This documentation was not generated by doxygen during build process. >>> Should >>> I make a bug report? If yes, which section of Debian Policy I should point >>

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Paul Tagliamonte
On Thu, Apr 19, 2012 at 9:18 AM, Boris Pek wrote: >>>  I found that in package qxmpp is used HTML documentation from upstream >>> tarball. >>>  This documentation was not generated by doxygen during build process. >>> Should >>>  I make a bug report? If yes, which section of Debian Policy I shou

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Björn Esser
-BEGIN PGP SIGNED MESSAGE- Hash: SHA256 Hello Boris! I just investigated a bit inside the source-tar doing this: cd doc 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 ..

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Boris Pek
>> I found that in package qxmpp is used HTML documentation from upstream >> tarball. >> This documentation was not generated by doxygen during build process. Should >> I make a bug report? If yes, which section of Debian Policy I should point >> to? > > Well, there's nowhere in the DFSG or co

Re: Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Paul Tagliamonte
On Thu, Apr 19, 2012 at 3:36 AM, Boris Pek wrote: > Hi list, > > I found that in package qxmpp is used HTML documentation from upstream > tarball. > This documentation was not generated by doxygen during build process. Should > I make a bug report? If yes, which section of Debian Policy I should

Documentation generated by doxygen and Debian Policy

2012-04-19 Thread Boris Pek
Hi list, I found that in package qxmpp is used HTML documentation from upstream tarball. This documentation was not generated by doxygen during build process. Should I make a bug report? If yes, which section of Debian Policy I should point to? Best regards, Boris -- To UNSUBSCRIBE, email to d