[Distutils] building documentation
seefeld at sympatico.ca
Tue Nov 25 15:36:58 EST 2003
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,
More information about the Distutils-SIG