Update sphinx to 1.6.5

[pyup-bot]

There's a new version of Sphinx available.
You are currently using 1.5.1. I have updated it to 1.6.5

These links might come in handy: PyPI | Changelog | Homepage

Changelog

1.6.5

=====================================

Features added

• 4107: Make searchtools.js compatible with pre-Sphinx1.5 templates
• 4112: Don't override the smart_quotes setting if it was already set
• 4125: Display reference texts of original and translated passages on
  i18n warning message
• 4147: Include the exception when logging PO/MO file read/write

Bugs fixed

• 4085: Failed PDF build from image in parsed-literal using :align: option
• 4100: Remove debug print from autodoc extension
• 3987: Changing theme from alabaster causes HTML build to fail
• 4096: C++, don't crash when using the wrong role type. Thanks to mitya57.
• 4070, 4111: crashes when the warning message contains format strings (again)
• 4108: Search word highlighting breaks SVG images
• 3692: Unable to build HTML if writing .buildinfo failed
• 4152: HTML writer crashes if a field list is placed on top of the document
• 4063: Sphinx crashes when labeling directive .. todolist::
• 4134: [doc] :file:docutils.conf is not documented explicitly
• 4169: Chinese language doesn't trigger Chinese search automatically
• 1020: ext.todo todolist not linking to the page in pdflatex
• 3965: New quickstart generates wrong SPHINXBUILD in Makefile
• 3739: :module: option is ignored at content of pyobjects
• 4149: Documentation: Help choosing :confval:latex_engine
• 4090: [doc] :confval:latex_additional_files with extra LaTeX macros should
  not use .tex extension
• Failed to convert reST parser error to warning (refs: 4132)

1.6.4

=====================================

Features added

• 3926: Add autodoc_warningiserror to suppress the behavior of -W
  option during importing target modules on autodoc

Bugs fixed

• 3924: docname lost after dynamically parsing RST in extension
• 3946: Typo in sphinx.sty (this was a bug with no effect in default context)
• :pep: and :rfc: does not supports default-role directive (refs: 3960)
• 3960: default_role = 'guilabel' not functioning
• Missing texinputs_win/Makefile to be used in latexpdf builder on windows.
• 4026: nature: Fix macOS Safari scrollbar color
• 3877: Fix for C++ multiline signatures.
• 4006: Fix crash on parallel build
• 3969: private instance attributes causes AttributeError
• 4041: C++, remove extra name linking in function pointers.
• 4038: C, add missing documentation of member role.
• 4044: An empty multicolumn cell causes extra row height in PDF output
• 4049: Fix typo in output of sphinx-build -h
• 4062: hashlib.sha1() must take bytes, not unicode on Python 3
• Avoid indent after index entries in latex (refs: 4066)
• 4070: crashes when the warning message contains format strings
• 4067: Return non-zero exit status when make subprocess fails
• 4055: graphviz: the :align: option does not work for SVG output
• 4055: graphviz: the :align: center option does not work for latex output
• 4051: warn() function for HTML theme outputs 'None' string

1.6.3

=====================================

Features added

• latex: hint that code-block continues on next page (refs: 3764, 3792)

Bugs fixed

• 3821: Failed to import sphinx.util.compat with docutils-0.14rc1
• 3829: sphinx-quickstart template is incomplete regarding use of alabaster
• 3772: 'str object' has no attribute 'filename'
• Emit wrong warnings if citation label includes hyphens (refs: 3565)
• 3858: Some warnings are not colored when using --color option
• 3775: Remove unwanted whitespace in default template
• 3835: sphinx.ext.imgmath fails to convert SVG images if project directory
  name contains spaces
• 3850: Fix color handling in make mode's help command
• 3865: use of self.env.warn in sphinx extension fails
• 3824: production lists apply smart quotes transform since Sphinx 1.6.1
• latex: fix \sphinxbfcode swallows initial space of argument
• 3878: Quotes in auto-documented class attributes should be straight quotes
  in PDF output
• 3881: LaTeX figure floated to next page sometimes leaves extra vertical
  whitespace
• 3885: duplicated footnotes raises IndexError
• 3873: Failure of deprecation warning mechanism of
  sphinx.util.compat.Directive
• 3874: Bogus warnings for "citation not referenced" for cross-file citations
• 3860: Don't download images when builders not supported images
• 3860: Remote image URIs without filename break builders not supported remote
  images
• 3833: command line messages are translated unintentionally with language
  setting.
• 3840: make checking epub_uid strict
• 3851, 3706: Fix about box drawing characters for PDF output
• 3900: autosummary could not find methods
• 3902: Emit error if latex_documents contains non-unicode string in py2

1.6.2

=====================================

Incompatible changes

• 3789: Do not require typing module for python>=3.5

Bugs fixed

• 3754: HTML builder crashes if HTML theme appends own stylesheets
• 3756: epub: Entity 'mdash' not defined
• 3758: Sphinx crashed if logs are emitted in conf.py
• 3755: incorrectly warns about dedent with literalinclude
• 3742: RTD <https://readthedocs.org/>_ PDF builds of Sphinx own docs are
  missing an index entry in the bookmarks and table of contents. This is
  rtfd/readthedocs.org2857 <https://github.com/rtfd/readthedocs.org/issues/2857>_ issue, a workaround
  is obtained using some extra LaTeX code in Sphinx's own :file:conf.py
• 3770: Build fails when a "code-block" has the option emphasize-lines and the
  number indicated is higher than the number of lines
• 3774: Incremental HTML building broken when using citations
• 3763: got epubcheck validations error if epub_cover is set
• 3779: 'ImportError' in sphinx.ext.autodoc due to broken 'sys.meta_path'.
  Thanks to Tatiana Tereshchenko.
• 3796: env.resolve_references() crashes when non-document node given
• 3803: Sphinx crashes with invalid PO files
• 3791: PDF "continued on next page" for long tables isn't internationalized
• 3788: smartquotes emits warnings for unsupported languages
• 3807: latex Makefile for make latexpdf is only for unixen
• 3781: double hyphens in option directive are compiled as endashes
• 3817: latex builder raises AttributeError

1.6.1

=====================================

Dependencies

1.6

• LDML format support in i18n feature
• sphinx.addnodes.termsep
• Some functions and classes in sphinx.util.pycompat:
  zip_longest, product, all, any, next, open,
  class_types, base_exception, relpath, StringIO, BytesIO.
  Please use the standard library version instead;

If any deprecation warning like RemovedInSphinxXXXWarning are displayed,
please refer :ref:when-deprecation-warnings-are-displayed.

Features added

1.6b3

• 3588: No compact (p tag) html output in the i18n document build even when
  :confval:html_compact_lists is True.
• The make latexpdf from 1.6b1 (for GNU/Linux and Mac OS, using
  latexmk) aborted earlier in case of LaTeX errors than was the case with
  1.5 series, due to hard-coded usage of --halt-on-error option. (refs 3695)
• 3683: sphinx.websupport module is not provided by default
• 3683: Failed to build document if builder.css_file.insert() is called
• 3714: viewcode extension not taking highlight_code='none' in account
• 3698: Moving :doc: to std domain broke backwards compatibility
• 3633: misdetect unreferenced citations

1.6b2

• 3662: builder.css_files is deprecated. Please use add_stylesheet()
  API instead.

1.6b1

• sphinx.util.compat.Directive class is now deprecated. Please use instead
  docutils.parsers.rst.Directive
• sphinx.util.compat.docutils_version is now deprecated
• 2367: Sphinx.warn(), Sphinx.info() and other logging methods are now
  deprecated. Please use sphinx.util.logging (:ref:logging-api) instead.
• 3318: notice is now deprecated as LaTeX environment name and will be
  removed at Sphinx 1.7. Extension authors please use sphinxadmonition
  instead (as Sphinx does since 1.5.)
• Sphinx.status_iterator() and Sphinx.old_status_iterator() is now
  deprecated. Please use sphinx.util:status_iterator() instead.
• Sphinx._directive_helper() is deprecated. Please use
  sphinx.util.docutils.directive_helper() instead.
• BuildEnvironment.set_warnfunc() is now deprecated
• Following methods of BuildEnvironment is now deprecated.

• BuildEnvironment.note_toctree()
• BuildEnvironment.get_toc_for()
• BuildEnvironment.get_toctree_for()
• BuildEnvironment.create_index()

Please use sphinx.environment.adapters modules instead.

• latex package footnote is not loaded anymore by its bundled replacement
  footnotehyper-sphinx. The redefined macros keep the same names as in the
  original package.
• 3429: deprecate config setting latex_keep_old_macro_names. It will be
  removed at 1.7, and already its default value has changed from True to
  False.
• 3221: epub2 builder is deprecated
• 3254: sphinx.websupport is now separated into independent package;
  sphinxcontrib-websupport. sphinx.websupport will be removed in
  Sphinx-2.0.
• 3628: sphinx_themes entry_point is deprecated. Please use
  sphinx.html_themes instead.

1.5.6

=====================================

Bugs fixed

• 3614: Sphinx crashes with requests-2.5.0
• 3618: autodoc crashes with tupled arguments
• 3664: No space after the bullet in items of a latex list produced by Sphinx
• 3657: EPUB builder crashes if document startswith genindex exists
• 3588: No compact (p tag) html output in the i18n document build even when
  :confval:html_compact_lists is True.
• 3685: AttributeError when using 3rd party domains
• 3702: LaTeX writer styles figure legends with a hard-coded \small
• 3708: LaTeX writer allows irc scheme
• 3717: Stop enforcing that favicon's must be .ico
• 3731, 3732: Protect isenumclass predicate against non-class arguments
• 3320: Warning about reference target not being found for container types
• Misspelled ARCHIVEPREFIX in Makefile for latex build repertory

1.5.5

=====================================

Bugs fixed

• 3597: python domain raises UnboundLocalError if invalid name given
• 3599: Move to new Mathjax CDN

1.5.4

=====================================

Features added

• 3470: Make genindex support all kinds of letters, not only Latin ones

Bugs fixed

• 3445: setting 'inputenc' key to \\usepackage[utf8x]{inputenc} leads
  to failed PDF build
• EPUB file has duplicated nav.xhtml link in content.opf
  except first time build
• 3488: objects.inv has broken when release or version contain
  return code
• 2073, 3443, 3490: gettext builder that writes pot files unless the content
  are same without creation date. Thanks to Yoshiki Shibukawa.
• 3487: intersphinx: failed to refer options
• 3496: latex longtable's last column may be much wider than its contents
• 3507: wrong quotes in latex output for productionlist directive
• 3533: Moving from Sphinx 1.3.1 to 1.5.3 breaks LaTeX compilation of links
  rendered as code
• 2665, 2607: Link names in C++ docfields, and make it possible for other domains.
• 3542: C++, fix parsing error of non-type template argument with template.
• 3065, 3520: python domain fails to recognize nested class
• 3575: Problems with pdflatex in a Turkish document built with sphinx has
  reappeared (refs 2997, 2397)
• 3577: Fix intersphinx debug tool
• A LaTeX command such as \\large inserted in the title items of
  :confval:latex_documents causes failed PDF build (refs 3551, 3567)

1.5.3

=====================================

Features added

• Support requests-2.0.0 (experimental) (refs: 3367)
• (latex) PDF page margin dimensions may be customized (refs: 3387)
• literalinclude directive allows combination of :pyobject: and
  :lines: options (refs: 3416)
• 3400: make-mode doesn't use subprocess on building docs

Bugs fixed

• 3370: the caption of code-block is not picked up for translation
• LaTeX: :confval:release is not escaped (refs: 3362)
• 3364: sphinx-quickstart prompts overflow on Console with 80 chars width
• since 1.5, PDF's TOC and bookmarks lack an entry for general Index
  (refs: 3383)
• 3392: 'releasename' in :confval:latex_elements is not working
• 3356: Page layout for Japanese 'manual' docclass has a shorter text area
• 3394: When 'pointsize' is not 10pt, Japanese 'manual' document
  gets wrong PDF page dimensions
• 3399: quickstart: conf.py was not overwritten by template
• 3366: option directive does not allow punctuations
• 3410: return code in :confval:release breaks html search
• 3427: autodoc: memory addresses are not stripped on Windows
• 3428: xetex build tests fail due to fontspec v2.6 defining \strong
• 3349: Result of IndexBuilder.load() is broken
• 3450: &nbsp is appeared in EPUB docs
• 3418: Search button is misaligned in nature and pyramid theme
• 3421: Could not translate a caption of tables
• 3552: linkcheck raises UnboundLocalError

1.5.2

=====================================

Incompatible changes

• Dependency requirement updates: requests 2.4.0 or above (refs: 3268, 3310)

Features added

• 3241: emit latex warning if buggy titlesec (ref 3210)
• 3194: Refer the $MAKE environment variable to determine make command
• Emit warning for nested numbered toctrees (refs: 3142)
• 978: intersphinx_mapping also allows a list as a parameter
• 3340: (LaTeX) long lines in :dudir:parsed-literal are wrapped like in
  :rst:dir:code-block, inline math and footnotes are fully functional.

Bugs fixed

• 3246: xapian search adapter crashes
• 3253: In Py2 environment, building another locale with a non-captioned
  toctree produces None captions
• 185: References to section title including raw node has broken
• 3255: In Py3.4 environment, autodoc doesn't support documentation for
  attributes of Enum class correctly.
• 3261: latex_use_parts makes sphinx crash
• The warning type misc.highlighting_failure does not work
• 3294: add_latex_package() make crashes non-LaTeX builders
• The caption of table are rendered as invalid HTML (refs: 3287)
• 3268: Sphinx crashes with requests package from Debian jessie
• 3284: Sphinx crashes on parallel build with an extension which raises
  unserializable exception
• 3315: Bibliography crashes on latex build with docclass 'memoir'
• 3328: Could not refer rubric implicitly
• 3329: emit warnings if po file is invalid and can't read it. Also writing mo too
• 3337: Ugly rendering of definition list term's classifier
• 3335: gettext does not extract field_name of a field in a field_list
• 2952: C++, fix refs to operator() functions.
• Fix Unicode super- and subscript digits in :rst:dir:code-block and
  parsed-literal LaTeX output (ref 3342)
• LaTeX writer: leave " character inside parsed-literal as is (ref 3341)
• 3234: intersphinx failed for encoded inventories
• 3158: too much space after captions in PDF output
• 3317: An URL in parsed-literal contents gets wrongly rendered in PDF if
  with hyphen
• LaTeX crash if the filename of an image inserted in parsed-literal
  via a substitution contains an hyphen (ref 3340)
• LaTeX rendering of inserted footnotes in parsed-literal is wrong (ref 3340)
• Inline math in parsed-literal is not rendered well by LaTeX (ref 3340)
• 3308: Parsed-literals don't wrap very long lines with pdf builder (ref 3340)
• 3295: Could not import extension sphinx.builders.linkcheck
• 3285: autosummary: asterisks are escaped twice
• LaTeX, pass dvipdfm option to geometry package for Japanese documents (ref 3363)
• Fix parselinenos() could not parse left half open range (cf. "-4")

Got merge conflicts? Close this PR and delete the branch. I'll create a new PR for you.

Happy merging! 🤖