Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Stop using Makefile and promote building with sphinx-build only #6456

Closed
astromatt opened this issue Jun 7, 2019 · 1 comment
Closed

Stop using Makefile and promote building with sphinx-build only #6456

astromatt opened this issue Jun 7, 2019 · 1 comment
Labels
api:cmdline closed:duplicate type:enhancement enhance or introduce a new feature

Comments

@astromatt
Copy link

astromatt commented Jun 7, 2019

Feature request / idea

  • Makefile requires lots of additional dependencies
  • This is particular a problem on Alpine Linux (docker container).
  • Standalone sphinx-build works very well without any external dependency.
  • Stop generating Makefile for new projects and move all sphinx-build arguments to conf.py.

Describe the solution you'd like

  • Start promoting use of sphinx-build -c conf.py.
  • If flag -c <FILE> is not specified, sphinx-build should look in current directory for conf file.
  • All sphinxopts, sourcedir and builddir should be in conf.py.
  • sphinxopts should be configuration variables not just simply "list of opts to pass to sphinx-build"
  • This will also give opportunity to have multiple configuration in one project.
@astromatt astromatt added the type:enhancement enhance or introduce a new feature label Jun 7, 2019
@astromatt astromatt changed the title Stop using Makefile How about stop using Makefile and promote building with sphinx-build only? Jun 7, 2019
@astromatt astromatt changed the title How about stop using Makefile and promote building with sphinx-build only? Stop using Makefile and promote building with sphinx-build only Jun 7, 2019
@astromatt astromatt changed the title Stop using Makefile and promote building with sphinx-build only Stop using Makefile and promote building with sphinx-build only Jun 7, 2019
@tk0miya
Copy link
Member

tk0miya commented Jun 8, 2019

The same idea was posted to #5618. Could you post a comment to it please?

@tk0miya tk0miya closed this as completed Jun 8, 2019
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 3, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
api:cmdline closed:duplicate type:enhancement enhance or introduce a new feature
Projects
None yet
Development

No branches or pull requests

2 participants