Takeshi KOMIYA
40bdeb2c16
Bump version
2020-08-08 18:13:51 +09:00
Takeshi KOMIYA
0ff74155df
Bump version
2020-08-08 18:13:03 +09:00
Takeshi KOMIYA
e91f8a7d05
Bump to 3.2.0 final
2020-08-08 18:09:52 +09:00
Takeshi KOMIYA
b4efb8cd0e
Merge CHANGES of 3.1.3 (unreleased) to 3.2.0
2020-08-08 18:09:08 +09:00
Takeshi KOMIYA
5fd89964c5
Update CHANGES for PR #8071
2020-08-08 17:15:09 +09:00
Takeshi KOMIYA
b2d3f06621
Merge pull request #8071 from asmeurer/self-reference-warning-type
...
Make the toc.circular suppress_warnings flag apply to self referenced toctrees
2020-08-08 17:13:53 +09:00
Aaron Meurer
2a59fbcdbe
Make the toc.circular suppress_warnings flag apply to self referenced toctrees
...
Fixes https://github.com/sphinx-doc/sphinx/issues/7410#issuecomment-670678193 .
2020-08-07 15:42:41 -06:00
Michal Čihař
1bf7fe424e
i18n: Add support for having single text domain
...
The gettext_compact can now be a string which is then a single domain
for all documents.
Fixes #784
2020-08-07 20:22:30 +02:00
Takeshi KOMIYA
f92fa6443f
Merge pull request #8038 from keewis/custom-get_documenter
...
register custom autosummary get_documenter functions
2020-08-08 01:15:20 +09:00
Takeshi KOMIYA
697dff31ab
Merge pull request #8042 from tk0miya/8041_ivar_on_superclass_not_shown
...
Fix #8041 : autodoc: An ivar on super class is not shown unexpectedly
2020-08-08 00:51:46 +09:00
Takeshi KOMIYA
88b2ec6c34
Fix #8041 : autodoc: An ivar on super class is not shown unexpectedly
...
An annotated instance variable on super class is not documented when
derived class has also other annotated instance variables because
`obj.__annotations__` is overrided by derived class's type hints.
To get annotations of the target class correctly, this scans MRO to
get all of annotated instance variables.
2020-08-08 00:21:29 +09:00
Takeshi KOMIYA
5aa774b97a
Merge pull request #8056 from tk0miya/7780_multi_params_in_numpydoc
...
Fix #7780 : napoleon: multiple params declaration was wrongly recognized
2020-08-07 23:58:11 +09:00
Keewis
b69c5119b5
Merge branch '3.x' into preprocess-other-sections
2020-08-07 16:56:00 +02:00
Takeshi KOMIYA
16e62c57e9
Merge pull request #8065 from tk0miya/8049_update_testcase
...
napoleon: Fix a broken test (refs: #8049 )
2020-08-07 23:54:05 +09:00
Takeshi KOMIYA
a4996f9054
Fix #7780 : napoleon: multiple params declaration was wrongly recognized
...
So far, napoleon converts multiple paramaters declrarations to single
paramaeter fields (`:param:` and `:type:`) unexpectedly. As a result,
the output seems broken.
This converts it to multiple parameter fields (a pair of field for each
parameter declration) to build parameter successfully.
Note: The conversion rule is available only when napoleon_use_params=True.
2020-08-07 23:46:55 +09:00
Takeshi KOMIYA
99e65a59be
napoleon: Fix a broken test (refs: #8049 )
...
Fix a testcase that added just before #8049 merged.
2020-08-07 23:44:32 +09:00
Takeshi KOMIYA
e188d56ed1
Update CHANGES for PR #8049
2020-08-07 23:40:11 +09:00
Takeshi KOMIYA
62a6df8f3c
Merge pull request #8049 from keewis/type-preprocessing-without-use_param
...
enable type preprocessing without use_param
2020-08-07 23:37:22 +09:00
Keewis
b4dec34ecf
update the type hint
2020-08-07 15:41:17 +02:00
Keewis
9d60f3456f
return a documenter instance instead of just the class
2020-08-07 15:32:11 +02:00
Takeshi KOMIYA
92a134b419
Merge pull request #8064 from mattdocumatt/3.x
...
Add link to third party themes on GitLab
2020-08-07 22:23:15 +09:00
Matt from Documatt
db9375363c
Add link to third party themes on GitLab
...
GitLab, alternative to GitHub, also contains a lot of beautiful open source themes.
2020-08-07 14:46:19 +02:00
Keewis
79a2471032
add a create_documenter method wrapping get_documenter
2020-08-07 14:17:45 +02:00
Keewis
78e4499435
revert the dispatcher changes
2020-08-07 14:10:12 +02:00
Keewis
95c861facb
always use :obj: instead of searching the inventory
2020-08-07 12:44:22 +02:00
Keewis
75602f290a
make sure the roles are stripped from invalid names, too
2020-08-06 16:38:49 +02:00
Keewis
4428393403
translate the functions before attempting to find a matching role
2020-08-06 14:08:34 +02:00
Keewis
ca0bd28681
ignore the mypy error on possibly failing attribute lookup
2020-08-06 13:17:40 +02:00
Takeshi KOMIYA
e4e9a0f4be
Update CHANGES for PR #7799
2020-08-06 11:01:52 +09:00
Takeshi KOMIYA
64a26ff4de
Merge pull request #7799 from keewis/escape-combined-args-kwargs
...
Escape combined args kwargs
2020-08-06 10:59:21 +09:00
Takeshi KOMIYA
9c55630018
Update CHANGES for PR #8048
2020-08-06 10:57:43 +09:00
Takeshi KOMIYA
a8032b4405
Merge pull request #8048 from cjmayo/graphviz
...
Don't copy graphviz.css when building man pages
2020-08-06 10:56:27 +09:00
Chris Mayo
71e9a15ccf
Don't copy graphviz.css when building man pages
...
_static/graphviz.css is being created alongside the man pages.
2020-08-05 20:05:49 +01:00
Takeshi KOMIYA
f743be0054
Merge pull request #8047 from cjmayo/typos
...
Assorted typos including sphinx-buid in internationalization figure
2020-08-06 02:38:07 +09:00
Keewis
849d3c18a7
remove the syntax checks from the escape method and update the tests
2020-08-05 19:22:43 +02:00
Takeshi KOMIYA
784e7636d9
Merge pull request #8025 from tk0miya/6698_no-trim-flags
...
Close #6698 : doctest: Add :trim-flags: and :no-trim-flags: options
2020-08-06 00:29:36 +09:00
Takeshi KOMIYA
059dc108ba
Close #6698 : doctest: Add :no-trim-doctest-flags: options
...
To control trimming doctest flags manually, this adds new options
:trim-doctest-flags: and :no-trim-doctest-flags: to doctest
directives. It helps to describes doctest module itself in python
doc (see #6698 ).
2020-08-05 23:39:05 +09:00
Keewis
e79cd79cd2
revert the change to DocFieldTransformer
2020-08-05 14:28:32 +02:00
Keewis
e697242451
fix the tests by falling back to a empty dict on AttributeError
2020-08-04 20:50:02 +02:00
Keewis
e9f9da5326
Merge branch '3.x' into preprocess-other-sections
2020-08-04 19:33:28 +02:00
Keewis
478ab44d7e
Merge branch '3.x' into escape-combined-args-kwargs
2020-08-04 18:38:03 +02:00
Takeshi KOMIYA
fcf63a20cd
Merge pull request #8021 from keewis/fix-type-preprocessor
...
Fix type preprocessor
2020-08-05 00:19:29 +09:00
Keewis
c812370427
expect the normal raises and yields to be preprocessed, too
2020-08-04 14:59:54 +02:00
Keewis
d9fb3bc25c
search the role for See Also items in the intersphinx inventory
2020-08-04 14:35:33 +02:00
Keewis
47da37e1d9
make sure strings are not split using other delimiters
2020-08-04 12:28:30 +02:00
Keewis
fbad78d08f
check that a "default <obj>" notation works with xrefs
2020-08-04 12:21:00 +02:00
Keewis
af7d6a5be8
only allow "default <obj>" and "default: <obj>" for now
2020-08-04 12:20:09 +02:00
Keewis
cb61f0f734
document that we don't require use_param = True anymore
2020-08-04 11:39:48 +02:00
Keewis
2c75aaaa54
move the GoogleDocstring test to the appropriate test class
2020-08-04 11:36:15 +02:00
Keewis
278a057104
move the return types and yield types tests to above the raises test
2020-08-04 11:35:39 +02:00