PR summary

I recently came across a use case where I wanted to manually tweak axis limits, but also apply the margins which are added when autoscaling. It took me a while to figure out how to do this in an elegant way that would avoid computing the margins manually (in order to defer to Matplotlib for this): by modifying theAxes.dataLim bounding box and re-applying autoscaling. SinceAxes.set_{x,y}lim is the most straightforward starting point when considering axis limits tweaks, I think it would make sense to document this approach there, as a helpful hint to anyone trying to do something similar.

I understand this might not be wanted for a variety of reasons, or perhaps you'd rather put this somewhere else than in the API docs for theAxes.set_{x,y}lim functions, or perhaps you'd just phrase it differently. I just wanted to start the conversation over a concrete suggestion; that's why a PR instead of just opening an issue. I do think that it would be useful to document this somewhere, preferably in a way that's reachable from theAxes.set_{x,y}lim docs, but I'm not too particular about the details and would be happy to take suggestions about places which might be a better fit.

PR checklist

• [N/A] "closes #0000" is in the body of the PR description tolink the related issue
• [N/A] new and changed code istested
• [N/A]Plotting related features are demonstrated in anexample
• [N/A]New Features andAPI Changes are noted with adirective and release note
• Documentation complies withgeneral anddocstring guidelines