big doc and format cleanup
Merge pull request #682 from goodfeli/fix_init_docstring

big doc and format cleanup