checkapidoc: new ApiDocs utility for checking the completeness of the doc.
checkapidoc: new ApiDocs utility for checking the completeness of the doc.

This little tool can be used to verify if we referenced all the symbols
for which a documentation exist in the appropriate file below doc/api.

Example:
{{{
$ PYTHONPATH=. python doc/utils/checkapidoc.py doc/api/trac_util_text.rst
Warning: trac.util.text doesn't define __all__, using exported symbols.
 * ..   autofunction :: levenshtein_distance
 * ..   autofunction :: stripws
 * ..   autofunction :: to_js_string
}}}
3 missing symbols, ready to be added.

Usage:
{{{
$ PYTHONPATH=. python doc/utils/checkapidoc.py -h
Usage: doc/utils/checkapidoc.py [FILE...]

FILE is a doc/api file and can be a glob pattern.
If no files are given, check all.
}}}

Bonus:
 - when specifying `-a`, all the public symbols are output, even those which don't have a `__doc__` string.
 - when specifying `-v`, the already documented symbols are shown as well, not just the missing ones


git-svn-id: f68c6b3b1dcd5d00a2560c384475aaef3bc99487@11174 af82e41b-90c4-0310-8c96-b1721e28e2e2

dafrito/trac-mirror,dafrito/trac-mirror,dafrito/trac-mirror,dafrito/trac-mirror