Put all build-generated artefacts on built

[kinow]

I noticed that when I run make html singlehtml, the documentation appears to be generated under build/sphinx directory, but it looks like it also creates some directories under the doc.

If we run python setup.py bdist, then the bdist distribution package would go under build/bdist.linux-x86_64 or so. Since we have the sphinx folder being created under build, and setuptools is using that directory as well, then maybe we could stop using doc too?

Or is there a reason for the need of another folder for building the documentation?

[oliver-sanders]

The documentation should be built into doc/<version>.

I have no idea why you are seeing things in build/sphinx, that directory doesn't exist for me before or after a build:

$ make clean html singlehtml
$ find . -name 'build'
$ find . -name 'sphinx'
$ find . -name '_build'

[kinow]

Oh, you are right, make clean html singlehtml gives me no build directory, only the doc folder. I must have had some old folder there. And nothing appears now in git status. Funny 😕

Only way to get the build directory now is python setup.py bdist/install/etc. Closing it, sorry!

[oliver-sanders]

No probs, probably an artifact of all the stuff I moved, good old git clean to the rescue!