Re: Documentation generated by doxygen and Debian Policy
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 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
> is to regenerate them at build time, however it is not a requirement. In
> particular, I do not see advantages in distributing rebuilds that would for
> instance only update time stamps. It is increasing debdiffs and heating the
> planet for no benefit.
>
> Have a nice day,
>
Hi,
File timestamps won't show up in debdiff. At the very least, the
maintainer should (IMNSHO) regenerate the files himself and check that
they match what ends-up being distributed. And he should also document
this process in debian/README.source. Honestly, I think it's simpler and
less error-prone to just distribute the regenerated files. But as you
said, it's not a policy requirement.
Regards, Thibaut.
Reply to: