Takeshi KOMIYA
d13b86e02f
Close #9664 : autodoc: autodoc-process-bases supports reST snippet
...
This allows to inject a reST snippet through autodoc-process-bases
event. It helps to modify the base classes of any class to the expected
mark-up'ed text by custom extension.
2021-09-23 10:59:01 +09:00
Takeshi KOMIYA
3774c124f8
Update CHANGES for PR #9644
2021-09-18 01:21:13 +09:00
Takeshi KOMIYA
506590d4ba
Merge pull request #9640 from tk0miya/9639_support_asyncgenfunction
...
Close #9639 : autodoc: Support asynchronous generator functions
2021-09-18 01:03:34 +09:00
Takeshi KOMIYA
ccfca458ea
Close #9639 : autodoc: Support asynchronous generator functions
2021-09-17 02:20:40 +09:00
Takeshi KOMIYA
bc012076b8
Fix #9630 : autosummary: Failed to build summary table if primary_domain is not 'py'
...
Autosummary generates reST code that uses raw `:obj:` xrefs to refer
the python objects in the summary table. But they're fragile because
they assume the primary_domain=='py'.
This adds `:py:` prefix to these xrefs to make them robust.
2021-09-14 23:59:47 +09:00
Takeshi KOMIYA
ed227d7d3c
Fix #9630 : autodoc: Failed to build xrefs if primary_domain is not 'py'
...
Autodoc generates reST code that uses raw `:obj:` and `:class:` xrefs to
refer the classes and types. But they're fragile because they assume
the primary_domain=='py'.
This adds `:py:` prefix to these xrefs to make them robust.
2021-09-14 23:59:47 +09:00
Takeshi KOMIYA
ba2439a105
Bump version
2021-09-12 16:55:46 +09:00
Takeshi KOMIYA
cf38356a08
Bump version
2021-09-12 16:54:59 +09:00
Takeshi KOMIYA
21db4b1407
Bump to 4.2.0 final
2021-09-12 16:51:24 +09:00
Takeshi KOMIYA
2390ce6e1a
CHANGES: Merge 4.1.3 (unreleased) to 4.2.0
2021-09-12 16:48:25 +09:00
Takeshi KOMIYA
260f217a3d
Merge pull request #9594 from hkuno/pr/no_empty_desc_4.x
...
let user skip printing command description
2021-09-11 19:08:37 +09:00
Takeshi KOMIYA
fb141c355f
Update CHANGES for PR #9594
2021-09-11 18:54:29 +09:00
Takeshi KOMIYA
c44ee0ebaa
Merge pull request #9611 from tk0miya/9560_NewType_module
...
Close #9560 : autodoc: Allow to refer NewType with modname in py310+
2021-09-11 17:19:54 +09:00
Takeshi KOMIYA
3a67b49f5d
Update CHANGES for PR #9617
2021-09-11 17:12:59 +09:00
Christian Clauss
86583c578c
Fix typos discovered by codespell
2021-09-08 02:15:25 +02:00
Takeshi KOMIYA
c5b35efce3
Close #9560 : autodoc: Allow to refer NewType with modname in py310+
...
Before 3.10, an instance of NewType has incorrect module name. But it
was fixed on 3.10. This starts to use the module info if the
interpreter is 3.10+.
2021-09-05 18:28:27 +09:00
Takeshi KOMIYA
bd5e40ce3a
Merge pull request #9609 from tk0miya/9608_apidoc_pymod_definition_for_implicit_namespace
...
Fix #9608 : apidoc: module is not described if implicit namespace package
2021-09-05 16:34:58 +09:00
Takeshi KOMIYA
a3f08fe298
Merge pull request #9606 from tk0miya/9600_typehints_including_commas
...
Fix #9600 : autosummary: Typehints including commas confuses autosummary
2021-09-05 16:34:01 +09:00
Takeshi KOMIYA
223d615011
Fix #9608 : apidoc: module is not described if implicit namespace package
...
To make implicit namespace packages referencable, this outputs empty
module definitions for them.
2021-09-04 22:44:04 +09:00
Takeshi KOMIYA
0a8655b733
Fix #9600 : autosummary: Typehints including commas confuses autosummary
2021-09-04 01:54:11 +09:00
Takeshi KOMIYA
34664ce4ce
Fix #9576 : py domain: Literal typehint was converted to a cross reference
...
The content of Literal typehint should not be converted to cross
references.
2021-09-03 22:09:30 +09:00
Takeshi KOMIYA
3e24190564
Fix #9585 : py:property directive does not create a hyperlink for types
2021-08-31 23:55:12 +09:00
Takeshi KOMIYA
6fb8d1c806
Merge branch '4.x' into 9524_SphinxTestApp_outdir
2021-08-29 23:18:56 +09:00
Takeshi KOMIYA
a4a0b97835
Merge pull request #9569 from jakelishman/fix-autosummary-sections
...
Fix #9568 : autosummary: summarise overlined sectioned headings correctly
2021-08-29 17:17:52 +09:00
Takeshi KOMIYA
760820f5ed
Merge branch '4.x' into fix-autosummary-sections
2021-08-29 16:47:43 +09:00
Takeshi KOMIYA
276f943610
Merge branch '4.x' into 9564-fix_highlighted_code_role_smartquotes
2021-08-29 16:43:50 +09:00
Takeshi KOMIYA
e33134f6ba
Merge pull request #9590 from tk0miya/9589_Annotated
...
Fix #9589 : autodoc: typing.Annotated has wrongly been rendered
2021-08-29 16:02:08 +09:00
Takeshi KOMIYA
b82d3ef05a
Fix #9589 : autodoc: typing.Annotated has wrongly been rendered
...
At the HEAD of 3.10, the implementation of `typing.Annotated` has
been changed to have __qualname__.
2021-08-29 15:51:39 +09:00
Justin Turner Arthur
adcda091d9
Check complete ancestry of text nodes for smartquotes eligibility.
...
Fixes sphinx-doc/sphinx#9564 .
2021-08-21 00:20:04 -05:00
Jakob Lykke Andersen
73c1520923
C++, fix parsing of defaulted fp function params
2021-08-20 18:17:42 +02:00
Jake Lishman
9d7fa75d4a
Fix #9568 : autosummary: summarise overlined sectioned headings correctly
...
Add an extra step in the autosummary summariser algorithm to get a valid
text form of section headings. This fixed issues when the first element
of a summarised document was a section heading with overlines, such as
=======
Heading
=======
Previously, the first line would be taken verbatim, which caused parse
errors in the rest of the document.
2021-08-20 17:05:58 +01:00
Jakob Lykke Andersen
a4371ea94c
C++, update fundamental type handling a la in C
2021-08-20 17:15:34 +02:00
Jakob Lykke Andersen
c5962b70bd
C, update fundamental types, including GNU exts
...
Fixes sphinx-doc/sphinx#9535
2021-08-20 17:15:34 +02:00
Takeshi KOMIYA
a4b540f61f
Close #9524 : test: SphinxTestApp can take `builddir` as an argument
2021-08-15 02:45:32 +09:00
Takeshi KOMIYA
3e5729b057
Fix #9267 : html theme: CSS and JS files added by theme were loaded twice
2021-08-14 21:10:56 +09:00
Takeshi KOMIYA
75c86c3059
Merge branch '4.1.x' into 4.x
2021-08-11 02:10:49 +09:00
Takeshi KOMIYA
648af37d86
Fix #9537 : autodoc: Some typing.* objects are broken
...
At the HEAD of 3.10, the implementation of `typing._GenericAlias` has
been changed to have correct _name and __name__.
2021-08-11 01:59:38 +09:00
Takeshi KOMIYA
a7ac325a1b
Update CHANGES for PR #9522
2021-08-05 01:54:28 +09:00
Takeshi KOMIYA
d788e78a5e
Update CHANGES for PR #9447
2021-08-02 02:10:46 +09:00
Takeshi KOMIYA
efea26f7d1
Merge pull request #9495 from tk0miya/9456_abbr_marks_on_search_result
...
Fix #9456 : html search: abbreation marks are inserted to the search
2021-08-02 01:35:35 +09:00
Takeshi KOMIYA
33f70bea87
Merge branch '4.x' into 9479_autodoc_mocked_target
2021-08-02 00:28:15 +09:00
Takeshi KOMIYA
383eff0ced
Update CHANGES for PR #9518
2021-08-02 00:27:18 +09:00
Takeshi KOMIYA
f31d72c367
Update CHANGES for PR #9509
2021-08-01 16:18:57 +09:00
Takeshi KOMIYA
585869ac59
Merge branch '4.x' into 9479_autodoc_mocked_target
2021-08-01 15:12:37 +09:00
Takeshi KOMIYA
155ca3e853
Update CHANGES for PR #9509
2021-07-31 02:44:05 +09:00
Takeshi KOMIYA
d0c97e9eb5
Fix #9504 : autodoc: generate incorrect reference to the parent class
...
Autodoc generates incorrect references to the parent class the target
class inherites the class having `_name` attribute. It conciders the
parent is a kind of SpecialForm'ed class by mistake. This uses
`isinstance(X, SpecialForm)` to check that.
Note: SpecialForm became a class since Python 3.7.
2021-07-31 01:41:35 +09:00
Takeshi KOMIYA
1fd5f74653
Fix #9512 : sphinx-build: crashed with the HEAD of Python 3.10
...
Recently, `types.Union` was renamed to `types.UnionType` on the HEAD
of 3.10 (refs: python/cpython#27342 ). After this change, sphinx-build
has been crashed because of ImportError.
2021-07-30 02:19:29 +09:00
Takeshi KOMIYA
36e06d67c9
Merge pull request #9513 from tk0miya/9512_types.UnionTypes
...
Fix #9512 : sphinx-build: crashed with the HEAD of Python 3.10
2021-07-30 02:18:34 +09:00
Takeshi KOMIYA
8b2031c747
Fix #9512 : sphinx-build: crashed with the HEAD of Python 3.10
...
Recently, `types.Union` was renamed to `types.UnionType` on the HEAD
of 3.10 (refs: python/cpython#27342 ). After this change, sphinx-build
has been crashed because of ImportError.
2021-07-30 01:32:28 +09:00
Takeshi KOMIYA
a7daa19a93
Fix #9479 : autodoc: Emit a warning if target is a mocked object
2021-07-27 23:55:26 +09:00