2007-08-15 11:28:01 -03:00
|
|
|
.. _reporting-bugs:
|
|
|
|
|
2010-04-22 20:19:41 -03:00
|
|
|
**************
|
|
|
|
Reporting Bugs
|
|
|
|
**************
|
2007-08-15 11:28:01 -03:00
|
|
|
|
|
|
|
Python is a mature programming language which has established a reputation for
|
|
|
|
stability. In order to maintain this reputation, the developers would like to
|
|
|
|
know of any deficiencies you find in Python.
|
|
|
|
|
2010-04-22 20:19:41 -03:00
|
|
|
|
|
|
|
Documentation bugs
|
|
|
|
==================
|
|
|
|
|
|
|
|
If you find a bug in this documentation or would like to propose an improvement,
|
|
|
|
please send an e-mail to docs@python.org describing the bug and where you found
|
|
|
|
it. If you have a suggestion how to fix it, include that as well.
|
|
|
|
|
|
|
|
docs@python.org is a mailing list run by volunteers; your request will be
|
|
|
|
noticed, even if it takes a while to be processed.
|
|
|
|
|
|
|
|
Of course, if you want a more persistent record of your issue, you can use the
|
|
|
|
issue tracker for documentation bugs as well.
|
|
|
|
|
|
|
|
|
|
|
|
Using the Python issue tracker
|
|
|
|
==============================
|
|
|
|
|
|
|
|
Bug reports for Python itself should be submitted via the Python Bug Tracker
|
2007-08-15 11:28:01 -03:00
|
|
|
(http://bugs.python.org/). The bug tracker offers a Web form which allows
|
|
|
|
pertinent information to be entered and submitted to the developers.
|
|
|
|
|
|
|
|
The first step in filing a report is to determine whether the problem has
|
|
|
|
already been reported. The advantage in doing so, aside from saving the
|
|
|
|
developers time, is that you learn what has been done to fix it; it may be that
|
|
|
|
the problem has already been fixed for the next release, or additional
|
|
|
|
information is needed (in which case you are welcome to provide it if you can!).
|
|
|
|
To do this, search the bug database using the search box on the top of the page.
|
|
|
|
|
|
|
|
If the problem you're reporting is not already in the bug tracker, go back to
|
Merged revisions 77593,77702-77703,77858,77887,78113-78115,78117,78245,78385-78386,78496,78760,78771-78773,78802 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r77593 | georg.brandl | 2010-01-18 00:33:53 +0100 (Mo, 18 Jan 2010) | 1 line
Fix internal reference.
........
r77702 | georg.brandl | 2010-01-23 09:43:31 +0100 (Sa, 23 Jan 2010) | 1 line
#7762: fix refcount annotation of PyUnicode_Tailmatch().
........
r77703 | georg.brandl | 2010-01-23 09:47:54 +0100 (Sa, 23 Jan 2010) | 1 line
#7725: fix referencing issue.
........
r77858 | georg.brandl | 2010-01-30 18:57:48 +0100 (Sa, 30 Jan 2010) | 1 line
#7802: fix invalid example (heh).
........
r77887 | georg.brandl | 2010-01-31 19:51:49 +0100 (So, 31 Jan 2010) | 5 lines
Fix-up ftplib documentation:
move exception descriptions to toplevel, not inside a class
remove attribution in "versionadded"
spell and grammar check docstring of FTP_TLS
........
r78113 | georg.brandl | 2010-02-08 23:37:20 +0100 (Mo, 08 Feb 2010) | 1 line
Fix missing string formatting argument.
........
r78114 | georg.brandl | 2010-02-08 23:37:52 +0100 (Mo, 08 Feb 2010) | 1 line
Fix undefined local.
........
r78115 | georg.brandl | 2010-02-08 23:40:51 +0100 (Mo, 08 Feb 2010) | 1 line
Fix missing string formatting placeholder.
........
r78117 | georg.brandl | 2010-02-08 23:48:37 +0100 (Mo, 08 Feb 2010) | 1 line
Convert test failure from output-producing to self.fail().
........
r78245 | georg.brandl | 2010-02-19 20:36:08 +0100 (Fr, 19 Feb 2010) | 1 line
#7967: PyXML is no more.
........
r78385 | georg.brandl | 2010-02-23 22:33:17 +0100 (Di, 23 Feb 2010) | 1 line
#8000: fix deprecated directive. What a shame to lose that glorious issue number to such a minor bug :)
........
r78386 | georg.brandl | 2010-02-23 22:48:57 +0100 (Di, 23 Feb 2010) | 1 line
#6544: fix refleak in kqueue, occurring in certain error conditions.
........
r78496 | georg.brandl | 2010-02-27 15:58:08 +0100 (Sa, 27 Feb 2010) | 1 line
Link to http://www.python.org/dev/workflow/ from bugs page.
........
r78760 | georg.brandl | 2010-03-07 16:23:59 +0100 (So, 07 Mär 2010) | 1 line
#5341: more built-in vs builtin fixes.
........
r78771 | georg.brandl | 2010-03-07 21:58:31 +0100 (So, 07 Mär 2010) | 1 line
#8085: The function is called PyObject_NewVar, not PyObject_VarNew.
........
r78772 | georg.brandl | 2010-03-07 22:12:28 +0100 (So, 07 Mär 2010) | 1 line
#8039: document conditional expressions better, giving them their own section.
........
r78773 | georg.brandl | 2010-03-07 22:32:06 +0100 (So, 07 Mär 2010) | 1 line
#8044: document Py_{Enter,Leave}RecursiveCall functions.
........
r78802 | georg.brandl | 2010-03-08 17:28:40 +0100 (Mo, 08 Mär 2010) | 1 line
Fix typo.
........
2010-03-21 16:29:04 -03:00
|
|
|
the Python Bug Tracker and log in. If you don't already have a tracker account,
|
|
|
|
select the "Register" link or, if you use OpenID, one of the OpenID provider
|
|
|
|
logos in the sidebar. It is not possible to submit a bug report anonymously.
|
2007-08-15 11:28:01 -03:00
|
|
|
|
|
|
|
Being now logged in, you can submit a bug. Select the "Create New" link in the
|
|
|
|
sidebar to open the bug reporting form.
|
|
|
|
|
|
|
|
The submission form has a number of fields. For the "Title" field, enter a
|
|
|
|
*very* short description of the problem; less than ten words is good. In the
|
|
|
|
"Type" field, select the type of your problem; also select the "Component" and
|
|
|
|
"Versions" to which the bug relates.
|
|
|
|
|
2008-05-04 16:10:02 -03:00
|
|
|
In the "Comment" field, describe the problem in detail, including what you
|
2007-08-15 11:28:01 -03:00
|
|
|
expected to happen and what did happen. Be sure to include whether any
|
|
|
|
extension modules were involved, and what hardware and software platform you
|
|
|
|
were using (including version information as appropriate).
|
|
|
|
|
|
|
|
Each bug report will be assigned to a developer who will determine what needs to
|
|
|
|
be done to correct the problem. You will receive an update each time action is
|
Merged revisions 77593,77702-77703,77858,77887,78113-78115,78117,78245,78385-78386,78496,78760,78771-78773,78802 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r77593 | georg.brandl | 2010-01-18 00:33:53 +0100 (Mo, 18 Jan 2010) | 1 line
Fix internal reference.
........
r77702 | georg.brandl | 2010-01-23 09:43:31 +0100 (Sa, 23 Jan 2010) | 1 line
#7762: fix refcount annotation of PyUnicode_Tailmatch().
........
r77703 | georg.brandl | 2010-01-23 09:47:54 +0100 (Sa, 23 Jan 2010) | 1 line
#7725: fix referencing issue.
........
r77858 | georg.brandl | 2010-01-30 18:57:48 +0100 (Sa, 30 Jan 2010) | 1 line
#7802: fix invalid example (heh).
........
r77887 | georg.brandl | 2010-01-31 19:51:49 +0100 (So, 31 Jan 2010) | 5 lines
Fix-up ftplib documentation:
move exception descriptions to toplevel, not inside a class
remove attribution in "versionadded"
spell and grammar check docstring of FTP_TLS
........
r78113 | georg.brandl | 2010-02-08 23:37:20 +0100 (Mo, 08 Feb 2010) | 1 line
Fix missing string formatting argument.
........
r78114 | georg.brandl | 2010-02-08 23:37:52 +0100 (Mo, 08 Feb 2010) | 1 line
Fix undefined local.
........
r78115 | georg.brandl | 2010-02-08 23:40:51 +0100 (Mo, 08 Feb 2010) | 1 line
Fix missing string formatting placeholder.
........
r78117 | georg.brandl | 2010-02-08 23:48:37 +0100 (Mo, 08 Feb 2010) | 1 line
Convert test failure from output-producing to self.fail().
........
r78245 | georg.brandl | 2010-02-19 20:36:08 +0100 (Fr, 19 Feb 2010) | 1 line
#7967: PyXML is no more.
........
r78385 | georg.brandl | 2010-02-23 22:33:17 +0100 (Di, 23 Feb 2010) | 1 line
#8000: fix deprecated directive. What a shame to lose that glorious issue number to such a minor bug :)
........
r78386 | georg.brandl | 2010-02-23 22:48:57 +0100 (Di, 23 Feb 2010) | 1 line
#6544: fix refleak in kqueue, occurring in certain error conditions.
........
r78496 | georg.brandl | 2010-02-27 15:58:08 +0100 (Sa, 27 Feb 2010) | 1 line
Link to http://www.python.org/dev/workflow/ from bugs page.
........
r78760 | georg.brandl | 2010-03-07 16:23:59 +0100 (So, 07 Mär 2010) | 1 line
#5341: more built-in vs builtin fixes.
........
r78771 | georg.brandl | 2010-03-07 21:58:31 +0100 (So, 07 Mär 2010) | 1 line
#8085: The function is called PyObject_NewVar, not PyObject_VarNew.
........
r78772 | georg.brandl | 2010-03-07 22:12:28 +0100 (So, 07 Mär 2010) | 1 line
#8039: document conditional expressions better, giving them their own section.
........
r78773 | georg.brandl | 2010-03-07 22:32:06 +0100 (So, 07 Mär 2010) | 1 line
#8044: document Py_{Enter,Leave}RecursiveCall functions.
........
r78802 | georg.brandl | 2010-03-08 17:28:40 +0100 (Mo, 08 Mär 2010) | 1 line
Fix typo.
........
2010-03-21 16:29:04 -03:00
|
|
|
taken on the bug. See http://www.python.org/dev/workflow/ for a detailed
|
|
|
|
description of the issue workflow.
|
2007-08-15 11:28:01 -03:00
|
|
|
|
|
|
|
|
|
|
|
.. seealso::
|
|
|
|
|
2008-01-21 14:41:24 -04:00
|
|
|
`How to Report Bugs Effectively <http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_
|
2007-08-15 11:28:01 -03:00
|
|
|
Article which goes into some detail about how to create a useful bug report.
|
|
|
|
This describes what kind of information is useful and why it is useful.
|
|
|
|
|
2008-03-14 21:20:19 -03:00
|
|
|
`Bug Writing Guidelines <http://developer.mozilla.org/en/docs/Bug_writing_guidelines>`_
|
2007-08-15 11:28:01 -03:00
|
|
|
Information about writing a good bug report. Some of this is specific to the
|
|
|
|
Mozilla project, but describes general good practices.
|
|
|
|
|