Takeshi KOMIYA
150f788e0e
Merge pull request #8600 from tk0miya/8132_project_copyright
...
Close #8132 : Add project_copyright confval as an alias of copyright
2020-12-28 17:26:49 +09:00
Hong Xu
d9ca895dbb
Update autodoc.rst
2020-12-27 21:24:19 -08:00
Hong Xu
6927130ff1
Doc: Correct type: "TypeAlias" -> "AliasType"
2020-12-27 21:23:31 -08:00
Takeshi KOMIYA
c5a9d04d45
Merge branch '3.x' into 8132_project_copyright
2020-12-28 13:56:11 +09:00
Takeshi KOMIYA
c7d1536828
Close #8132 : Add project_copyright confval as an alias of copyright
...
Avoid to pylint error, add a new config variable; project_copyright
as an alias of `copyright`.
2020-12-27 18:40:06 +09:00
Takeshi KOMIYA
9e9e486e65
Close #8022 : autodoc: Allow to hide the value of the variables via metadata
...
autodata and autoattribute directives does not show right-hand value of
the variable if its docstring contains ``:meta hide-value:`` in
info-field-list.
2020-12-27 12:46:03 +09:00
Ned Batchelder
bac6ab8d0c
Describe the intersphinx mapping a bit more
2020-12-13 08:04:55 -05:00
Takeshi KOMIYA
da4c69c624
Merge pull request #8291 from QuentinSoubeyran/8285_napoleon_google_style_use_annotations
...
Fix #8285 : napoleon can use PEP526 annotations
2020-11-28 18:11:30 +09:00
François Freitag
6b90a63f08
Fix #6629 : linkcheck: Handle rate-limiting
...
Follow the Retry-After header if present, otherwise use an exponential
back-off.
2020-11-25 17:34:55 +01:00
Quentin Soubeyran
ec30f77712
refactored code and tests, prepared for numpy feature
2020-11-25 08:45:25 +01:00
Quentin Soubeyran
f268665292
added napoleon_google_attr_annotations option to use PEP 526 on google style
2020-11-25 08:45:25 +01:00
Takeshi KOMIYA
5676fdeb4e
Rename :novalue: option to :no-value: option
...
According to the existing options of autodoc directives, `:novalue:`
option is now renamed to `:no-value:` option.
2020-11-15 14:20:30 +09:00
Marlon James
6082ce67a4
autodoc: document :novalue: option
2020-11-15 14:19:33 +09:00
Thomas Grainger
3f26564c28
Apply suggestions from code review
2020-10-05 22:10:25 +01:00
Thomas Grainger
3eecf133d8
Fix #8289 : Allow to suppress "duplicated ToC entry found" warnings from epub builder
2020-10-05 09:29:16 +01:00
Takeshi KOMIYA
178c05b059
Close #7996 : manpage: Add man_make_section_directory
...
Add a new config variable; man_make_section_directory to make a
section directory on build man page. During 3.x, it defaults to
False and will be changed to True on 4.0 release.
2020-10-03 22:30:20 +09:00
François Freitag
5166dd194c
Strip trailing whitespaces and normalize line endings
...
Trailing whitespace do not have impact on the result, they are just
unused bytes. Most text editors are configured to strip trailing
whitespaces. Remove them all in one go.
Update a handful of files to use the UNIX line ending.
2020-10-03 13:47:01 +02:00
Takeshi KOMIYA
f2c0dfe7c4
Close #6518 : autodoc: Add autodoc_type_aliases
...
autodoc_type_aliases allows to keep user defined type alises not
evaluated in the generated document.
2020-10-03 16:03:35 +09:00
Bradley Dice
a0116eaa58
Fix typo: anchestor -> ancestor.
2020-09-20 17:36:01 -05:00
Jakob Lykke Andersen
500f45fd4c
C, recursive alias declarations
...
Fixes sphinx-doc/sphinx#8141
2020-09-13 16:37:53 +02:00
Falko Axmann
849ef212bc
Fixes minor typo in quickstart.rst
2020-08-30 14:39:20 +02:00
Takeshi KOMIYA
dab15e2857
Merge pull request #8058 from nijel/single-domain
...
i18n: Add support for having single text domain
2020-08-14 14:21:43 +09: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
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
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
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
Chris Mayo
fe4a158caf
Fix typos in the documentation
2020-08-03 19:30:38 +01:00
Takeshi KOMIYA
57af828882
Merge pull request #8035 from tk0miya/8034_argument_for_private-members
...
Close #8034 : autodoc: :private-member: can take an list of member names
2020-08-03 01:57:13 +09:00
Takeshi KOMIYA
af15593c0c
Close #7768 : i18n: figure_language_filename supports {docpath} token
...
To build structured i18n imaging directory, figure_language_filename
now supports `{docpath}` token that is a dirname of the current
document.
2020-08-02 16:28:54 +09:00
Takeshi KOMIYA
d7a84e83cc
Close #8034 : autodoc: :private-member: can take an list of member names
...
Now :private-member: option can take an explicit list of member names to
be documented as its arguments (like :special-members: does).
2020-08-02 01:27:14 +09:00
Chris Holdgraf
84f7dffd99
comments
2020-07-29 10:38:18 +01:00
Chris Holdgraf
c7085162d1
rearranging a few docs and small updates
2020-07-29 10:38:18 +01:00
Chris Holdgraf
729dcd0e03
flake8
2020-07-29 10:38:18 +01:00
Chris Holdgraf
60b105d6aa
several documentation improvements to theming, templating, and extension development
2020-07-29 10:38:18 +01:00
Takeshi KOMIYA
3336dcc2ae
Merge pull request #7997 from sphinx-doc/fix/6863
...
fix 6863: add description literalinclude option (start/end have same string)
2020-07-25 22:53:48 +09:00
Yoshiki Shibukawa
70aa913bb2
fix 6863: add description literalinclude option (start/end have same string)
2020-07-25 22:36:06 +09:00
Takeshi KOMIYA
778e297577
Update CHANGES for PR #7690
2020-07-25 21:45:13 +09:00
Takeshi KOMIYA
ac0a800265
Merge pull request #7690 from keewis/transform_numpy_parameter_types
...
preprocessing numpy types
2020-07-25 21:41:32 +09:00
Keewis
6ae1c601b9
add a section about napoleon_type_aliases to the documentation
2020-07-25 11:49:58 +02:00
Keewis
530793d997
update the link to the official docstring guide
2020-07-25 11:37:32 +02:00
Takeshi KOMIYA
da174138af
Merge pull request #7927 from jnothman/name-case-clash
...
Add autosummary_filename_map config to avoid clashes
2020-07-24 01:07:19 +09:00
Jakob Lykke Andersen
18b00d8cff
Add docs and CHANGES for C changes
2020-07-14 11:48:58 +02:00
Johannes Lade
91285f39a6
Update description of autosummary_generate_overwrite
...
The old description was confusing. Maybe it's just me not being a native speaker, but I think it was wrongly worded.
2020-07-13 14:03:06 +02:00
Takeshi KOMIYA
e31fce0766
Close #7902 : html theme: Add a new option globaltoc_maxdepth
2020-07-11 23:11:59 +09:00
Takeshi KOMIYA
6dfbc5108e
Close #7849 : html: Add html_codeblock_linenos_style
2020-07-11 20:59:38 +09:00
Joel Nothman
72ca2bdffc
Add autosummary_filename_map config to avoid clashes
2020-07-08 16:51:57 +10:00
Takeshi KOMIYA
d2fdc851fa
doc: Add translation.png to build latexpdf successfully
2020-07-07 22:19:21 +09:00
Jakob Lykke Andersen
09e057edf2
Merge pull request #7906 from jakobandersen/noindexentry
...
Add :noindexentry: option
2020-07-05 09:25:18 +02:00
Jakob Lykke Andersen
c668500a4b
Add :noindexentry: option
...
Fixes sphinx-doc/sphinx#7052
2020-07-04 19:34:00 +02:00
Takeshi KOMIYA
0c24baaa0c
doc: Update docs (refs: #7907 )
2020-07-04 11:56:45 +09:00