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

[Zhao Zhili]

> On Aug 3, 2020, at 5:54 PM, Nicolas George <george at nsup.org> 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.

Agree. And I like it extends to approximation/non-standard algorithms, although
it'd hard to define "non-standard".

> 
> Regards,
> 
> -- 
>  Nicolas George
> 
> _______________________________________________
> ffmpeg-devel mailing list
> ffmpeg-devel at ffmpeg.org
> https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
> 
> To unsubscribe, visit link above, or email
> ffmpeg-devel-request at ffmpeg.org with subject "unsubscribe".