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

[Nicolas George]

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.

Regards,

-- 
  Nicolas George
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <https://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20200803/331129bd/attachment.sig>