[FFmpeg-trac] #6950(documentation:closed): image2 demuxer documentation deficiencies

FFmpeg trac at avcodec.org
Mon Jan 8 01:36:10 EET 2018

#6950: image2 demuxer documentation deficiencies
             Reporter:  jdlh         |                    Owner:
                 Type:  defect       |                   Status:  closed
             Priority:  normal       |                Component:
              Version:  unspecified  |  documentation
             Keywords:               |               Resolution:  invalid
             Blocking:               |               Blocked By:
Analyzed by developer:  0            |  Reproduced by developer:  0
Changes (by cehoyos):

 * status:  new => closed
 * resolution:   => invalid


 The ticket is invalid since it claims to report more than one issue.
 I will try to explain shortly why the issues cannot be ''fixed'', feel
 free to continue the discussion on the user mailing list.

 Replying to [ticket:6950 jdlh]:
 > '''Problem 1. The documentation does not mention `image2` does not work
 with input  in `gif` format.'''

 It also doesn't mention that the image2 demuxer does not support apng

 > '''Problem 2. Documentation doesn't mention that input file pattern of
 `%d` usually implies `-f image2`.'''

 No other demuxer support `%d` but `%d` does not imply image2, file
 suffixes do. It is not part of the API which file suffixes imply the
 image2 demuxer, we try to update the list whenever we become aware of new
 use-cases (but we have removed file suffixes from the list in the past,
 for example `gif`).

 > '''Problem 3. Examples are missing an important class of usage.'''
 > Presently there are 3 examples. All omit the `-f image2` notation.

 But you did not provide a use-case where `-f image2` was needed: Such use
 cases of course exist but it will be difficult (or actually impossible) to
 add examples for every possible use-case.

Ticket URL: <https://trac.ffmpeg.org/ticket/6950#comment:1>
FFmpeg <https://ffmpeg.org>
FFmpeg issue tracker

More information about the FFmpeg-trac mailing list