DOC: update docstrings, whitespace in diagnostics
DOC: update docstring for pca

Note parameter is optional
RF: fix travis build for pip change