[FFmpeg-devel] [PATCH] doc/ffprobe: add a useful one-liner example to get essential input information as JSON

[Stefano Sabatini]

On date Saturday 2023-12-09 20:57:09 -0600, Marth64 wrote:
> Signed-off-by: Marth64 <marth64 at proxyid.net>
> 
> This could be useful for folks who are just learning ffmpeg or have simple needs for parsing input information as JSON.
> 
> ---
>  doc/ffprobe.texi | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/doc/ffprobe.texi b/doc/ffprobe.texi
> index b74ff650ac..ed88e619f6 100644
> --- a/doc/ffprobe.texi
> +++ b/doc/ffprobe.texi
> @@ -572,6 +572,12 @@ printed on a single line. Default value is 0.
>  
>  For more information about JSON, see @url{http://www.json.org/}.
>  
> + at subsection Examples
> +Output format, stream, and chapter information of an input as JSON:
> + at example
> +ffprobe -of json -show_format -show_streams -show_chapters INPUT
> + at end example

Not convinced this is the right place for it (because the writers
section is mostly about the writers).

Probably we miss an overall generic section showing complete examples
(which might well contain your example).