DOC/BLD: Fix a bunch of doc build warnings that weren't being previously caught

[cpcloud]

No description provided.

[cpcloud]

@jreback wut do u think about the deprecation message here? merge-able?

[jreback]

looks fine

[jreback]

@cpcloud nothing to do with theis PR...but can you make some of the read_html ipython blocks actually be code blocks (so for example it doesn't do some of the ops., maybe the last 2 (lxml parsing and using fallback parsing), maybe even a couple of others....e.g. just give the commands, don't actually do them....

building io docs takes a lot longer now

alternatively, maybe there is a way to build docs while disabling network type things? (e.g when you are working on other docs...)?

[cpcloud]

oh yeah duh sorry i had a thought to do this b/c of the ntwk issue.

[cpcloud]

i wonder if there's a sphinx ext for this

[cpcloud]

nope sigh

[cpcloud]

@jreback what about using the data i've provided in the tests? (will still mark a bunch as code-block)

[cpcloud]

eh nvm i 'll just give an exmaple using that..i need to write one for file readin ganyway

[jreback]

for the docs maybe cache it (read from a static file)

[cpcloud]

should i put in doc/data?

[cpcloud]

not sure how to cache things in sphinx

[cpcloud]

i could make a single network call, download it and trhen clean up... or two network calls...to show that passing a url works and then another to download...

[jreback]

put in source/_static

where the png files r

[cpcloud]

ok...do i need to pass the exact path or is there some sphinx magic there to just pas the filename alone and it will look there...?

[jreback]

look in doc for HDF5
I do this to read in a legacy file

[cpcloud]

thanks