Change 'charse_error' to 'charset_error' in load_files.

'charset_error' is the name used in the documentation; I changed the
function to match it. It checks and deprecates the old name.
Revise documentation about handling text and bytes.
Add a documentation section about decoding text.

This is a stage that has to happen before extracting features. Adding
this documentation helps address a bug report about UnicodeDecodeErrors.
Move the new "Decoding text files" doc section

It should come after the other section that describes text feature
extraction.
Revert "DOC spelling and clarification"

This reverts commit d40caea23f7b504c3d9fa201d98ac5187804697f.
Merge branch 'master' of https://github.com/scikit-learn/scikit-learn
pull request for issue 2116: ticker in yahoo was intermittent for
KFT resulting in a 404 error. It seemed when using ticker MDLZ for
kraft this was resolved. Probably a better fix would be to take out
kraft foods ticker all together. result was to see if there was any
more feedback before making the change.
DOC fix in the hierarchical clustering
DOC Acknowledge sponsors for the Paris sprint
DOC missing stuff in randomized_l1 module

Fixes #2092.
PY3 xrange, np.divide, string.uppsercase, None comparison

Fixes #2108.
MAINT dedup Clay Woolam's contribs (>100 commits!)
FIX/ENH mean shift clustering

* min_bin_freq argument (fixes #2060, but needs a test)
* authors in comment, not docstring
* don't store fitted attributes (trailing _) before fit
DOC typo
ENH micro-optimize RFECV

Skip repeated indexing into X and y.
FIX mbkmeans benchmark bug (k instead of n_clusters)
FIX off-by-one error in neighbors benchmark
ENH lots of benchmarks fixes

* add a title to all benchmark figures/windows
* "bench" is non-standard slang for benchmarking
* remove calls to pyplot.clf because the previous call
  to pyplot.figure sets the current figure
* standardize on "Time (s)" as time axis label
* move some benchmark plot legends to the upper left corner of the plot:
  most benchmarks expand from (0,0) up and to the right
* simplified plot titles and moved constant info from legend into title
* fixed typos
* made some labels more viewer-friendly

Fixes #2023.
COSMIT refactor LibSVM wrapper for safety and readability

* don't pass fit-time parameters to prediction functions
* do memory deallocation in a finally clause
* trim docstrings and comments

TODO:
* fit needs the finally clause as well
* sparse LibSVM should get the same treatment

(test_svc_clone_with_callable_kernel might fail sometimes. That appears
to be unrelated.)
DOC fix some broken URLs