[02sphinx] 07stephenfin 0329da4f9 - doc: Add guide on setuptool/distutils integration While this feature is somewhat documented in the API guide, there's nothing about this option in the main user guide. Given the lack of blogs and articles talking about this feature, along with the amount of projects that are only using the same copy-paste '[build_sphinx]' definition, I imagine this is an issue. Make the
feature a little more accessible by adding a section to the main user guide that details (a) the fact the feature exists, (b) why you'd want to use it, and (c) how you can use it. Signed-off-by: Stephen Finucane <stephen@that.guru>
[02sphinx] 07stephenfin 03020e77b - tox: Add 'docs' target This is easier than creating a virtualenv, installing deps and running make. It also makes explicit use of the setuptool integration that is now documented. Signed-off-by: Stephen Finucane <stephen@that.guru>
[02sphinx] 07stephenfin 036de6e81 - setup.cfg: Enable 'warning-is-error' Dog food this feature. Validated with the following (broken) change: --- a/doc/contents.rst +++ b/doc/contents.rst @@ -18,6 +18,9 @@ Sphinx documentation contents intl theming setuptools + + .. This is broken!!! + templating latex markdown Signed-off-by: Stephen Finucane <stephen@that.guru>
[02sphinx] 07tk0miya 03edfcafa - Merge pull request #3456 from stephenfin/feat/sphinx-setuptools-integration Add documentation on setuptools interaction
[02sphinx] 07tk0miya 03e0fa1d0 - Fix #3400: make-mode don't use subprocess on building docs
[02sphinx] 07tk0miya 034b4260f - Merge pull request #3459 from tk0miya/3400_build_inprocess_on_make_mode Fix #3400: make-mode don't use subprocess on building docs