I've found two problems in the documentation of axes:

1. In the docstring of set_xlim() and set_ylim(), it read: "Set the data limits for the xaxis". It should be view limits instead, which is very confusing.
2. In the docstring of autoscale_view(), it should be mentioned that, if set_xlim() or set_ylim() has been called on the same axes before, autoscale_view() will not work (because _autoscaleXon would have been set to False by the above two functions) and autoscale() should be used instead.