In Python 3, the default encoding of source files is utf-8. The encoding
cookie is now unnecessary and redundant so remove it. For more details,
see the docs:
https://docs.python.org/3/howto/unicode.html#the-string-type
> The default encoding for Python source code is UTF-8, so you can
> simply include a Unicode character in a string literal ...
Includes a fix for the flake8 header checks to stop expecting an
encoding cookie.
This option defines maximum section depth that labels will be
generated for by the autosectionlabel extension.
This is useful when there are a lot of sections of the similar
structure, for example:
Releases
========
Release 1
---------
Changes
^^^^^^^
Date
^^^^
...
Release N
---------
Changes
^^^^^^^
Date
^^^^
This way there'll be warnings about duplicate labels. Setting
autosectionlabel_max_depth allows to skip sections deeper than
'Releases' in the example above.
By default it's None, so things will not change and labels will
be generated for all sections unless configured otherwise.
