New PR for docstrings

I am opening a new PR replacing https://github.com/lisa-lab/pylearn2/pull/535. @vdumoulin sent a PR to my repo but he sent it to my master branch instead of to my doc_train branch, so it didn't update the old PR.