IntenseWebs/sphinx
3
0 Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2026-10-14 09:22:11 -05:00
Code Issues Packages Projects Releases Wiki Activity
9,515 Commits 11 Branches 236 Tags
41c19ddf91018e2b9a8c0001a24a78f3ecb893be
Commit Graph
9515 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Stephen Finucane 41c19ddf91 tests: Skip tests with missing binaries 
While there are already some skips included here, they clearly aren't
doing their job and the test fail locally. Resolve this.

Signed-off-by: Stephen Finucane <stephen@that.guru>
 2017-12-18 20:10:18 +00:00
Stephen Finucane a102e8e29b setup.py: Include 'flake8' in 'test' requirements 
We are using this in our testing and actually need it for the flake8
plugin, so include this in the list of 'test' requirements.

Signed-off-by: Stephen Finucane <stephen@that.guru>
 2017-12-18 19:44:05 +00:00
jfbu fcbabcd9b5 Merge branch 'stable' 
Conflicts:
	sphinx/apidoc.py
	sphinx/application.py
	sphinx/quickstart.py

	modified:   CHANGES
	modified:   doc/config.rst
	modified:   doc/markup/inline.rst
	modified:   sphinx/application.py
	modified:   sphinx/builders/__init__.py
	modified:   sphinx/cmd/quickstart.py
	modified:   sphinx/ext/apidoc.py
 2017-12-18 10:13:49 +01:00
jfbu 46b1896228 Again rewording docs about numfig_secnum_depth 2017-12-17 17:56:03 +01:00
Takeshi KOMIYA 4173a0bfe1 Merge pull request #4312 from tk0miya/deprecate_formatargspec 
deprecate formatargspec() and format_annotation()
 2017-12-18 00:25:20 +09:00
Takeshi KOMIYA b0178fb5d4 Merge pull request #4222 from vedranmiletic/documentation-fixes 
Add more EXAMPLES
 2017-12-17 21:59:14 +09:00
Takeshi KOMIYA 464f94c238 deprecate formatargspec() and format_annotation() 2017-12-17 15:25:44 +09:00
Vedran Miletić c6775bce07 Add more EXAMPLES 2017-12-16 18:21:37 +01:00
jfbu ba1368072f Typo place holder --> placeholder 2017-12-16 11:51:00 +01:00
jfbu a9602e4597 Improve numref docs 2017-12-16 11:46:33 +01:00
Takeshi KOMIYA 02d3f071d3 Merge pull request #4282 from mgorny/makedirs-race2 
Use ensuredir() instead of os.makedirs() to fix race conditions
 2017-12-16 19:33:51 +09:00
jfbu f780f92d1b Mention `:numbered:` needed in numfig_secnum_depth docs 2017-12-16 11:32:40 +01:00
jfbu 070fbb97e5 Add markup and clarify numfig_secnum_depth docs 2017-12-16 11:05:33 +01:00
Michał Górny 14af6b429e Use ensuredir() instead of os.makedirs() to fix race conditions 
Use the ensuredir() function consistently across Sphinx code to avoid
race conditions e.g. when multiple Sphinx instances attempt to create
the same output directory. The ensuredir() function that was already
present in sphinx.util.osutil correctly catches EEXIST exception that
occurs if the specified directory already exists (i.e. it was created
between the call to os.path.isdir() and os.makedirs() that follows it).

While at it, remove redundant os.path.isdir() calls when they only
guarded the os.makedirs() call, and replace mkdir_p() which had pretty
much the same purpose, except for being prone to race conditions.

I did not modify testing-related code as race conditions mostly affect
real applications and not the test environment.

Fix #4281: Race conditions when creating output directory
 2017-12-16 09:50:09 +01:00
Takeshi KOMIYA f07b080331 Fix mypy violations 2017-12-16 15:01:23 +09:00
Takeshi KOMIYA d003707f71 Merge branch 'stable' 2017-12-16 14:54:58 +09:00
Takeshi KOMIYA 7cabd6cbb0 Fix mypy violations 2017-12-16 14:52:20 +09:00
jfbu b131c33af5 Fix markup in doc/ext/math.rst 2017-12-15 22:54:52 +01:00
Takeshi KOMIYA f79373d797 Merge pull request #4306 from tk0miya/use_make_mode_default_again 
quickstart: Fix make_mode should be chosen by default
 2017-12-16 02:01:23 +09:00
Takeshi KOMIYA facce1fb02 quickstart: Fix make_mode should be chosen by default 2017-12-16 01:27:18 +09:00
Takeshi KOMIYA 5bc5b8f013 Merge branch 'stable' 2017-12-16 00:53:55 +09:00
Takeshi KOMIYA 698a0c7741 Merge pull request #4302 from tk0miya/diet_test-root 
Diet testcases
 2017-12-15 22:28:30 +09:00
Takeshi KOMIYA 5c1a810fe7 Merge pull request #4304 from tk0miya/fix_ResourceWarning 
Fix ResourceWarning on pycode
 2017-12-15 21:48:35 +09:00
Takeshi KOMIYA c250c63daa test: Skip some builders on test_build_all 2017-12-15 21:15:04 +09:00
Takeshi KOMIYA 2a2ed8915a diet test-root: Move .mo files to new testroot (for test_html_rebuild_mo) 2017-12-15 21:15:02 +09:00
Takeshi KOMIYA 451ba5e76a Fix ResourceWarning on pycode 2017-12-15 21:11:48 +09:00
Takeshi KOMIYA e3bbffc36e test: Add test_html_copy_source 2017-12-15 02:35:32 +09:00
Takeshi KOMIYA a3f04c3397 Refactor test_build_html: Use basic project instead roots 2017-12-15 02:35:32 +09:00
Takeshi KOMIYA a5b64c98af diet test-root: Remove html_static_path and html_extra_path (duplicated with test-html_assets) 2017-12-15 02:35:32 +09:00
Takeshi KOMIYA a8ab1f164b diet test-root: Move testtheme to test-theming 2017-12-15 02:35:32 +09:00
Takeshi KOMIYA 60f3968ef7 diet test-root: Move ziptheme to test-theming 2017-12-15 02:35:32 +09:00
Takeshi KOMIYA ea61464706 Merge branch 'stable' 2017-12-14 23:26:27 +09:00
Takeshi KOMIYA a722c3f2bf Merge pull request #4300 from tk0miya/fix_ImportError_for_autodoc 
autodoc: Fix error handling for import_module()
 2017-12-14 23:22:24 +09:00
Takeshi KOMIYA acf5eaae84 Merge pull request #4294 from tk0miya/refactor_parser 
Refactor docutils components of Sphinx (reader, parser, FileInput and so on).
 2017-12-14 23:13:28 +09:00
Takeshi KOMIYA b6d6e4cc73 autodoc: Fix error handling for import_module() 2017-12-14 22:55:31 +09:00
Takeshi KOMIYA 9d44cb5952 Merge pull request #4299 from tk0miya/refactor_MockImporter 
autodoc: refactor MockImporter
 2017-12-14 22:13:16 +09:00
Takeshi KOMIYA 49e1fbe0df Update CHANGES for PR #4273 2017-12-14 22:09:43 +09:00
Takeshi KOMIYA 638018cea0 Merge pull request #4273 from stephenfin/bug/1421 
Fix #1421: Respect the quiet flag in sphinx-quickstart
 2017-12-14 22:08:56 +09:00
Takeshi KOMIYA a82a921d62 Merge pull request #4174 from stephenfin/argparse-integration-continued 
Argparse integration (continued)
 2017-12-14 22:07:28 +09:00
Takeshi KOMIYA f7fe5cc731 Merge pull request #4297 from stephenfin/bug/4284 
setup: Install mock for Python 3 too
 2017-12-14 21:25:34 +09:00
Takeshi KOMIYA 51580fabb4 Update docstrings 2017-12-14 21:15:55 +09:00
Takeshi KOMIYA 0dfa88ec4b Fix mypy violation 2017-12-14 21:15:53 +09:00
jfbu 7e75d46ea1 Again docs of `-M latexpdf`! 2017-12-14 12:54:29 +01:00
jfbu a1b04e05d7 Remove docs of `-M latexpdfja` sphinx-build option 
Indeed, if latex_engine is not appropriately set, the ``make latexpdf``
then fails because the Makefile in latex build repertory is the one for
pdflatex, not platex+dvipdfmx.

Besides, if language is 'ja', then latexpdf automatically uses the
platex latex_engine, hence the platex/dvipdfmx pipeline, and latexpdfja
is not needed.

For now, only removing documentation.
 2017-12-14 12:47:11 +01:00
jfbu e782ee6b63 Again docs of make latexpdf/latexpdfja 2017-12-14 12:42:17 +01:00
jfbu fdd87e504c Docs of make latexpdfja 2017-12-14 12:03:42 +01:00
Takeshi KOMIYA 9b3ef92d7b autodoc: refactor MockImporter 2017-12-14 15:36:08 +09:00
jfbu 64bb48ad2d Fix some French English encountered in sphinx.sty's comments ... 2017-12-13 22:29:56 +01:00
Stephen Finucane a5ef67b96a setup: Install mock for Python 3 too 
'mock' is part of the standard library in Python 3 since Python 3.3.
However, it's found in 'unittest.mock' - not 'mock'. We should install
the version for PyPi in all cases to minimize differences between the
two. When Python 2.7 support is dropped, we can consider switching to
the standard library version.

Signed-off-by: Stephen Finucane <stephen@that.guru>
Fixes #4284
 2017-12-13 19:59:45 +00:00
Stephen Finucane 974b1be218 Fix #1421: Respect the quiet flag in sphinx-quickstart 
Calling 'sphinx-quickstart --quiet' should not print anything to stdout.
Resolve this.

Signed-off-by: Stephen Finucane <stephen@that.guru>
 2017-12-13 19:39:29 +00:00