Merge pull request #3125 from jfbu/updatebabeldoclatex

update documentation of latex keys

doc/config.rst

@@ -1712,7 +1712,14 @@ These options influence LaTeX output. See further :doc:`latex`.
 
         .. versionadded:: 1.5
      ``'babel'``
-        "babel" package inclusion, default ``'\\usepackage{babel}'``.
+        "babel" package inclusion, default ``'\\usepackage{babel}'`` (the
+        suitable document language string is passed as class option, and
+        ``english`` is used if no language.) For Japanese documents, the
+        default is the empty string.
+
+        .. versionchanged:: 1.5
+           For :confval:`latex_engine` set to ``'xelatex'``, the default
+           is ``'\\usepackage{polyglossia}\n\\setmainlanguage{<language>}'``.
      ``'fontpkg'``
         Font package inclusion, default ``'\\usepackage{times}'`` (which uses
         Times and Helvetica).  You can set this to ``''`` to use the Computer
@@ -1721,6 +1728,8 @@ These options influence LaTeX output. See further :doc:`latex`.
         .. versionchanged:: 1.2
            Defaults to ``''`` when the :confval:`language` uses the Cyrillic
            script.
+        .. versionchanged:: 1.5
+           Defaults to ``''`` when :confval:`latex_engine` is ``'xelatex'``.
      ``'fncychap'``
         Inclusion of the "fncychap" package (which makes fancy chapter titles),
         default ``'\\usepackage[Bjarne]{fncychap}'`` for English documentation
@@ -1780,6 +1789,10 @@ These options influence LaTeX output. See further :doc:`latex`.
         .. versionadded:: 1.2
      ``'fontenc'``
         "fontenc" package inclusion, default ``'\\usepackage[T1]{fontenc}'``.
+
+        .. versionchanged:: 1.5
+           Defaults to ``'\\usepackage{fontspec}'`` when
+           :confval:`latex_engine` is ``'xelatex'``.
      ``'hyperref'``
         "hyperref" package inclusion; also loads package "hypcap" and issues
         ``\urlstyle{same}``. This is done after :file:`sphinx.sty` file is