Since Python 2.6, it seems the documentation is in the new reStructuredText format, and it doesn't seem very easy to build a Texinfo Info file out of the box anymore.
I'm an Emacs addict and prefer my documentation installed in Info.
Does anyone have Python 2.6 or later docs in Texinfo format? How did you convert them? Or, is there a maintained build somewhere out there?
I know I can use w3m or haddoc to view the html docs - I really want them in Info.
I've played with Pandoc but after a few small experiments it doesn't seem to deal well with links between documents, and my larger experiment - running it across all docs cat'ed together to see what happens - is still chugging along two days since I started it!
Highlighting two answers below, because SO won't allow me to accept both answers:
I've packaged up the Python docs as a texinfo file.
If you're using Emacs with MELPA, you can simply install this with M-x package-install python-info
.
Perfect, down to the "This file is deliberately empty" description ;-) Thanks Wilfred.
Suggestion: could this plug into the
C-h S
machinery? This would make it vastly more useful!@Clément hm, not sure how easy it would be. Could you open a GitHub issue describing how you'd imagine it working?
I got it working by doing:
export INFOPATH=$HOME/.emacs.d/etc/info/python3:"
in my .bashrc, then copying the python.info into that folder. Emacs will consolidate all such dirs into `Info-default-directories'. Note the trailing ':' in the environment variable to prevent having to specify the default directories. I also created a "dir" file in that directory that just pointed to the python submodule. Not sure if this last was necessary.