[FFmpeg-devel] [PATCH] doc/developer: origin of tables should be documented.

[Alexander Strasser]

Hi Nicolas!

On 2020-08-03 11:54 +0200, Nicolas George wrote:
> Nicolas George (12020-07-31):
> > Something like this would be acceptable:
> >
> > /* Reverse-engineered by encoding various files with the reference
> >    encoder. */
> >
> > Reluctance to give this little information is baffling to me.
>
> Can other developers give their input on this?
>
> Is it acceptable or too much to require at least short comments like
> these ones before tables of numbers in the source code?
>
> /* Copied from https://oeis.org/A000055 */
>
> /* Computed with =IF(MOD(A1;2)=0;A1/2;3*A1+1) */
>
> /* Adjusted to match decoding of samples/$dir/*.xxx with screenshots
>    from the game. */
>
> They are IMHO necessary to let other people learn from the source code,
> which is the difference between Libre Software and non-Libre Software.
> They may probably be useful for the author themself if they come back
> much later.

Not sure I agree with your definition of Libre Software and your exact
wording of the patch.

I agree that leaving a hint of where the data comes from, directly where
the data is defined in the source code, is a good thing and probably not
to much to ask for.


  Alexander