emacs - 无法理解一行 Emacs Lisp

Question

行是

function info() { 
    emacs -eval "(progn (setq Man-notify-method 'bully) (info \"$1\"))" 
}

我从手册上知道

进程

progn is a special form in `C source code'.

Setq

setq is a special form in `C source code'. (setq SYM VAL SYM VAL ...)

Set each SYM to the value of its VAL. The symbols SYM are variables; they are literal (not evaluated). The values VAL are expressions; they are evaluated. Thus, (setq x (1+ y)) sets x' to the value of(1+ y)'. The second VAL is not computed until after the first SYM is set, and so on; each VAL can use the new value of variables set earlier in the setq'. The return
value of thesetq' form is the value of the last VAL.

$1 似乎是对用户给出的命令 man 之后的第一个参数的引用。

'bully 似乎是一个随机变量。

Man-notify-method 似乎是一个 Action 函数，在执行 man 命令时运行。

-eval 似乎是一个求值语句，它告诉 Emacs 运行它后面的语句。

但是，我对这个功能不是很确定。

我需要了解函数，因为我想将一个我的bash 代码 绑定(bind)到man 的操作函数。 Man-notify-method 似乎是那个 Action 函数，至少在 Emacs 中是这样。

Emacs Lisp这行你是怎么理解的？

Answer 1

您发布的代码是 shell 脚本和 elisp 的组合。

function info()
{
    emacs -eval "(progn (setq Man-notify-method 'bully) (info \"$1\"))"
}

这定义了一个名为 info 的 shell 脚本函数。它需要 1 个参数，名为 $1。当您调用此函数(例如，从另一个 shell 脚本)时，参数的值被替换为 $1，并且它按顺序运行指定的命令。所以，如果你这样调用它:

info("something")

shell 会执行这个命令:

emacs -eval "(progn (setq Man-notify-method 'bully) (info \"something\"))"

这会调用带有两个参数的 emacs 可执行文件，-eval 和包含嵌入的转义引号的命令字符串。这是要求 emacs 调用以下 elisp 代码:

(progn (setq Man-notify-method 'bully) (info "something"))

progn 是一种特殊形式。特殊形式以不同于普通函数调用的方式评估它们的参数。您可以在 chapter 10.1 of the GNU Emacs Lisp Reference Manual 中找到 progn 的文档. progn 是一个简单的结构，用于按顺序执行一系列语句。您可能需要这样做的原因是您想要执行多个语句，但您所在的上下文只需要一个语句。

例如，if 语句有 3 个(或更多)参数:要计算的条件、如果为真则要计算的表达式以及如果为假则要计算的表达式。如果提供的参数超过 3 个，则后续参数是 else 分支的一部分。如果要在真分支中使用多个语句，则必须使用 progn:

(if condition
   (progn first-statement-if-true
          second-statement-if-true)
   first-statement-if-false
   second-statement-if-false
)

在这种情况下，如果 condition 为真，则 first-statement-if-true 和 second-statement-if-true 将进行评估。否则，将评估 first-statement-if-false 和 second-statement-if-false。

因此，您的代码将简单地按顺序评估两个语句 (setq Man-notify-method 'bully) 和 (info "something")。

setq 是另一种特殊形式。参见 chapter 11.8用于其文档。它只是将一个由第一个参数命名的变量设置为第二个参数的值。第一个参数不被评估——它是按字面意思理解的。

不评估前面带有单引号的值(例如 'bully)。参见 chapter 9.3有关报价的详细信息。因此，(setq Man-notify-method) 将名为 Man-notify-method 的变量设置为文字标记 bully(这是一个数据类型称为 symbol，它不同于字符串 "bully")。

我无法在网上找到有关 info 函数的文档，您可以通过键入 C-h f function-name 获得有关 emacs 中任何给定函数的帮助。所以，通过输入 C-h f info，我得到了这个:

info is an interactive autoloaded Lisp function in `info'.[Arg list not available until function definition is loaded.]Enter Info, the documentation browser.Optional argument FILE specifies the file to examine;the default is the top-level directory of Info.Called from a program, FILE may specify an Info node of the form`(FILENAME)NODENAME'.In interactive use, a prefix argument directs this commandto read a file name from the minibuffer.The search path for Info files is in the variable `Info-directory-list'.The top-level Info directory is made by combining all the files named `dir'in all the directories in that path.

在线引用手册非常有用，emacs的交互式帮助也是必不可少的。如果您不了解某个特定函数的作用，只需 C-h f 即可。