Python.el 和 Python-mode：文檔和功能

Question

一段時間以來，我一直在閱讀有關 Emacs 可用的不同 Python 包的信息。 但是，我一直無法找到這兩個軟件包的官方文檔。

據我了解， python-mode似乎托管在啟動板，但存儲庫沒有 wiki 或解釋功能的文檔等。另一方面， python.el帶有最新版本的 Emacs，但我不能t 在任何地方都可以找到介紹其功能的文檔。

另外，它們是否都支持通過ipdb ipython進行分步調試？ 我在哪里可以找到有關此問題的更多信息？

Answer 1

以下評論;;; Commentary 正如@lunaryorn 所建議的那樣， ;;; Commentary是一個很好的起點。 如果您需要設置，請先閱讀本部分。

但是我認為在設置完成后才開始使用它（對於 python.el，如果使用 Emacs 24.3 則無事可做）是了解這些功能的最佳方式。

這是因為 Emacs 是自文檔編輯器。 您可以在 Emacs 中閱讀有關 Emacs 的所有文檔。 在 Python 緩沖區中，使用<f1> b （或Ch而不是<f1> ）來查看您可以使用的命令列表（這是功能列表）。 每個命令都鏈接到命令的文檔字符串。 您還可以使用“Ctrl + 右鍵單擊​​”打開菜單以查看可以在緩沖區中使用的命令列表。 python-mode函數的文檔，可以通過<f1> f python-mode RET打開，可能是另一個很好的起點。 如果您想查看某個<f1> k KEY-BIND文檔，請鍵入<f1> k KEY-BIND 。 還有更多有用的幫助命令。 有關詳細信息，請參閱<f1> <f1> 。 這些技術並非特定於 python-mode，因此您可以將它們用於 python.el 和 python-mode.el。

Re ipdb: python.el（我猜 python-mode.el 也可以）可以做到。 ;;; Commentary有代碼片段您可以在 Emacs 配置中使用的;;; Commentary 。

Answer 2

https://blueprints.launchpad.net/python-mode/+documentation

這同時提供了一些基本的常見問題解答。

python-mode.el 旨在立即支持 ipdb 和所有其他調試器。 不需要在 python.el 頂部解釋的配置，因為這些東西已經實現。 大多數命令是不言自明的。 每個命令都有一個文檔字符串，用戶會發現它對py-expression等某些功能很有用。 那里還報告了返回值。

要概覽存在哪些命令，菜單是一個很好的起點。

http://www.gnu.org/software/emacs/manual/html_node/emacs/Menu-Bar.html

python-mode.el 在目錄“doc”中列出命令及其解釋。

按照建議閱讀評論。 之后可能會使用outline-mode或hs-minor-mode來瀏覽符號。

最后： Mx py-TAB ，resp。 Mx python-TAB列出了已實現的命令。 知道名稱后，將其命名為 docu Ctrl-h f

兩種模式都應該與 IPython/ipdb 一起使用。

在網上似乎有幾個方法。

也許咨詢這個

http://gremu.net/blog/2010/using-ipythons-debugger-pdb-replacement/

如果您無法使其工作，請提交錯誤報告。

至於python-mode.el：

https://bugs.launchpad.net/python-mode

至於 python.el : Mx report-emacs-bug RET