Merge commit '205a4502d3da9de2db75d2c965c9d065574e9266'
authorMichael Niedermayer <michaelni@gmx.at>
Sun, 11 Aug 2013 09:49:47 +0000 (11:49 +0200)
committerMichael Niedermayer <michaelni@gmx.at>
Sun, 11 Aug 2013 09:49:47 +0000 (11:49 +0200)
* commit '205a4502d3da9de2db75d2c965c9d065574e9266':
  doc: Clarify the avconv section about -re

Conflicts:
doc/ffmpeg.texi

Merged-by: Michael Niedermayer <michaelni@gmx.at>
1  2 
doc/ffmpeg.texi

diff --cc doc/ffmpeg.texi
@@@ -876,40 -719,23 +876,39 @@@ Dump each input packet to stderr
  @item -hex (@emph{global})
  When dumping packets, also dump the payload.
  @item -re (@emph{input})
 -Read input at native frame rate. Mainly used to simulate a grab device
 +Read input at native frame rate. Mainly used to simulate a grab device.
+ or live input stream (e.g. when reading from a file). Should not be used
+ with actual grab devices or live input streams (where it can cause packet
+ loss).
 +By default @command{ffmpeg} attempts to read the input(s) as fast as possible.
 +This option will slow down the reading of the input(s) to the native frame rate
- of the input(s). It is useful for real-time output (e.g. live streaming). If
- your input(s) is coming from some other live streaming source (through HTTP or
- UDP for example) the server might already be in real-time, thus the option will
- likely not be required. On the other hand, this is meaningful if your input(s)
- is a file you are trying to push in real-time.
++of the input(s). It is useful for real-time output (e.g. live streaming).
 +@item -loop_input
 +Loop over the input stream. Currently it works only for image
 +streams. This option is used for automatic FFserver testing.
 +This option is deprecated, use -loop 1.
 +@item -loop_output @var{number_of_times}
 +Repeatedly loop output for formats that support looping such as animated GIF
 +(0 will loop the output infinitely).
 +This option is deprecated, use -loop.
  @item -vsync @var{parameter}
  Video sync method.
 +For compatibility reasons old values can be specified as numbers.
 +Newly added values will have to be specified as strings always.
  
  @table @option
 -@item passthrough
 +@item 0, passthrough
  Each frame is passed with its timestamp from the demuxer to the muxer.
 -@item cfr
 +@item 1, cfr
  Frames will be duplicated and dropped to achieve exactly the requested
 -constant framerate.
 -@item vfr
 +constant frame rate.
 +@item 2, vfr
  Frames are passed through with their timestamp or dropped so as to
  prevent 2 frames from having the same timestamp.
 -@item auto
 +@item drop
 +As passthrough but destroys all timestamps, making the muxer generate
 +fresh timestamps based on frame-rate.
 +@item -1, auto
  Chooses between 1 and 2 depending on muxer capabilities. This is the
  default method.
  @end table