[FFmpeg-devel] [PATCH] doc: add ffmpeg-bitstream-filters.texi file

[Nicolas George]

Le septidi 7 frimaire, an CCXXI, Stefano Sabatini a écrit :
> ---
>  doc/Makefile                      |    2 +-
>  doc/ffmpeg-bitstream-filters.texi |   40 +++++++++++++++++++++++++++++++++++++
>  doc/libavcodec.texi               |    5 +++--
>  3 files changed, 44 insertions(+), 3 deletions(-)
>  create mode 100644 doc/ffmpeg-bitstream-filters.texi
> 
> diff --git a/doc/Makefile b/doc/Makefile
> index 1f97f31..f74c6af 100644
> --- a/doc/Makefile
> +++ b/doc/Makefile
> @@ -6,7 +6,7 @@ DOCLIBS-$(CONFIG_AVFORMAT) += libavformat
>  DOCLIBS-$(CONFIG_AVFORMAT) += libavdevice
>  DOCLIBS-$(CONFIG_AVFILTER) += libavfilter
>  
> -COMPONENTS=$(PROGS-yes) ffmpeg-codecs ffmpeg-devices ffmpeg-filters ffmpeg-protocols ffmpeg-resampler ffmpeg-scaler ffmpeg-formats ffmpeg-utils
> +COMPONENTS=$(PROGS-yes) ffmpeg-bitstream-filters ffmpeg-codecs ffmpeg-devices ffmpeg-filters ffmpeg-protocols ffmpeg-resampler ffmpeg-scaler ffmpeg-formats ffmpeg-utils

If I understand this correctly, this makes a separate man page for just
that. I am not sure this is a good idea.

For one, it is very short, that may be splitting too much.

For two, I suspect a lot of people do not know exactly what bitstream
filters are, or even that they exist: they want filters that do something,
the technical details do not matter.

Therefore, I suspect that bitstreams filters would be better documented as a
chapter in ffmpeg-filters(1).

And someday, they should be made part of lavfi anyway, IMHO.

Regards,

-- 
  Nicolas George
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20121127/4dd8a8a3/attachment.asc>