Руководство по функциям Emacs Lisp?

На этом сайте есть некоторая сводная информация о emacs lisp, которая может быть полезна: http://xahlee.org/emacs/elisp.html.

В частности, обратите внимание на эти ссылки на этой странице: Базовые функции редактирования текста, Идиомы Emacs Lisp и Пакетная обработка текста

Вы пробовали встроенное руководство в emacs? Откройте любой буфер Lisp (или любой буфер в режиме Lisp), переместите вашу точку на любую функцию или переменную и нажмите C-h f (для функции) или C-h v (для переменной). Emacs даст вам довольно краткое описание функции / переменной.

Например, содержание руководства для (save-excursion):

save-excursion is a special form in `C source code'.
(save-excursion &rest BODY)

Save point, mark, and current buffer; execute BODY; restore those things.
Executes BODY just like `progn'.
The values of point, mark and the current buffer are restored
even in case of abnormal exit (throw or error).
The state of activation of the mark is also restored.

This construct does not save `deactivate-mark', and therefore
functions that change the buffer will still cause deactivation
of the mark at the end of the command.  To prevent that, bind
`deactivate-mark' with `let'.

Хорошим моментом также является то, что встроенное руководство дает вам «ссылку» на исходный код функции и на другие функции, которые могут быть связаны, что делает его удобным для просмотра.

Конечно, вы не можете выучить Lisp таким способом, но для поиска документации по функциям это хороший старт. Когда вы находите руководство по сборке непонятным (что иногда случается), то пора вам погуглить функцию;)

Введение в emacs lisp GNU, безусловно, более доступно, чем справочное руководство .

Я бы добавил пару вещей:

• M-x apropos - ищет в функциях и переменных любую указанную вами строку (например, каталог). Обратите внимание, что это немного отличается от C-h a, который находит только интерактивные функции

• найдите похожий фрагмент кода и скопируйте его - вы можете очень много узнать о том, как что-то делать, глядя на то, что уже сделано. Если у вас есть конкретная функция, которую вы хотите увидеть в примерах, хороший способ - посетить основной исходный каталог Lisp в dired (например, d: / product / emacs / lisp или / usr / share / lib / emacs / lisp) и выполнить % g, который будет просматривать все файлы в поисках введенной вами строки. Откройте этот файл и посмотрите, что с ним сделали другие люди.

• C-h f и C-h v - как кто-то еще упомянул, вы можете открыть исходный код, расположить точку над функцией или переменной, а затем получить по ней документацию.

• Ознакомьтесь с вики-страницей Emacs, в которой есть уйма модулей Emacs lisp, которые вы можете просмотреть.

Я думаю, вы ошибаетесь. Изучая язык программирования и набор библиотек (в совокупности «Emacs Lisp»), вам нужно подходить к нему как в микро-, так и в макроуровне. Прежде чем вы сможете начать писать программное обеспечение, вам необходимо знать, какие инструменты у вас есть. Это то, чему вас должно научить руководство по Emacs Lisp. Вам действительно нужно сесть и прочитать все это целиком. Таким образом вы узнаете, какие возможности предоставляет Emacs.

После этого вам понадобится информация «на микроуровне». Есть ряд источников, которые это подтверждают. Если у вас есть общее представление о том, что вам нужно делать («работать с буферами»), то справочник по Lisp - хорошее место, чтобы выяснить, что вам нужно знать. Если вы знаете, что есть функция, которая делает то, что вы хотите, но не совсем помните ее имя, тогда M-x apropos (C-u C-h a) поможет вам найти в документации. Если вы знаете, какую функцию хотите использовать, но не совсем помните, как она работает, M-x describe-function (C-h f) разберется с этим за вас.

В любом случае, ключ в том, чтобы изучить Emacs Lisp, а затем позволить Emacs помочь вам с деталями. Список функций многому вас не научит.

(О, еще одна вещь - вам следует ознакомиться с Common Lisp. Большинство библиотек Emacs используют cl, которые являются полезными функциями CL, реализованными в Emacs Lisp. loop, destructuring-bind, defun* и т. Д. Все здесь, и они очень полезный.)

Хорошие предложения от других - справочная система Emacs - ваш друг. Кроме того:

• http://www.emacswiki.org/emacs/EmacsNewbieWithIcicles

• http://www.emacswiki.org/emacs/Icicles_-_Progressive_Completion

• http://www.emacswiki.org/emacs/Icicles_-_Nutshell_View#ChippingAway

Чтобы понять, что происходит, довольно часто бывает полезно взглянуть на исходный код.

http://repo.or.cz/w/elbb.git/blob/HEAD:/code/Go-to-Emacs-Lisp-Definition.el

Вы пробовали <f1> f? Он привязан к describe-function. Пример с point:

point is a built-in function in C source code.
(point)

Return value of point, as an integer.
Beginning of buffer is position (point-min).

[back]

Как и большинство систем Lisp, Emacs имеет интегрированный инструмент документации!

• Любая функция или переменная Lisp может объявлять необязательную строку документа.
• Практически все стандартные команды или функции объявляют полезную строку документа.
• Emacs (как и большинство систем Lisp) позволяет вам отображать строку документации любой функции или переменной (<f1> f и <f1> v) в любое время.
• При отображении строка документа доступна для просмотра, что означает, что вы можете щелкнуть символы, чтобы увидеть их строку документа, или перейти к источнику соответствующей функции или переменной.
• Как только вы оцениваете какой-либо defun или defvar, его строка документа становится доступной через describe-function или describe-variable: этот документ жив!

M-x find-library RET ‹имя библиотеки› - это все, что вам действительно нужно

Если вы готовы раскошелиться на мертвое дерево, я бы порекомендовал

_{(источник: oreilly. ru)}

В XEmacs, а я также верю в Emacs, нажатие C-h f, затем клавиша табуляции для завершения табуляции, которая на тот момент является всеми функциями, даст вам список функций, о которых знает редактор.

Вы просто используете клавиши курсора, прокручиваете до той, о которой хотите узнать, и нажимаете ввод, чтобы увидеть подробности.

Если список функций с доступной дополнительной информацией - это то, что вы хотите, это даст вам ее.

В этом списке представлены все доступные в настоящее время функции, поэтому, если у вас установлены пакеты lisp, он показывает функции, которые эти пакеты предоставляют, а также собственные функции. В моей копии XEmacs сегодня в списке 6586 функций. Emacs будет похож.

Проблема в том, что не все функции имеют имена, которые делают их контекстно-значимыми (т.е. не все переменные / функции меню содержат в себе слово меню, поэтому вы упустите некоторые вещи, если будете использовать только имена.

Вы можете использовать страницы ИНФОРМАЦИИ (в меню), чтобы просматривать их в более тематическом порядке и получать ту же информацию об использовании.

Загрузите исходный код для Emacs. Перейдите в папку src / и введите:

grep -r DEFUN *

Вы получите список всех примитивных Lisp-функций Emacs.