[FFmpeg-devel] [PATCH] doc/protocols: document protocol_whitelist

[Stefano Sabatini]

On date Saturday 2016-02-13 17:01:59 +0100, Michael Niedermayer encoded:
> Signed-off-by: Michael Niedermayer <michael at niedermayer.cc>
> ---
>  doc/protocols.texi |   19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)
> 
> diff --git a/doc/protocols.texi b/doc/protocols.texi
> index 05c4bdb..41b43d4 100644
> --- a/doc/protocols.texi
> +++ b/doc/protocols.texi
> @@ -1,3 +1,22 @@
> + at chapter Protocol Options
> + at c man begin PROTOCOL OPTIONS
> +
> +The libavformat library provides some generic global options, which
> +can be set on all the protocols. In addition each protocol may support
> +so-called private options, which are specific for that component.
> +
> +The list of supported options follows:
> +
> + at table @option
> + at item protocol_whitelist @var{list} (@emph{input})
> +"," separated List of allowed protocols. "ALL" matches all protocols. protocols

Nit:
Set a ","-separated list of allowed protocols. "ALL" matches all protocols. Protocols


> +prefixed by "-" are disabled.

> The default is that initially all protocols are

This "initially" is confusing.

> +allowed but protocols used by a protocol are restricted to a per protocol
> +subset.

What about:

All protocols are allowed by default but protocols used by a another
protocol (nested protocols) are restricted to a per protocol subset.

?
...

May be conceptually wrong though since I didn't follow the whitelist
protocol discussion.
-- 
FFmpeg = Furious & Fanciful Mastodontic Powered Enlightened Glue