matplotlib / matplotlib

Improve various release notes

Fix clearing selector

Improve `path.py` docstrings a bit

Move installing FAQ to installing page.

Fix cubic curve code in `Path.__doc__`

Since Sphinx treats these lines as mostly a single paragraph, this is a
by-rote commit to re-wrap everything properly. Do not expect the entire
file to look good; it just will no longer randomly switch between bold
and not.

The only non-rote change is to turn the release message into a section
heading.

And tweak some of the wording.

Though, I left out anything older than 1.0, since those are all
aggregated at the end.

People with install problems will primarily look at the install page,
not the general FAQ page.

Question: Should we move the page in the file structure as well?
Con: External pages linking the FAQ will be broken. I wouldn't worry
     too much about this. Who links install FAQs anyway? And I trust
     that even with a broken Link people will look at Installing.
Pro: The file structure corresponds to the toc structure.

And make all the title consistent.

Fixes #6864.

and->are

Started as a type fix not->no, ended up rewriting/breaking up the paragraph.

Reword BoundaryNorm docs.

In particular, move the `Returns` block from `__init__` to `__call__`,
where it actually belongs.  I believe that Norms are low-level enough
constructs that it is sufficient to just refer to the base class
docstring, without going through fancy docstring interpolation.

…t for all selector

Add dependency link for 3.5

Label pylab as "discouraged" instead of "disapproved"

Some native speaker please check, but I think *discouraged* is the better word.

While the target does not exist yet, it will with the release and the
released 3.5 doc should link to its own dependencies.

Also removed `#dependencies` anchor because that's the top-level heading
on that page, so we can simply link that page itself.

…ector

Fix setting artists properties of selectors

TST: Add Python 3.10 testing.

Co-authored-by: Tim Hoffmann <[email protected]>

Ensure full environment is passed to headless test.