52297945 |
FFmpeg's bug/feature request tracker manual |
a6be21d3 |
================================================= |
0c84e744 |
Overview:
--------- |
a81319d5 |
|
3df9150d |
FFmpeg uses Trac for tracking issues, new issues and changes to
existing issues can be done through a web interface. |
a81319d5 |
|
a4936313 |
Issues can be different kinds of things we want to keep track of
but that do not belong into the source tree itself. This includes |
52297945 |
bug reports, feature requests and license violations. We |
a4936313 |
might add more items to this list in the future, so feel free to
propose a new `type of issue' on the ffmpeg-devel mailing list if
you feel it is worth tracking.
|
d6d0182e |
It is possible to subscribe to individual issues by adding yourself to the |
80d4538d |
Cc list or to subscribe to the ffmpeg-trac mailing list which receives
a mail for every change to every issue. |
0c84e744 |
(the above does all work already after light testing) |
a81319d5 |
|
3df9150d |
The subscription URL for the ffmpeg-trac list is: |
5f55be70 |
https://lists.ffmpeg.org/mailman/listinfo/ffmpeg-trac |
80c24d99 |
The URL of the webinterface of the tracker is: |
5f55be70 |
https://trac.ffmpeg.org |
0c84e744 |
Type:
----- |
6889b78f |
art
Artwork such as photos, music, banners, and logos.
|
80d4538d |
bug / defect |
208506e2 |
An error, flaw, mistake, failure, or fault in FFmpeg or libav* that |
0c84e744 |
prevents it from behaving as intended.
|
80d4538d |
feature request / enhancement |
0c84e744 |
Request of support for encoding or decoding of a new codec, container
or variant. |
d6d0182e |
Request of support for more, less or plain different output or behavior |
208506e2 |
where the current implementation cannot be considered wrong. |
0c84e744 |
|
80d4538d |
license violation |
5f55be70 |
Ticket to keep track of (L)GPL violations of ffmpeg by others. |
80d4538d |
|
6889b78f |
sponsoring request
Developer requests for hardware, software, specifications, money,
refunds, etc. |
0c84e744 |
|
5f55be70 |
task
A task/reminder such as setting up a FATE client, adding filters to
Trac, etc.
|
0c84e744 |
Priority:
---------
critical |
52297945 |
Bugs about data loss and security issues. |
d6d0182e |
No feature request can be critical. |
0c84e744 |
important |
52297945 |
Bugs which make FFmpeg unusable for a significant number of users. |
208506e2 |
Examples here might be completely broken MPEG-4 decoding or a build issue |
d6d0182e |
on Linux. |
208506e2 |
While broken 4xm decoding or a broken OS/2 build would not be important,
the separation to normal is somewhat fuzzy. |
0c84e744 |
For feature requests this priority would be used for things many people
want. |
6e2c036b |
Regressions also should be marked as important, regressions are bugs that |
0bd96bcc |
don't exist in a past revision or another branch. |
0c84e744 |
normal |
5f55be70 |
Default setting. Use this if the bug does not match the other
priorities or if you are unsure of what priority to choose. |
0c84e744 |
minor |
52297945 |
Bugs about things like spelling errors, "mp2" instead of |
d6d0182e |
"mp3" being shown and such.
Feature requests about things few people want or which do not make a big |
0c84e744 |
difference.
wish |
57492dfe |
Something that is desirable to have but that there is no urgency at |
208506e2 |
all to implement, e.g. something completely cosmetic like a website |
a6be21d3 |
restyle or a personalized doxy template or the FFmpeg logo. |
208506e2 |
This priority is not valid for bugs. |
0c84e744 |
Status:
-------
new
initial state
open
intermediate states
closed |
208506e2 |
final state |
0c84e744 |
|
80d4538d |
Analyzed flag:
--------------
Bugs which have been analyzed and where it is understood what causes them
and which exact chain of events triggers them. This analysis should be
available as a message in the bug report.
Note, do not change the status to analyzed without also providing a clear
and understandable analysis.
This state implicates that the bug either has been reproduced or that
reproduction is not needed as the bug is already understood.
|
3db7ae6a |
Type/Status: |
0c84e744 |
---------- |
3db7ae6a |
*/new |
52297945 |
Initial state of new bugs and feature requests submitted by |
208506e2 |
users. |
0c84e744 |
|
3db7ae6a |
*/open |
d6d0182e |
Issues which have been briefly looked at and which did not look outright
invalid. |
208506e2 |
This implicates that no real more detailed state applies yet. Conversely,
the more detailed states below implicate that the issue has been briefly |
0c84e744 |
looked at.
*/closed/duplicate |
52297945 |
Bugs or feature requests which are duplicates. |
3f4c2431 |
Note, if you mark something as duplicate, do not forget setting the
superseder so bug reports are properly linked. |
0c84e744 |
*/closed/invalid |
208506e2 |
Bugs caused by user errors, random ineligible or otherwise nonsense stuff. |
0c84e744 |
|
82ed1ca7 |
*/closed/needs_more_info
Issues for which some information has been requested by the developers,
but which has not been provided by anyone within reasonable time.
|
0c84e744 |
bug/closed/fixed
Bugs which have to the best of our knowledge been fixed.
|
cdb46f15 |
bug/closed/wontfix |
fecf966f |
Bugs which we will not fix. Possible reasons include legality, high
complexity for the sake of supporting obscure corner cases, speed loss
for similarly esoteric purposes, et cetera. |
88a7a2dc |
This also means that we would reject a patch. |
bf99f4fc |
If we are just too lazy to fix a bug then the correct state is open |
95049fec |
and unassigned. Closed means that the case is closed which is not
the case if we are just waiting for a patch. |
0c84e744 |
bug/closed/works_for_me
Bugs for which sufficient information was provided to reproduce but |
d6d0182e |
reproduction failed - that is the code seems to work correctly to the |
57492dfe |
best of our knowledge. |
0c84e744 |
|
cdb46f15 |
feature_request/closed/fixed |
0c84e744 |
Feature requests which have been implemented.
|
cdb46f15 |
feature_request/closed/wontfix |
57492dfe |
Feature requests which will not be implemented. The reasons here could |
0c84e744 |
be legal, philosophical or others.
|
208506e2 |
Note2, if you provide the requested info do not forget to remove the |
3db7ae6a |
needs_more_info resolution. |
6b90f8e0 |
|
80d4538d |
Component:
---------- |
c0d2d806 |
avcodec
issues in libavcodec/*
|
5f55be70 |
avdevice
issues in libavdevice/*
avfilter
issues in libavfilter/*
|
c0d2d806 |
avformat
issues in libavformat/*
avutil
issues in libavutil/*
|
5f55be70 |
build system
issues in or related to configure/Makefile
documentation
issues in or related to doc/* |
c0d2d806 |
ffmpeg
issues in or related to ffmpeg.c
ffplay
issues in or related to ffplay.c
|
80d4538d |
ffprobe
issues in or related to ffprobe.c
|
c0d2d806 |
ffserver
issues in or related to ffserver.c
|
5f55be70 |
postproc
issues in libpostproc/*
swresample
issues in libswresample/* |
c0d2d806 |
|
5f55be70 |
swscale
issues in libswscale/* |
c0d2d806 |
|
80d4538d |
trac |
c0d2d806 |
issues related to our issue tracker |
5f55be70 |
undetermined
default component; choose this if unsure
website
issues related to the website
wiki
issues related to the wiki |