mirror of https://github.com/FFmpeg/FFmpeg.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
215 lines
6.0 KiB
215 lines
6.0 KiB
FFmpeg's bug/feature request tracker manual |
|
================================================= |
|
|
|
Overview: |
|
--------- |
|
|
|
FFmpeg uses Trac for tracking issues, new issues and changes to |
|
existing issues can be done through a web interface. |
|
|
|
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 |
|
bug reports, feature requests and license violations. We |
|
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. |
|
|
|
It is possible to subscribe to individual issues by adding yourself to the |
|
Cc list or to subscribe to the ffmpeg-trac mailing list which receives |
|
a mail for every change to every issue. |
|
(the above does all work already after light testing) |
|
|
|
The subscription URL for the ffmpeg-trac list is: |
|
https://lists.ffmpeg.org/mailman/listinfo/ffmpeg-trac |
|
The URL of the webinterface of the tracker is: |
|
https://trac.ffmpeg.org |
|
|
|
Type: |
|
----- |
|
art |
|
Artwork such as photos, music, banners, and logos. |
|
|
|
bug / defect |
|
An error, flaw, mistake, failure, or fault in FFmpeg or libav* that |
|
prevents it from behaving as intended. |
|
|
|
feature request / enhancement |
|
Request of support for encoding or decoding of a new codec, container |
|
or variant. |
|
Request of support for more, less or plain different output or behavior |
|
where the current implementation cannot be considered wrong. |
|
|
|
license violation |
|
Ticket to keep track of (L)GPL violations of ffmpeg by others. |
|
|
|
sponsoring request |
|
Developer requests for hardware, software, specifications, money, |
|
refunds, etc. |
|
|
|
task |
|
A task/reminder such as setting up a FATE client, adding filters to |
|
Trac, etc. |
|
|
|
Priority: |
|
--------- |
|
critical |
|
Bugs about data loss and security issues. |
|
No feature request can be critical. |
|
|
|
important |
|
Bugs which make FFmpeg unusable for a significant number of users. |
|
Examples here might be completely broken MPEG-4 decoding or a build issue |
|
on Linux. |
|
While broken 4xm decoding or a broken OS/2 build would not be important, |
|
the separation to normal is somewhat fuzzy. |
|
For feature requests this priority would be used for things many people |
|
want. |
|
Regressions also should be marked as important, regressions are bugs that |
|
don't exist in a past revision or another branch. |
|
|
|
normal |
|
Default setting. Use this if the bug does not match the other |
|
priorities or if you are unsure of what priority to choose. |
|
|
|
minor |
|
Bugs about things like spelling errors, "mp2" instead of |
|
"mp3" being shown and such. |
|
Feature requests about things few people want or which do not make a big |
|
difference. |
|
|
|
wish |
|
Something that is desirable to have but that there is no urgency at |
|
all to implement, e.g. something completely cosmetic like a website |
|
restyle or a personalized doxy template or the FFmpeg logo. |
|
This priority is not valid for bugs. |
|
|
|
|
|
Status: |
|
------- |
|
new |
|
initial state |
|
|
|
open |
|
intermediate states |
|
|
|
closed |
|
final state |
|
|
|
|
|
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. |
|
|
|
|
|
Type/Status: |
|
---------- |
|
*/new |
|
Initial state of new bugs and feature requests submitted by |
|
users. |
|
|
|
*/open |
|
Issues which have been briefly looked at and which did not look outright |
|
invalid. |
|
This implicates that no real more detailed state applies yet. Conversely, |
|
the more detailed states below implicate that the issue has been briefly |
|
looked at. |
|
|
|
*/closed/duplicate |
|
Bugs or feature requests which are duplicates. |
|
Note, if you mark something as duplicate, do not forget setting the |
|
superseder so bug reports are properly linked. |
|
|
|
*/closed/invalid |
|
Bugs caused by user errors, random ineligible or otherwise nonsense stuff. |
|
|
|
*/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. |
|
|
|
|
|
bug/closed/fixed |
|
Bugs which have to the best of our knowledge been fixed. |
|
|
|
bug/closed/wontfix |
|
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. |
|
This also means that we would reject a patch. |
|
If we are just too lazy to fix a bug then the correct state is open |
|
and unassigned. Closed means that the case is closed which is not |
|
the case if we are just waiting for a patch. |
|
|
|
bug/closed/works_for_me |
|
Bugs for which sufficient information was provided to reproduce but |
|
reproduction failed - that is the code seems to work correctly to the |
|
best of our knowledge. |
|
|
|
feature_request/closed/fixed |
|
Feature requests which have been implemented. |
|
|
|
feature_request/closed/wontfix |
|
Feature requests which will not be implemented. The reasons here could |
|
be legal, philosophical or others. |
|
|
|
Note2, if you provide the requested info do not forget to remove the |
|
needs_more_info resolution. |
|
|
|
Component: |
|
---------- |
|
|
|
avcodec |
|
issues in libavcodec/* |
|
|
|
avdevice |
|
issues in libavdevice/* |
|
|
|
avfilter |
|
issues in libavfilter/* |
|
|
|
avformat |
|
issues in libavformat/* |
|
|
|
avutil |
|
issues in libavutil/* |
|
|
|
build system |
|
issues in or related to configure/Makefile |
|
|
|
documentation |
|
issues in or related to doc/* |
|
|
|
ffmpeg |
|
issues in or related to ffmpeg.c |
|
|
|
ffplay |
|
issues in or related to ffplay.c |
|
|
|
ffprobe |
|
issues in or related to ffprobe.c |
|
|
|
postproc |
|
issues in libpostproc/* |
|
|
|
swresample |
|
issues in libswresample/* |
|
|
|
swscale |
|
issues in libswscale/* |
|
|
|
trac |
|
issues related to our issue tracker |
|
|
|
undetermined |
|
default component; choose this if unsure |
|
|
|
website |
|
issues related to the website |
|
|
|
wiki |
|
issues related to the wiki
|
|
|