[Distutils] building documentation

Stefan Seefeld seefeld at sympatico.ca
Tue Nov 25 15:36:58 EST 2003

hi there,

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 mailing list