Commit Graph

4337 Commits

Author SHA1 Message Date
Takeshi KOMIYA
3d2c54eb47 Fix a testcase for py36 2022-04-05 01:08:58 +09:00
Takeshi KOMIYA
67708e7bb5 Fix a testcase 2022-04-04 23:48:29 +09:00
James Parkhurst
88b213bbf0 Added test case 2022-04-04 11:45:58 +01:00
Takeshi KOMIYA
da73960492 Merge branch '5.x' into autodoc_force_undocumented_rtype 2022-04-03 22:45:42 +09:00
Takeshi KOMIYA
e38c1bda01 Fix a testcase 2022-04-03 22:44:12 +09:00
Takeshi KOMIYA
fd42063725 autodoc_typehints_description_target: Rename returnvalue_and_documented_params to documented_params 2022-04-03 22:42:44 +09:00
Takeshi KOMIYA
f731bf1999 Merge branch '5.x' into autodoc_force_undocumented_rtype 2022-04-03 22:29:22 +09:00
Takeshi KOMIYA
21e3a96f09 Close #8417: autodoc: :inherited-members: option now takes multiple classes
It allows to suppress inherited members of several classes on the module at
once by specifying the option to `automodule` directive
2022-04-03 20:17:41 +09:00
Takeshi KOMIYA
7bdc11e87c Merge pull request #10323 from tk0miya/10318_literalinclude_prepend_and_dedent
Fix #10318: literalinclude: :prepend: option working with :dedent:
2022-04-03 20:13:39 +09:00
Takeshi KOMIYA
9d81843b82 Merge pull request #10321 from tk0miya/10266_autodoc_preserve_defaults_crashes_on_kwonlyargs_without_defaults
Fix #10266: autodoc_preserve_defaults crashes on kwonlyargs w/o defaults
2022-04-03 17:20:25 +09:00
Takeshi KOMIYA
020a1f9187 Merge pull request #10313 from GutiCW/feature-support_mocked_decorator_for_class_methods
Support mocked decorator for class methods
2022-04-03 17:16:39 +09:00
Takeshi KOMIYA
0d31fc9614 Merge branch '5.x' into 10266_autodoc_preserve_defaults_crashes_on_kwonlyargs_without_defaults 2022-04-03 16:57:32 +09:00
Takeshi KOMIYA
a78c07ca07 Fix #10280: autodoc_docstring_signature generates needless return typehint
Basically, autodoc suppresses return value typehint for class
constructors.  But it was unexpectedly shown if
`autodoc_docstring_signature` is enabled and docstring has multiple
signatures.
2022-04-03 16:32:35 +09:00
Takeshi KOMIYA
e571479d54 Fix #10318: literalinclude: :prepend: option working with :dedent:
It will always be warned because prepending is processed before
dedenting.  This changes the order of processing options.
2022-04-02 23:39:47 +09:00
Takeshi KOMIYA
f5e4e70817 Fix #10266: autodoc_preserve_defaults crashes on kwonlyargs w/o defaults 2022-04-02 16:55:48 +09:00
Christian Walch
57d6ec7697 Extend test_mock_decorator for class method. 2022-04-01 07:37:07 +02:00
Takeshi KOMIYA
223b1a94f2 Merge branch '4.x' 2022-03-28 01:00:37 +09:00
Takeshi KOMIYA
4a496bfc98 Merge pull request #10178 from stephenfin/issue-10177
Revert "Close #9993: std domain: Allow to refer an inline target via ref role"
2022-03-27 23:10:52 +09:00
Takeshi KOMIYA
b20e04968e Merge pull request #10107 from Jean-Abou-Samra/intl-warnings
Implement #noqa for i18n
2022-03-27 23:00:57 +09:00
Takeshi KOMIYA
2db180da70 Merge branch '4.x' 2022-03-27 19:47:11 +09:00
Takeshi KOMIYA
c6230dc4db extlinks: Disable hardcoded links detector by default (refs: #10126)
The hardcoded links detector added since 4.4.0 causes troubles in many
projects.  Therefore, this disables it by default, and adds a new
configuration `extlinks_detect_hardcoded_links` to enable it explicitly.
2022-03-27 15:22:11 +09:00
Hugo van Kemenade
658689433e Include trailing / in PEP URL to avoid 301 redirect 2022-03-24 13:31:17 +02:00
Jeremy Maitin-Shepard
099b54cb87 Make code role highlighting consistent with code-block directive
Fixes https://github.com/sphinx-doc/sphinx/issues/5157

This is factored out of the sphinx-immaterial theme:
1ef121a612/sphinx_immaterial/inlinesyntaxhighlight.py (L1)

See also:
https://github.com/sphinx-doc/sphinx/pull/6916
2022-03-19 20:37:49 -07:00
Adam Turner
61d7b0b47c Replace jssplitter with JavaScript 2022-03-19 23:16:27 +00:00
Takeshi KOMIYA
168adb0f0e test: Fix test_markup does not use default settings for docutils 2022-03-19 22:58:27 +09:00
Takeshi KOMIYA
aa1bc83c2a Merge branch '4.x' 2022-03-19 22:58:15 +09:00
Takeshi KOMIYA
017ef6118b Merge branch '4.4.x' into 4.x 2022-03-19 22:56:54 +09:00
Takeshi KOMIYA
2f85b1a402 test: empty tuple type is now repesented w/o args since py3.11
refs: 15df8f8d89
2022-03-19 17:10:13 +09:00
Michal Čihař
ef79a2bc70 environment: Update default value for pep_base_url
This matches docutils change in https://sourceforge.net/p/docutils/code/9045/

Fixes #10253
2022-03-16 13:57:51 +01:00
Matyas Novak
07b2a050c7 Test recognition of a documented instance of a class as a non-imported member of the module 2022-03-14 23:31:33 +01:00
Takeshi KOMIYA
b12b39db05 Merge pull request #10212 from AA-Turner/remove-module-docstring-titles
Remove module docstring titles
2022-03-14 02:14:17 +09:00
Jakob Lykke Andersen
9362df53be C++, minor formatting 2022-03-12 20:05:26 +01:00
Jeremy Maitin-Shepard
a9a5cec681 Update tests/test_domain_cpp.py
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
2022-03-11 05:03:05 -08:00
Jeremy Maitin-Shepard
2c1e4c437e Update tests/test_domain_cpp.py
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
2022-03-11 05:02:59 -08:00
Jeremy Maitin-Shepard
ce82f9ee9c Update tests/test_domain_cpp.py
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
2022-03-11 05:02:54 -08:00
Jeremy Maitin-Shepard
670e8b149f [C++] Support attributes on class and union and improve formatting 2022-03-10 22:03:42 -08:00
Adam Turner
f05a068be9 Fix whitespace 2022-03-07 15:17:45 +00:00
Takeshi KOMIYA
f7a0107ddb Merge branch '4.x' 2022-03-03 02:28:07 +09:00
Takeshi KOMIYA
37e8967f3f Merge branch '4.4.x' into 4.x 2022-03-03 02:24:53 +09:00
Takeshi KOMIYA
12104fe5de test: Follow the new behavior of typing.get_type_hints() since py311
Since python-3.11, `typing.get_type_hints()` will not add Optional[t] to
type annotations even if a default value for function argument is None.

refs: https://github.com/python/cpython/pull/30304 (bpo-46195)
2022-03-03 01:34:21 +09:00
Adam Turner
5775912455 Collapse single line docstrings 2022-02-20 03:13:45 +00:00
Adam Turner
6bb7b891a1 Remove copyright and licence fields 2022-02-20 03:06:23 +00:00
Adam Turner
b691ebcc3e Conform to PEP 257 summary line conventions 2022-02-20 02:57:02 +00:00
Adam Turner
5694e0ce60 Fix module docstring indentation 2022-02-20 00:35:13 +00:00
Adam Turner
4f5a3269a6 Fix module docstring first line 2022-02-20 00:11:08 +00:00
Adam Turner
6b8bccec59 Remove module titles in docstrings 2022-02-19 23:17:29 +00:00
Takeshi KOMIYA
f72cd83e4d Merge branch '4.x' 2022-02-19 16:08:05 +09:00
Jean Abou Samra
94d78d8747 Close #3985: Implement #noqa for i18n
When cross-references in the original paragraph and the translated
paragraph do not match, a warning is emitted.  It is useful, because
it allows to catch mistakes, but it can also be an annoyance since
sometimes it is expected that the cross-references will not match.
For example, a reference that is repeated in the original text may
need to be factored out for good style in the target language.
Another example: if the translator needs to translate a universally
understood term in the source language into a term that not everyone
knows is the translation of this original term, adding a reference to
the glossary can be warranted.  This allows the translated message to
start with '#noqa' in order to disable the warning.
2022-02-15 19:51:06 +01:00
Takeshi KOMIYA
8b23f6db12 Merge commit '07110b7557a552ecfe702bdd6a2d2f9685cb1af9' 2022-02-14 03:03:40 +09:00
Takeshi KOMIYA
01d06f9ffe Fix #10175: LaTeX: named footnote ref is linked to an incorrect footnote
A named footnote reference will be converted to a hyperlink to an
incorrect footnote if the name is also used in the different document.
2022-02-13 20:20:42 +09:00