I tried to solve a problem found by pyflakes, which on master gives this:

    utils.py:191: 'deprecated_func' imported but unused

so I guessed that the intention was to show that if you import deprecated_func and ask python what deprecated_func is, then what is shown is that it's actually mne.utils.deprecated because of the deprecated decorator, does that make sense?

Whereas the code:

    from mne.utils import deprecated_func
    deprecated()

produces an error because *deprecated* is not defined.

Thanks for bringing up this change, I'm quite curious whether I got the gist of what the example was intended to show.