[FFmpeg-devel] [PATCH 1/2] doc/ffmpeg: refine program title

[FFmpeg-devel] [PATCH 1/2] doc/ffmpeg: refine program title

[Anton Khirnov]

It is a media converter, not just a video converter.
---
 doc/ffmpeg.texi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index adfc2726ff..68124aaf05 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -2576,7 +2576,7 @@ ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)
 @ignore
 
 @setfilename ffmpeg
-@settitle ffmpeg video converter
+@settitle ffmpeg media converter
 
 @end ignore
 
-- 
2.39.1

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".

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

[Anton Khirnov]

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
 
-@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.
+@command{ffmpeg} is a universal media converter based on the libav* libraries.
+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
-- 
2.39.1

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".

Re: [FFmpeg-devel] [PATCH 1/2] doc/ffmpeg: refine program title

[Stefano Sabatini]

On date Saturday 2023-04-01 20:55:16 +0200, Anton Khirnov wrote:
> It is a media converter, not just a video converter.
> ---
>  doc/ffmpeg.texi | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
> index adfc2726ff..68124aaf05 100644
> --- a/doc/ffmpeg.texi
> +++ b/doc/ffmpeg.texi
> @@ -2576,7 +2576,7 @@ ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)
>  @ignore
>  
>  @setfilename ffmpeg
> -@settitle ffmpeg video converter
> +@settitle ffmpeg media converter

LGTM, thanks.
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".

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

[Stefano Sabatini]

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
>  
> -@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.

> +@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.
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".

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

[Anton Khirnov]

This is not the place to boast about high-quality polyphase filters -
the most important feature of the program is its universality.
---
Just dropped the bit about the libraries.
Better suggestions welcome, but I think this is already an improvement.
---
 doc/ffmpeg.texi | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index 68124aaf05..c0b962690d 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
 
-@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.
+@command{ffmpeg} is a universal media converter. 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
-- 
2.39.1

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".

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

[Stefano Sabatini]

On date Sunday 2023-04-02 10:33:14 +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.
> ---
> Just dropped the bit about the libraries.
> Better suggestions welcome, but I think this is already an improvement.
> ---
>  doc/ffmpeg.texi | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
> index 68124aaf05..c0b962690d 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
>  
> -@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.
> +@command{ffmpeg} is a universal media converter. It can read a wide variety of
> +inputs - including live grabbing/recording devices - filter, and transcode them
> +into a plethora of output formats.

LGTM, thanks.
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".