Seguindo uma prática comum (esperançosamente), eu tenho um pacote Python que inclui vários módulos e um script executável em umscripts diretório, como pode ser vistoAqui.

A documentação do script, além da ajuda gerada automaticamente pelo optparse, é junto com a documentação do pacote em um subdiretório Sphinx. Estou tentando:

gere a página man do script a partir da documentação existenteincluir a página man na distribuição

Eu posso facilmente fazer # 1 com Sphinx, oman_pages definição esphinx-build -b man. Então eu posso ligarpython setup.py build_sphinx -b man e ter a página man gerada nobuild/sphinx/man diretório.

Agora eu gostaria de poder ter a página man gerada incluída no tarball de distribuição, para que os empacotadores GNU / Linux possam encontrá-la e instalá-la no local apropriado. Várias opções comopackage_data parece não funcionar aqui porque a página man não está lá até ser gerada pelo Sphinx. Isso também poderia se aplicar a arquivos i18n (.mo vs.po arquivos).

Incluindo arquivos que não fazem parte da fonte emMANIFEST.in não parece certo. A possibilidade de confirmar os arquivos gerados no repositório de origem parece uma coisa horrível de se fazer e eu gostaria de evitá-lo.

Deveria haver um - e de preferência apenas um - caminho óbvio para fazê-lo.