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

[Timothy Gu]

On Saturday, March 8, 2014, Andreas Cadhalpun <
andreas.cadhalpun at googlemail.com> wrote:

> 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.


>From doc/t2h.init. Another thing i noticed is that makeinfo doesn't seem to
support texi2html init files, which FFmpeg uses for lots of things
including CSS and title. Although makeinfo has --init-file option, the
syntax of that is not documented anywhere, unlike texi2html.


>
>  -<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
> _______________________________________________
> ffmpeg-devel mailing list
> ffmpeg-devel at ffmpeg.org
> http://ffmpeg.org/mailman/listinfo/ffmpeg-devel
>