1This directory only contains tests for outstanding bugs that cause the
2interpreter to segfault.  Ideally this directory should always be empty, but
3sometimes it may not be easy to fix the underlying cause and the bug is deemed
4too obscure to invest the effort.
5
6Each test should fail when run from the command line:
7
8	./python Lib/test/crashers/weakref_in_del.py
9
10Put as much info into a docstring or comments to help determine the cause of the
11failure, as well as a bugs.python.org issue number if it exists.  Particularly
12note if the cause is system or environment dependent and what the variables are.
13
14Once the crash is fixed, the test case should be moved into an appropriate test
15(even if it was originally from the test suite).  This ensures the regression
16doesn't happen again.  And if it does, it should be easier to track down.
17
18Also see Lib/test_crashers.py which exercises the crashers in this directory.
19In particular, make sure to add any new infinite loop crashers to the black
20list so it doesn't try to run them.
21