Умный программист опасен
Я потратил больше времени, пытаясь исправить код, написанный «умными» программистами. Я предпочел бы иметь хорошего программиста, чем исключительно умного программиста, который хочет доказать, насколько он умен, написав код, который может интерпретировать только он (или она).
Другой «обходной путь» - выполнить pydoc
, как было предложено Nikokrock непосредственно в Emacs:
(defun pydoc (&optional arg)
(interactive)
(when (not (stringp arg))
(setq arg (thing-at-point 'word)))
(setq cmd (concat "pydoc " arg))
(ad-activate-regexp "auto-compile-yes-or-no-p-always-yes")
(shell-command cmd)
(setq pydoc-buf (get-buffer "*Shell Command Output*"))
(switch-to-buffer-other-window pydoc-buf)
(python-mode)
(ad-deactivate-regexp "auto-compile-yes-or-no-p-always-yes")
)
Документы Python теперь генерируются с использованием фреймворка Sphynx. Этот фреймворк не имеет формата вывода texinfo. В настоящее время в нем есть:
Возможно, вы сможете получить то, что хотите, используя вывод Latex. При выводе текста вы потеряете перекрестную ссылку
Лично я предпочитаю использовать pydoc, когда мне нужен текстовый вывод. В Vim у меня есть ярлык для вызова pydoc и открытия окна с документацией для объекта, находящегося под моим курсором ...
Майкл Эрнст использовал для поддержки форматов Info документов Python:
http://www.cs.washington.edu/homes/mernst/software/#python-info
Вы можете попробовать использовать его make-файл и скрипт html2texi для создания обновленной версии. Оба связаны по указанному выше URL. Я не уверен, насколько хорошо он работает сейчас (последняя версия была примерно в 2001 году), но его сценарий хорошо прокомментирован (grep для «python»).