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

[Michael Niedermayer]

On Sun, Jan 24, 2016 at 01:02:28PM +0100, Michael Niedermayer wrote:
> 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

slightly changed before push to align terminology more with the RFC

[...]

-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

I have never wished to cater to the crowd; for what I know they do not
approve, and what they approve I do not know. -- Epicurus
-------------- 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/5cbebcdf/attachment.sig>