I'm trying to integrate document generation into my distutils- based build system, and I'm not sure how to do it best. Ideally, I'd like to provide a new command 'build_doc' that does all the work, and then let the other commands install the documentation (tutorial, manual).
Where should I build the docs ? 'inplace' ? Or somewhere under build/ ? If I put it into build/lib.../ it gets installed as part of the library, i.e. under site-packages.
'setup.py clean' currently doesn't care about it either.
In a nutshell, it seems I have to modify *all* commands that participate in the build/installation to take my docs into account.
The shortest I can come up with is to build them inplace, and then treat them as 'data', as there is already a set of commands for that category.
Is there anything I overlooked ?
Any advice would be highly welcome, Stefan