vulture finds unused classes, functions and variables in your code. This helps
-you cleanup and find errors in the your programs. If you run it on your library
-and test suite you can find untested code.
+you cleanup and find errors in your programs. If you run it on both your
+library and test suite you can find untested code.
+Due to Python's dynamic nature it is impossible to find all dead code for a
+static code analyzer like vulture, because it ignores scopes and scans only
+token names. Additionally some dynamic items that are not explicitly mentioned
+in the code may be incorrectly reported as dead code.
+* Fast: Uses static code analysis
+* Lightweight: Only one module
+* Tested: Comes with a test suite
+* Complements *pyflakes* and has the same output syntax
+* vulture can be used together with *pyflakes*
+* The *coverage* module can find unused code more reliably, but requires all
+ branches of the code to actually be run.
A *vulture* eats dead animals. A group of feeding vultures is called a *wake*.