| Index: docs/stability_fixit_week.md
|
| diff --git a/docs/stability_fixit_week.md b/docs/stability_fixit_week.md
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..d6ace66074974343f40a7100c68fb6a888799d9c
|
| --- /dev/null
|
| +++ b/docs/stability_fixit_week.md
|
| @@ -0,0 +1,62 @@
|
| +# Stability Fixit Week
|
| +
|
| +The Chromium project tries hard to avoid bugs.
|
| +We close the tree if even a tiny bug is detected by our continuous test suite.
|
| +For bugs that can't be fixed right away, we file bug reports so developers can fix them offline.
|
| +But after a while, the stack of crash and leak bug reports can be overwhelming
|
| +for a single engineer to attack. So every now and then, we hold
|
| +Stability Fixit Weeks so we can gang up on those bugs, and
|
| +make some headway on the pile.
|
| +
|
| +We're especially interested in bugs taged with Fixit and Valgrind (click for lists):
|
| + * [Valgrind+Fixit](http://crbug.com/?can=2&q=label:Valgrind+Fixit&sort=-id)
|
| +
|
| +but any of the following could also use attention:
|
| + * [Valgrind](http://crbug.com/?can=2&q=label:Valgrind&sort=-id)
|
| + * [Crash](http://crbug.com/?can=2&q=label:crash&sort=-id)
|
| + * [Regression](http://crbug.com/?can=2&q=label:regression&sort=-id)
|
| + * [Fixit](http://crbug.com/?can=2&q=label:fixit&sort=-id)
|
| + * [LinuxBeta](http://crbug.com/?can=2&q=label:Mstone-LinuxBeta&sort=-id)
|
| + * [MacBeta](http://crbug.com/?can=2&q=label:Mstone-MacBeta&sort=-id)
|
| +
|
| +Memory leaks aren't as high priority as other sorts of Valgrind errors, but they're still worth fixing.
|
| +
|
| +To work on Valgrind bugs, it helps to have the tool installed.
|
| +
|
| +Valgrind **is** free; see http://dev.chromium.org/developers/how-tos/using-valgrind for how to install and use it with Chrome on Mac and Linux.
|
| +
|
| +The bug reports usually name the test that exposed the problem; to
|
| +reproduce the problem, you have to run the same test under Valgrind.
|
| +That can be slow, and these bugs are subtle, so while you're waiting, try to understand the bug by inspection of the source code.
|
| +
|
| +If the bug in question is already being suppressed, you may need to remove the suppression before you can see it.
|
| +With Valgrind, it's easy to find and comment out suppressions; they're mostly in tools/valgrind/memcheck/suppressions.txt, and every suppression has an associated bug number. (Mac-specific suppressions are in a nearby file, suppressions\_mac.txt.)
|
| +
|
| +To try to reproduce a problem in a UI test named Foo.Bar with Valgrind, give the command
|
| +```
|
| +tools/valgrind/chrome_tests.sh -t ui --gtest_filter=Foo.Bar
|
| +```
|
| +
|
| +(Generally you should be in the chromium/src directory to run any of these tests.)
|
| +
|
| +Layout tests are a bit different.
|
| +
|
| +To try to reproduce a problem in a test named LayoutTests/fast/loader/local-css-from-local-html.html with Valgrind, you would give the command
|
| +```
|
| +tools/valgrind/valgrind_webkit_tests.sh LayoutTests/fast/loader/local-css-from-local-html.html
|
| +```
|
| +This will eventually produce output on stdout, but rather than wait, you can look in the current directory for its temporary log files while it's still producing them.
|
| +
|
| +Sometimes problems only happen occasionally; you might want to write a little script to run your test in a loop. Or you might run a wide overnight fishing expedition to see if you can find any valgrind errors
|
| +at all in one area of the tests.
|
| +
|
| +Note that the only kind of leak reports we care about from Valgrind are those marked "definitely leaked". Ones marked "possibly leaked" should usually be ignored.
|
| +
|
| +## See Also
|
| +
|
| + * StabilizeTrunk
|
| + * LayoutTestsLinux
|
| + * LinuxDebugging
|
| + * [RunningChromeUITests](RunningChromeUITests.md)
|
| + * http://dev.chromium.org/developers/how-tos/using-valgrind
|
| + * http://dev.chromium.org/developers/testing
|
|
|