[FFmpeg-devel] [PATCH] doc/protocols/file: document general file protocol URL syntax
Stefano Sabatini
stefasab at gmail.com
Sat Jan 4 14:51:01 CET 2014
Also drop confusing ff* tools reference about exceptions to the
file:FILENAME syntax, which is not ff* tool specific.
---
doc/protocols.texi | 16 ++++++++++++----
1 file changed, 12 insertions(+), 4 deletions(-)
diff --git a/doc/protocols.texi b/doc/protocols.texi
index de157f7..9c50dc1 100644
--- a/doc/protocols.texi
+++ b/doc/protocols.texi
@@ -119,16 +119,24 @@ File access protocol.
Allow to read from or read to a file.
+A file URL can have the form:
+ at example
+file:@var{filename}
+ at end example
+
+where @var{filename} is the path of the file to read.
+
+A filename not containing the special character ":", or in the form
+ at var{X}:@var{filename} (for a Windows filename where @var{X} is the
+drive name) is automatically recognized as a file protocol URL, so
+that no file protocol prefix is required.
+
For example to read from a file @file{input.mpeg} with @command{ffmpeg}
use the command:
@example
ffmpeg -i file:input.mpeg output.mpeg
@end example
-The ff* tools default to the file protocol, that is a resource
-specified with the name "FILE.mpeg" is interpreted as the URL
-"file:FILE.mpeg".
-
This protocol accepts the following options:
@table @option
--
1.8.1.2
More information about the ffmpeg-devel
mailing list