DOC: function args, kwargs, and class arguments badly need documenting

[dohmatob]

Though it took me only a few moments to figure out what the code was doing,

it'd be good to have minimal documentation for function args (max_bets, holecards, etc.) and class attributes (I'm not talking about pep*, who cares :) ). This can be done progressively.

[tansey]

I'd certainly welcome better documentation. :)