Commit Graph

10516 Commits

Author SHA1 Message Date
Takeshi KOMIYA
b35198d847 Deprecate highlightlang directive
highlightlang directive is not documented, and marked as old in v0.2.
2018-04-15 00:33:02 +09:00
Takeshi KOMIYA
19585962a2 Update CHANGES for PR #4834 2018-04-14 21:16:07 +09:00
Takeshi KOMIYA
c0c9a41400
Merge pull request #4834 from lamby/895553-sphinx-please-make-the-set-object-description-reproducible
Ensure set object descriptions are reproducible.
2018-04-14 21:15:19 +09:00
Chris Lamb
0ffc27b7fa Ensure the set object description is reproducible.
Whilst working on the Reproducible Builds effort [0], we noticed
that sphinx could generate output that is not reproducible.

In particular, the rendering of `set` objects in default arguments
and elsewhere is currently non-determinstic. For example:

    class A_Class(object):
        a_set = {'a', 'b', 'c'}

Might be rendered as any of:

     {'a', 'b', 'c'}
     {'a', 'c', 'b'}
     {'b', 'a', 'c'}
     {'b', 'c', 'a'}
     {'c', 'a', 'b'}
     {'c', 'b', 'a'}

Patch attached that sorts the contents of sets whilst rendering.
This is parallel to the `dict` key sorting.

This was originally filed in Debian as #895553 [1].

 [0] https://reproducible-builds.org/
 [1] https://bugs.debian.org/895553

Signed-off-by: Chris Lamb <lamby@debian.org>
2018-04-14 10:30:54 +01:00
Chris Lamb
3231676936 Call object_description recursively for dict keys and values. 2018-04-14 10:00:50 +01:00
Takeshi KOMIYA
557514330f Merge branch '1.7' 2018-04-14 15:46:31 +09:00
Takeshi KOMIYA
00bdea2411
Merge pull request #4827 from tk0miya/4784_latex_show_urls_and_substitutions
Fix #4784: latex_show_urls assigns incorrect footnote numbers
2018-04-14 15:44:40 +09:00
Takeshi KOMIYA
af4647c492 Merge branch '1.7' 2018-04-14 15:43:38 +09:00
Takeshi KOMIYA
72762db255
Merge pull request #4839 from tk0miya/mypy-0.590
Fix mypy violations
2018-04-14 15:41:22 +09:00
Takeshi KOMIYA
779d25f7f1 Fix mypy violations 2018-04-14 15:26:53 +09:00
Takeshi KOMIYA
c35eb6fade
Merge pull request #4815 from tk0miya/refine_add_css_file
Refine adding CSS files
2018-04-13 00:21:33 +09:00
Takeshi KOMIYA
c12d616be9
Merge pull request #4819 from TimKam/1428-web-support-wrong-static-param-doc
#1428 update websupport API doc
2018-04-12 23:43:31 +09:00
Takeshi KOMIYA
35e4bd498f
Merge pull request #4831 from tk0miya/fix_docs
Fix docs
2018-04-12 23:42:35 +09:00
Takeshi KOMIYA
3dae6a5024
Merge pull request #4832 from ndevenish/fixdoc
Add missing literalinclude options documentation
2018-04-12 23:41:24 +09:00
Takeshi KOMIYA
5ef8da518f Fix #4784: latex_show_urls assigns incorrect footnote numbers 2018-04-12 23:40:15 +09:00
Nicholas Devenish
5685512e6a Add missing literalinclude options documentation
The start-at and end-at options, added in 560b572 for v1.5a1, #625
weren't previously documented. This fixes that.
2018-04-11 18:10:37 +01:00
Takeshi KOMIYA
69624bffa7 doc: Fix filename 2018-04-12 00:49:31 +09:00
Takeshi KOMIYA
5fd7bd7a12 doc: Fix broken link 2018-04-12 00:49:27 +09:00
Takeshi KOMIYA
5433d5c03d
Merge pull request #4809 from tk0miya/update_classifiers
Update package classifiers
2018-04-11 00:29:48 +09:00
Takeshi KOMIYA
dbafab6a9f
Merge pull request #4823 from tk0miya/4817_fix_URLs
Fix #4817: wrong URLs on warning messages
2018-04-09 10:59:59 +09:00
Takeshi KOMIYA
31d6576871
Merge pull request #4822 from tk0miya/4543_fix_testcase_for_partialmethod
Fix #4543: testcase for partialmethod is failed with py3.6.5
2018-04-09 01:56:27 +09:00
Takeshi KOMIYA
ca8e79a392
Merge branch '1.7' into 4817_fix_URLs 2018-04-09 01:56:12 +09:00
Takeshi KOMIYA
9fb2aa68b9
Merge pull request #4813 from tk0miya/4812_type_annotated_variables
Fix #4812: autodoc ignores type annotated variables
2018-04-09 01:55:18 +09:00
Takeshi KOMIYA
b2bd9f75a6 Merge branch '1.7' 2018-04-09 01:46:00 +09:00
Takeshi KOMIYA
245e7d7bab Fix #4812: autodoc ignores type annotated variables 2018-04-08 23:51:01 +09:00
Takeshi KOMIYA
7e1707000f
Merge pull request #4807 from tk0miya/4783_relpath
Fix #4783: Sphinx crashed when drives of srcdir and outdir are different
2018-04-08 23:35:59 +09:00
Stephen Finucane
651d41e1c7 Mark raw string as such
Resolves the following warning when building docs:

  sphinx/ext/autosummary/__init__.py:94: DeprecationWarning: invalid
  escape sequence \.
    periods_re = re.compile('\.(?:\s+)')

Signed-off-by: Stephen Finucane <stephen@that.guru>
2018-04-08 23:35:01 +09:00
Takeshi KOMIYA
1dd605971c
Merge pull request #4804 from tk0miya/add_SphinxDirective
Add SphinxDirective class
2018-04-08 23:30:19 +09:00
Takeshi KOMIYA
b4ccaa4c0b Update comments on conf.py 2018-04-08 22:37:24 +09:00
Takeshi KOMIYA
4546c8a1b1 Fix #4817: wrong URLs on warning messages 2018-04-08 22:32:49 +09:00
Takeshi KOMIYA
aefb3bbaaa Fix #4543: testcase for partialmethod is failed with py3.6.5 2018-04-08 21:54:00 +09:00
Timotheus Kampik
aa5a7e5916 #1428 further indent note 2018-04-08 13:40:23 +02:00
Timotheus Kampik
841a123c39 #1428 move/indent note 2018-04-08 13:38:53 +02:00
Timotheus Kampik
39678b7a61 #1428 update websupport API doc
* ``staticdir`` was not correctly documented
* ```staticroot`` was not correctly documented at all
2018-04-07 17:24:50 +02:00
Takeshi KOMIYA
bd2967f1d2 Add :confval:epub_css_files 2018-04-06 13:11:24 +09:00
Takeshi KOMIYA
5efecd2150 Add :confval:html_css_files 2018-04-06 13:11:24 +09:00
Takeshi KOMIYA
3afc72fba4 Rename add_stylesheet() to add_css_file() 2018-04-06 13:11:24 +09:00
Takeshi KOMIYA
99fbd44e20 Store stylesheets as an instance variable of HTML builder
So far, CSS files are stored as a class variable of HTML builder.
Not to have status globally, this changes it to an instance varable.
2018-04-06 13:10:49 +09:00
Takeshi KOMIYA
c5d6942b88 add_stylesheet() allows additional attributes 2018-04-06 13:10:49 +09:00
jfbu
e81f80880a Slight rework of latex doc 2018-04-02 19:47:57 +02:00
jfbu
5473851e8c Improve formatting of docs about LaTeX builder 2018-04-02 19:23:13 +02:00
Takeshi KOMIYA
3525c5a3b1
Merge pull request #4808 from tk0miya/4789_imgconverter
Fix error handling on imgconverter
2018-04-03 00:33:54 +09:00
Takeshi KOMIYA
7ac8ac643e Fix error handling on imgconverter 2018-04-03 00:14:19 +09:00
Takeshi KOMIYA
cff8dc519b Fix #4783: Sphinx crashed when drives of srcdir and outdir are different 2018-04-02 23:03:02 +09:00
Takeshi KOMIYA
6030e7390d
Merge pull request #4800 from tk0miya/drop_document.settings.gettext_compact
Drop `document.settings.gettext_compact`
2018-04-02 22:58:05 +09:00
Takeshi KOMIYA
eef9d13999 Update package classifiers 2018-04-02 21:09:16 +09:00
shimizukawa
eb1e8f937c So far, the Sphinx-doc project name on the transifex service included the latest major version number. For example "sphinx-doc-1_8". For this reason, we released a major version, we had to create a new project with transifex and took time to switch the data to be translated. This was to keep the translated text of the past version on transifex.
From now on, transifex project name does not include version number like "sphinx-doc". Project data always handles the contents of Sphinx's master branch.
Translation of the major version of the past is held at https://travis-ci.org/sphinx-doc/sphinx-doc-translations.
2018-04-01 21:50:13 +09:00
jfbu
525f3bd104 Typo from #4801 2018-04-01 11:39:58 +02:00
Takeshi KOMIYA
095b178cc3
Merge pull request #4797 from tk0miya/4789_imgconverter_misdetects_convert_command
Fix #4789: imgconverter: confused by converter.exe of Windows
2018-04-01 17:59:44 +09:00
jfbu
a831d6da53 Docs of fonts for LaTeX builds 2018-03-30 23:05:42 +02:00