You are reading an old version of the documentation (v3.1.0). For the latest version see https://matplotlib.org/stable/api/prev_api_changes/api_changes_0.80.html
Version 3.1.0
matplotlib
Fork me on GitHub

Changes for 0.80ΒΆ

- xlim/ylim/axis always return the new limits regardless of
  arguments.  They now take kwargs which allow you to selectively
  change the upper or lower limits while leaving unnamed limits
  unchanged.  See help(xlim) for example