documentación en modo python para Emacs

Question

Acabo de instalar el modo python en Emacs y parece funcionar bien. Sin embargo, no pude encontrar documentación para el paquete en the official site.

El paquete viene con una carpeta doc donde puedo ver dos archivos:

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

Ambos archivos parecen ser formateado por alguna herramienta externa que muestra el texto de ayuda.

Con esta:

• ¿Existe una herramienta que puede utilizar para navegar por esta documentación?
• ¿Tiene python-mode un sitio en línea con documentación? ¿Algún tutorial o un buen recorrido por el modo python para Emacs?

Answer 1

Una inspección superficial de those two files y the code me dice que son básicamente una lista de las cadenas de documentación se encuentran en pymacs.el y python-mode.el. Esto significa que podrá acceder a la documentación pertinente a través del M-x apropos o C-h a y amigos (específicamente, busque ^py o ^pymacs para obtener una lista de las funciones del modo).

Como regla general, como elisp no admite espacios de nombres, todas las funciones/variables definidas por un modo determinado tendrán un prefijo consistente relacionado con el nombre del modo. Eso hace que sea bastante simple buscar a través de la documentación de Emacs.

Answer 2

Comience con M-x describe-mode. Esto le brinda una visión general de las asociaciones de teclas disponibles. Para cada comando, use C-f name RET para ver la documentación incorporada. El archivo .org debe ser un archivo org-mode y fácil de leer con Emacs.

Ver también here

Answer 3

Si usted es un usuario de emacs y no ha oído hablar de org-mode antes de su visita para tratarlo.

Abrir el archivo en emacs .org e ir a org-mode (METAxorg-mode), utilice TAB en las líneas de cabecera. Las líneas de encabezado comienzan con uno o más *.

Answer 4

Además de las respuestas dadas: Pruebe un recorrido por el menú "Python", que aparece en la parte superior de la ventana. Mostrará una breve descripción de los comandos u opciones.

WRT para principiantes, alguna introducción, ejemplos de uso básico pueden darse todavía. presentado una solicitud de función:

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