pygame / test / util /

Full commit
For finding out what is not documented.

python pygame.sprite sprite.doc

An example showing how to compare what the .doc docs have in them
 with what the module has in them.

For example, to see what the sprite.doc has documented compared to what the
  sprite module actually has in it.

To be move to 

import sys, os
#import pygame.sprite

#the_module = pygame.sprite
#the_doc = "sprite.doc"

#if 1:
    the_module = __import__(sys.argv[-2])
    last_part = sys.argv[-2].split(".")[-1]
    print last_part
    the_module = getattr(the_module, last_part)

    the_doc = sys.argv[-1]
    print "useage:\n  python pygame.sprite sprite.doc"

# put in the path.
sys.path.append(os.path.join("..", ".."))
from makeref import Doc

f = None
f2 = None
f = os.path.join("..", "..", "lib", the_doc)
if not os.path.exists(f):
    f2 = os.path.join("..", "..", "src", the_doc)
    if not os.path.exists(f2):
        raise "paths do not exist :%s:    :%s:" % (f,f2)
        f = f2


d = Doc('', open(f, "U"))

print d
for x in dir(d):
    print ":%s:" % x, getattr(d, x)
#def obj_doc_file():

print "\n\n"
print "Stuff in docs - the_module.  In the_module, not in docs:"
print set(dir(the_module)) - set([ for x in])
print "-" * 20

print "\n\n"
print "stuff in docs - the_module.   In docs, not in the_module."
print set([ for x in]) - set(dir(the_module)) 

print "\n\n"
print "everything in the module."
print set(dir(the_module))