Chris Sewell
46177f6af3
Correct numbers
2020-08-21 01:58:28 +01:00
Chris Sewell
5c744d8342
📚 DOCS: Improve build process overview
2020-08-20 22:37:37 +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
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
9bac86a2fc
Fix typo sphinx-buid in internationalization figure
2020-08-03 19:30:38 +01:00
Chris Mayo
fe4a158caf
Fix typos in the documentation
2020-08-03 19:30:38 +01:00
Takeshi KOMIYA
46f0b3063d
refactor: autodoc: Add EMPTY that matches to no members
...
Add a special class `_Empty` to make the comparison of
:exclude-members: option simply. It never matches to any members.
2020-08-03 01:59:53 +09: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
Takeshi KOMIYA
f71b26ac56
Merge branch '3.x' into 7993_texinfo_for_nested_desc
2020-08-01 15:50:55 +09:00
Chris Holdgraf
b8ee3ac9a4
moving extension dev overview
2020-07-29 10:38:18 +01: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
924befa07e
Update doc/development/tutorials/builders.rst
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
e98f39d21d
Fix #7993 : texinfo: TypeError is raised for nested object descriptions
...
The texinfo writer remembers the current desc node to render
a desc_annotation node. This makes the mechanism robust to support
nested object descriptions.
2020-07-25 22:57:12 +09: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
Takeshi KOMIYA
f3811a1c36
doc: Remove broken PDF image
...
It was added unexpectedly in #7924 .
2020-07-11 00:28:22 +09:00
Takeshi KOMIYA
98a854deca
Merge pull request #7924 from tk0miya/7921_translation.png
...
doc: Add translation.png to build latexpdf successfully
2020-07-10 02:44:11 +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
Julien Palard
418576ddd1
Doc: Add missing 'env-merge-info' to the todo tutorial.
2020-07-06 17:55:55 +02:00
Jakob Lykke Andersen
09e057edf2
Merge pull request #7906 from jakobandersen/noindexentry
...
Add :noindexentry: option
2020-07-05 09:25:18 +02:00
Takeshi KOMIYA
fe444f70d8
Merge pull request #7911 from tk0miya/7907_update_docs
...
doc: Update docs (refs: #7907 )
2020-07-05 12:22:19 +09:00
Jakob Lykke Andersen
c668500a4b
Add :noindexentry: option
...
Fixes sphinx-doc/sphinx#7052
2020-07-04 19:34:00 +02:00
Takeshi KOMIYA
814efa55c4
Merge pull request #7897 from JulienPalard/typo
...
FIX: Typo in tutorial/todo.
2020-07-05 01:33:54 +09:00
Takeshi KOMIYA
0c24baaa0c
doc: Update docs (refs: #7907 )
2020-07-04 11:56:45 +09:00
Takeshi KOMIYA
f27dfe337e
Merge pull request #7907 from tmetzl/patch-1
...
doc: Clarify language specific figures format in docs
2020-07-04 11:48:28 +09:00
Tim Metzler
5ba5cb60e3
Use double backticks for filename example
2020-07-03 19:08:53 +02:00
Tim Metzler
3982d526b2
Shorten line to less than 85 characters
2020-07-03 14:27:14 +02:00
Tim Metzler
9dcd88709c
Clarify language specific figures format
...
I recently used sphinx for multilanguage documentation and found the explanation of the language specific figure format misleading.
I replaced the underscores by periods and added a small example.
2020-07-03 14:11:53 +02:00
Chris Holdgraf
ef03bcc6ea
output files comment
2020-07-02 13:46:44 -07:00
Chris Holdgraf
853060a646
events
2020-07-02 13:42:53 -07:00
Jakob Lykke Andersen
8c82ecbf2c
Merge pull request #7895 from jakobandersen/c_cpp_noindex
...
C, C++: remove noindex option
2020-07-02 15:38:45 +02:00
Julien Palard
527a0361f1
FIX: Typo in tutorial/todo.
2020-06-30 17:13:19 +02:00
Jakob Lykke Andersen
ff5eb7cc2b
C, C++: remove noindex option
...
The option did nothing.
Improve error messages on duplicates.
2020-06-30 13:52:18 +02:00
Jakob Lykke Andersen
7cbf54c210
C, add c:alias directive
2020-06-30 11:20:17 +02:00
Nguyễn Gia Phong
1a865069db
napoleon: Add aliases Warn and Raise
2020-06-29 22:19:54 +07:00