[FFmpeg-devel] [PATCH] avformat: Document urls a bit

[Michael Niedermayer]

On Sun, Jan 24, 2016 at 12:28:23PM +0100, Moritz Barsnick wrote:
> On Sat, Jan 23, 2016 at 00:36:51 +0100, Michael Niedermayer wrote:
> >  libavformat/avformat.h |    9 +++++++++
> >  1 file changed, 9 insertions(+)
> 
> This will at least need some spelling fixes and commas. ;-)
> 
> > + * @section urls
> > + * URLs in libavformat are made of a protocol a ':' and a protocol specific string
> > + * urls without a protocol and ':' used for local files are supported but
> > + * deprecated. "file:" should be used for local files.
> > + * It is important that the protocol string is not taken from untrusted soucres
> > + * without checks.
> > + * some protocols are quite powerfull, allowing access to local and remote files,
> > + * parts of them, concatenations of them, local audio and video devices and so on.
> 
> Such as:
> 
>   URL strings in libavformat are made of a protocol, a ':', and a protocol
>   specific string. URLs without a protocol and ':' used for local files
>   are supported but deprecated. "file:" should be used for local files.
> 
>   It is important that the protocol string is not taken from untrusted
>   sources without checks.
> 
>   Note that some protocols are quite powerful, allowing access to both
>   local and remote files, parts of them, concatenations of them, local
>   audio and video devices and so on.

ok, updated
applied

PS: all further improvments welcome

thx

[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

When the tyrant has disposed of foreign enemies by conquest or treaty, and
there is nothing more to fear from them, then he is always stirring up
some war or other, in order that the people may require a leader. -- Plato
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20160124/94d97d83/attachment.sig>