[MRG] FIX: some python3 errors while building the doc

Some fixes I had to make to compile sklearn with latests sphinx and python 3 (it still does not fully compile but I think this is a step forward).

Those are encoding errors that are fixed for both python 2, 3 by using io.open instead of open.