Commit Graph

5 Commits

Author SHA1 Message Date
Antony Lee
cfa03b9771 Fix documented default values for setuptools integration.
The defaults were obtained by reading the implementation in
`setup_command.py`, notably `_guess_source_dir` and `finalize_options`.
2017-09-01 22:30:04 -07:00
Timotheus Kampik
22ea6d560b #3996 add note: replace hyphen with underscore if build options set in setup() command 2017-08-13 16:20:25 +02:00
Sanjeev Gupta
cc69691032 Minor typo 2017-06-01 12:37:33 +08:00
Stephen Finucane
2afa0b6627 setuptools: Support multiple builders
At present, the 'builder' option for the setuptools integration only
supports a single output format, typically HTML, like so:

  [build_sphinx]
  builder = man

There is value in being able to specify multiple format, like so:

  [build_sphinx]
  builder = html man

Make this possible.

Signed-off-by: Stephen Finucane <stephen@that.guru>
2017-02-28 17:30:28 +00:00
Stephen Finucane
29da4f9444 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>
2017-02-24 13:41:34 -05:00