Files changed (14)
-When using, testing, developping distutils2, you may encounter issues. Please report to the following sections to know how these issues should be reported.
+When using, testing or developping distutils2, you may encounter issues. Please report to the following sections to know how these issues should be reported.
-Please keep in mind that this guide is intended to ease the triage and fixing processes by giving the maximum information to the developers. It should not be viewed as mandatory, only advised ;).
+Please keep in mind that this guide is intended to ease the triage and fixing processes by giving the maximum information to the developers. It should not be viewed as mandatory, only advisory ;).
- Go to http://bugs.python.org/ (you'll need a Python Bugs account), then "Issues" > "Create ticket".
- * You may prefix the issue title with [d2_component], where d2_component can be : installer, sdist, setup.cfg, ... This will ease up the triage process.
+- **Title**: write in a short summary of the issue. You may prefix the issue title with “component:”, where component can be something like installer, sdist, setup.cfg, etc., or add it at the end of your title if the normal flow of the sentence allows it. This will ease up later searches.
- * If some of the fields presented don't apply to the issue, feel free to pick only the ones you need.
+- **Body**: explain how to reproduce the bug: What you want to do, what code you write, what happens, what should happen, how to fix it (if you have an idea).
+ * If relevant, mention the version of your operating system (for example with issues related to C extensions).
+ * When referencing commits, be careful to use the universal changeset identifiers (12 characters, for instance c3cf81fc64db), not the local sequential numbers (for example 925) that are not shared among clones.
+ * If useful, attach setup.cfg or other files (binary files like archives are not very convenient, better to stick to text).
- * **What should happen**: indicate what you think should be the result of the test case (wanted behaviour).
- - If you're using a release of distutils2, you may want to test the latest version of the project (under developpment code).
- - If the issue is present in the latest version, please indicate the tip commit of the version tested.
- - Be careful to indicate the remote reference (12 characters, for instance c3cf81fc64db), not the local reference (rXXX).
-- If it is relevant, please join any file that will help reproducing the issue or logs to understand the problem (setup.cfg, strace ouptups, ...).
+LIB=$( python3.1 -c "from distutils.util import get_platform; import sys; print('lib.%s-%s' % (get_platform(), sys.version[0:3]))" )