some documentation
make compile method private
move __init__ documentaiton to match werkzeug style