read_csv Documentation Rendering Poorly

[WillAyd]

Looks like the filepath_or_buffer argument is rendering poorly in the read_csv documentation:

Should be a pretty easy doc fix:

pandas/pandas/io/parsers.py

Line 63 in edb71fd

filepath_or_buffer : str, pathlib.Path, py._path.local.LocalPath or any \

[gfyoung]

Seems to be a change in the rendering code (here / upstream). That line hasn't changed in awhile. It looks fine in the 0.22.0 docs, but looks like what you posted starting in 0.23.0.

That being said, I generally prefer one-liner data type descriptions, so we can take this opportunity to shorten it for ease of reading anyhow.

[WillAyd]

@gfyoung that's correct, though I'm under the impression that we may have just been getting lucky previously. I'm not sure of any other docstring that has a continuation like that so I'm under the impression that's what needs to be fixed, but lmk if you have other ideas

[gfyoung]

@WillAyd : Oh, I agree that we can reword this. I'll put up a PR shortly.

[jorisvandenbossche]

Normally such continuation lines should work, that is the general solution in case you need a multi-line (in essence a single line due to the \ :)) type description.

Maybe it has to do with the fact that it is a raw (r""") string?

[gfyoung]

@jorisvandenbossche : Right. Hard to tell since we never changed it since 0.22.0 at least (and it "breaks" in the 0.23.0 docs even though nothing happened to that line AFAICT).