Tuve el mismo problema y encontré esta pregunta tratando de resolverlo. Tampoco pude entender cómo hacerlo, así que esta es mi solución. En lugar de intentar engañar a pydoc para que envíe a una ubicación específica, solo estoy generando la documentación en el directorio actual y moviendo los archivos a la ubicación que quiero.
En mi caso, la carpeta de destino se denomina 'doc', y la fuente se encuentra en el directorio 'semlm'
mkdir -p doc
pydoc -w `find semlm -name '*.py'`
mv *.html doc
(Usted debe ser capaz de personalizar el comando pydoc como desee, pero esto es lo que funcionó para mí).
No quería escribir todo esto cada vez, así que lo puse en un Makefile. He aquí un extracto:
.PHONY: doc
doc:
mkdir -p doc
pydoc -w `find semlm -name '*.py'`
mv *.html doc
El .PHONY: doc es necesario porque el objetivo Makefile tiene el mismo nombre que una carpeta en el directorio de nivel superior (es decir, 'doc'). Ahora puedo generar la documentación en la carpeta doc ejecutando:
make doc
Tal vez hay una forma más elegante, pero este es el mejor que he encontrado hasta ahora.
Lo siento, mi error de sintaxis. Estoy usando python -m pydoc -w pero el documento generado va al directorio actual como lo describí. Pero quiero que este documento se guarde en algún otro directorio. No conozco ningún otro cambio a PyDoc que produzca el efecto que deseo. –
¿Existe el directorio que especifique? ¿Agregas a/al final del nombre del directorio? –