[FFmpeg-devel] [PATCH 2/2] doc/ffmpeg: rewrite the introductory paragraph

Stefano Sabatini stefasab at gmail.com
Sun Apr 2 02:28:36 EEST 2023


On date Saturday 2023-04-01 20:55:17 +0200, Anton Khirnov wrote:
> This is not the place to boast about high-quality polyphase filters -
> the most important feature of the program is its universality.
> ---
>  doc/ffmpeg.texi | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
> index 68124aaf05..c7dffdb109 100644
> --- a/doc/ffmpeg.texi
> +++ b/doc/ffmpeg.texi
> @@ -17,9 +17,9 @@ ffmpeg [@var{global_options}] @{[@var{input_file_options}] -i @file{input_url}@}
>  @chapter Description
>  @c man begin DESCRIPTION
>  
> - at command{ffmpeg} is a very fast video and audio converter that can also grab from
> -a live audio/video source. It can also convert between arbitrary sample
> -rates and resize video on the fly with a high quality polyphase filter.

> + at command{ffmpeg} is a universal media converter based on the libav* libraries.

I'm not sure we should mention the "libav* libraries" in the first
sentence, since most users won't know nothing about them and will
wonder what this is about, probably we want to drop that part, or
reword in other to avoid the cryptic "libav*" (but I have no good idea
and a sensible description cannot really be squeezed in the first
sentence describing the tool).

> +It can read a wide variety of inputs - including live grabbing/recording devices
> +- filter, and transcode them into a plethora of output formats.
>  
>  @command{ffmpeg} reads from an arbitrary number of input "files" (which can be regular
>  files, pipes, network streams, grabbing devices, etc.), specified by the

LGTM otherwise, thanks.


More information about the ffmpeg-devel mailing list