Commit Graph

2428 Commits

Author SHA1 Message Date
jfbu
6f08c09ecb Improve Table of Deprecated APIs for LaTeX output (docs) 2018-09-22 11:44:04 +02:00
Takeshi KOMIYA
98648325aa Merge branch '1.8' 2018-09-22 17:16:24 +09:00
Takeshi KOMIYA
ae12f357c7 Fix #5463: mathbase: math_role and MathDirective was disappeared in 1.8.0 2018-09-21 23:44:11 +09:00
Takeshi KOMIYA
a912d90440 doc: app.info() should allow keyword argument 2018-09-20 20:32:41 +09:00
Takeshi KOMIYA
48d4a52276 doc: Update workaround for RTD 2018-09-20 20:29:56 +09:00
Takeshi KOMIYA
a4843cab2c Fix typo 2018-09-20 20:27:25 +09:00
Takeshi KOMIYA
134bcde40b Add workaround for RTD (refs: #5461) 2018-09-20 20:17:21 +09:00
Takeshi KOMIYA
efdc95ef8b Merge branch '1.8' 2018-09-13 00:53:09 +09:00
Jon Dufresne
490e4aed41 Remove unnecessary object from class definitions
In Python 3, all classes are new-style classes. The object in the
definition is redundant and unnecessary.
2018-09-11 07:07:01 -07:00
Takeshi KOMIYA
b2b833d39e Update CHANGES for PR #5403 2018-09-10 20:45:16 +09:00
Takeshi KOMIYA
ffaa528c98 Merge pull request #5390 from tk0miya/4018_htmlhelp_file_suffix
Fix #4018: htmlhelp: Add htmlhelp_file_suffix and htmlhelp_link_suffix
2018-09-09 19:35:49 +09:00
Takeshi KOMIYA
02afc357ef Merge branch '1.8' 2018-09-09 19:26:48 +09:00
Takeshi KOMIYA
07fd1c0680 Fix #4018: htmlhelp: Add htmlhelp_file_suffix and htmlhelp_link_suffix 2018-09-08 23:11:14 +09:00
Takeshi KOMIYA
8e729b419e Fix #5399: Sphinx crashes if unknown po file exists 2018-09-08 22:21:59 +09:00
Takeshi KOMIYA
86abb57577 Fix #5362: apidoc: Add `--toc` option to change the filename of ToC 2018-09-06 18:29:44 +09:00
Takeshi KOMIYA
342de4f0fd Merge branch '1.8' 2018-09-05 23:10:20 +09:00
Takeshi KOMIYA
aa3e590d5e Merge pull request #5370 from tk0miya/drop_deprecated_methods
Drop APIs deprecated in 2.0
2018-09-05 22:56:02 +09:00
Takeshi KOMIYA
79de756423 Merge pull request #5342 from tk0miya/drop_py2_support
Update requirements and dependencies for Sphinx-2.0
2018-09-05 22:55:07 +09:00
Takeshi KOMIYA
abcb5bd5ec The default setting for master_doc is changed to 'index' 2018-09-04 01:14:16 +09:00
TAKEDA-Takashi
683cccac4d docs: Fix wrong name of MecabSplitter 2018-09-03 16:18:24 +09:00
Takeshi KOMIYA
daac35cda7 doc: Add versionadded label (refs: #5029) 2018-09-03 10:46:38 +09:00
Takeshi KOMIYA
a7cab001d9 Drop APIs deprecated in 2.0 2018-09-03 00:31:33 +09:00
Timotheus Kampik
1a801524c6 Merge branch 'master' into 1618-make-search-results-reader-friendly 2018-08-29 19:01:13 +02:00
Takeshi KOMIYA
07e387b335 Merge pull request #5357 from tk0miya/4182_suppress_warnings_for_autodoc
Fix #4182: autodoc: Support :confval:`suppress_warnings`
2018-08-30 01:07:45 +09:00
Takeshi KOMIYA
deca8047ae LaTeX builder now depends on TeX Live 2015 or above 2018-08-30 01:03:57 +09:00
Timotheus Kampik
2aca8d0cd6 Merge remote-tracking branch 'upstream/master' into 1618-make-search-results-reader-friendly 2018-08-28 19:22:49 +02:00
Timotheus Kampik
26bd565dee Merge branch 'master' into 1618-make-search-results-reader-friendly 2018-08-27 21:34:43 +02:00
Takeshi KOMIYA
8c4de32c7d Fix #4182: autodoc: Support :confval:suppress_warnings 2018-08-26 23:29:00 +09:00
Takeshi KOMIYA
864ded3d8a Merge pull request #5343 from tk0miya/5340_update_docs
docs: Fix wrong descriptions for logging APIs
2018-08-26 11:30:51 +09:00
Takeshi KOMIYA
0a485740a8 docs: Fix wrong descriptions for logging APIs 2018-08-25 10:59:04 +09:00
Takeshi KOMIYA
328ff6eeae Fix i18n: warnings for translation catalogs have wrong line numbers 2018-08-22 21:01:50 +09:00
Takeshi KOMIYA
472001eeb7 Fix typo 2018-08-22 11:08:33 +09:00
Takeshi KOMIYA
e3f383ad7c Merge pull request #5315 from tk0miya/add_autodoc_default_options
Add autodoc_default_options
2018-08-20 00:26:08 +09:00
Takeshi KOMIYA
17874a1a4b Merge pull request #5297 from AWhetter/viewcode_follow_imported_event
Plugins can resolve imported members for viewcode
2018-08-19 23:45:09 +09:00
Takeshi KOMIYA
3d9e2cf831 Add autodoc_default_options 2018-08-18 18:22:16 +09:00
Jakob Lykke Andersen
1c035d7203 C++, add support for overload-specific references.
The "any" and "func" roles now accepts full function declarations.

Fixes #1552
2018-08-18 08:27:23 +02:00
Lewis Haley
f196a92055 autodoc: add 'exclude-members' to user global options
As the previous commit explains, it is now possible to specify arguments
to the global options in config files. This means that we can now include
the `exclude-members` option in this global configuration.

Previously, there was no point including this option because it makes no
sense without arguments. Including this option means users have the
flexibility of explicitly including which special methods they want using
(e.g.):

  :special-members: __init__, __iter__

or explicitly excluding which special-members (or other members) they want
using (e.g.):

  :exclude-members: __weakref__, __hash__
2018-08-17 16:02:11 +01:00
Lewis Haley
6e1e35c98a autodoc: allow specifying values to global arguments
Previously, users could specify a *list* of flags in their config files.
The flags were directive names that would otherwise be present in the
.rst files. However, as a list, it was not possible to specify values
to those flags, which *is* possible in .rst files.

For example, in .rst you could say

  :special-members: __init__, __iter__

And this would cause autodoc to generate documents for these methods that
it would otherwise ignore.

This commit changes the config option to instead accept a dictionary.
This is a dictionary whose keys can contain the same flag-names as before,
but whose values can contain the arguments as seen in .rst files.

The old list is still supported, for backwards compatibility, but the data
is transformed into a dictionary when the user's config is loaded.
2018-08-17 15:51:00 +01:00
Takeshi KOMIYA
28131df93e Merge pull request #5307 from akaihola/5273_doctest_conditional_skip
Feature: skip doctests conditionally
2018-08-17 00:33:29 +09:00
Antti Kaihola
43d5810083 Ref #5273: doctest: add documentation for the :skipif: option 2018-08-16 14:01:57 +03:00
Ashley Whetter
97164faec3 Plugins can resolve imported members for viewcode 2018-08-13 17:07:50 -07:00
Takeshi KOMIYA
f670a33f5b Fix #5246: Add :confval:singlehtml_sidebars to configure sidebars for singlehtml 2018-08-13 11:04:45 +09:00
Jakob Lykke Andersen
4397606d03 C++, fix direct lookup problem
Also clarify documentation regarding cross-references involving templates.

See also sphinx-doc/sphinx#2057
2018-08-11 11:04:56 +02:00
Takeshi KOMIYA
206395121d Merge pull request #5250 from tk0miya/refactor_math4
Add :rst:role:`math:numref` role to refer equations (Same as :rst:role:`eq`)
2018-08-04 21:03:49 +09:00
Takeshi KOMIYA
68630e68b9 Merge branch '1.7' 2018-08-04 20:34:42 +09:00
Takeshi KOMIYA
ec7ee91dd3 Merge pull request #5230 from tk0miya/726_mathjax_config
#726, #969: Add mathjax_config
2018-08-04 19:21:01 +09:00
Takeshi KOMIYA
c216c53a26 Merge pull request #5227 from tk0miya/changeset_domain
refactor: Move repository of changesets to domain from env
2018-08-04 18:43:47 +09:00
jfbu
8a23ad1f44 Update LaTeX docs for a 1.7.6 change (refs #5178) 2018-08-02 12:46:33 +02:00
jfbu
5a220d648a Fix LaTeX docs of Latin Modern font with XeLaTeX/LuaLaTeX
refs: #5251
2018-08-02 10:06:31 +02:00
Takeshi KOMIYA
8e56f86383 Add :rst:role:math:numref role to refer equations (Same as :rst:role:eq) 2018-08-02 01:52:40 +09:00