[FFmpeg-devel] [PATCH] 5 patches from the Debian packaging

[Andreas Cadhalpun]

On 07.03.2014 20:33, Reimar Döffinger wrote:
> On Fri, Mar 07, 2014 at 04:38:56PM +0100, Andreas Cadhalpun wrote:
>> The output is a bit differently formatted, but the content is the same. See
>> for example the attachments for libavfilter.html.
>
> The content doesn't quite look the same to me.
>
>> -<title>FFmpeg documentation : Libavfilter </title>
>> +<title>Libavfilter Documentation</title>
>
> "FFmpeg documentation" disappeared....

I don't know, where texi2html got that from, but libavfilter.texi has:
@settitle Libavfilter Documentation

So if you want it to read FFmpeg documentation, it's best to change the 
texi file.

>> -<span class="label label-info">This document was generated on <i>March 6, 2014</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.</span></footer></div></div></body>
>
> Not sure if we had that intentionally, there seems to be no
> creation data available anymore.
> For users it can be kind of useful to know how up-to-date the
> document is.

I'm not sure creation data is that useful, as you can build a 
documentation last changed ten years ago.
More helpful in this regard would be a 'Last changed: <Date>' (or 
similar) in the texi file.
Furthermore inserting the creation date prevents getting binary 
reproducible builds [1].

1: https://wiki.debian.org/ReproducibleBuilds