Emacs的python-mode文档

Question

I just installed the python-mode in Emacs and it seems to be working well. However, I could not find documentation for the package on the official site .

The package comes with a doc folder where I can see two files:

commands-python-mode.org
commands-python-mode.rst

Both files seem to be formatted for some external tool that displays the help text.

With this:

• Is there a tool I can use to navigate this documentation?
• Does python-mode have an online site with documentation? Any tutorials or good walk-throughs for python-mode for Emacs?

Answer 1

Start off with Mx describe-mode . This gives you an overview over the available key bindings. For each command use Cf name RET to see the built-in documentation. The .org file should be an org-mode file and easily readable with Emacs.

See also here

Answer 2

A cursory inspection of those two files and the code tells me that they're basically a listing of the docstrings found in pymacs.el and python-mode.el . That means you'll be able to access the relevant documentation through Mx apropos or Ch a and friends (specifically, search for ^py or ^pymacs to get a listing of the mode functions).

As a general rule, because elisp doesn't support namespaces, all functions/variables defined by a given mode will have a consistent prefix related to the name of the mode. That makes it fairly simple to search through the Emacs documentation.

Answer 3

In addition to answers given: Try a walkthrough of the menu "Python", which appears at the head of window. It will display a short description of the commands or options.

WRT to beginnners, some introduction, examples of basic usage might be given still. Filed a feature request:

https://bugs.launchpad.net/python-mode/+bug/1281970

Answer 4

If your a emacs user and haven't heard of org-mode before your in for treat.

Open the .org file in emacs and go to org-mode ( META x org-mode ), use TAB on the header lines. Header-lines starts with one or more * .