Github/emacs
2
0
Fork 1
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-16 09:14:18 +00:00
Code Issues Projects Releases Packages Wiki Activity

; Improve indexing in the ELisp manual

Browse source 
* doc/lispref/functions.texi (Function Names):
* doc/lispref/variables.texi (Tips for Defining): Improve
indexing.
This commit is contained in:
Eli Zaretskii 2026-02-02 15:24:21 +02:00
parent a269bcb86b
commit 16b10d7617
2 changed files with 4 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
doc/lispref/functions.texi
View file

@ -674,6 +674,7 @@ variable; these two uses of a symbol are independent and do not
conflict. (This is not the case in some dialects of Lisp, like
Scheme.)
@cindex internal functions, naming conventions
By convention, if a function's symbol consists of two names
separated by @samp{--}, the function is intended for internal use and
the first part names the file defining the function. For example, a

3
doc/lispref/variables.texi
View file

@ -617,6 +617,8 @@ float-pi
@node Tips for Defining
@section Tips for Defining Variables Robustly
@cindex variables, naming conventions
@cindex naming conventions, variables
When you define a variable whose value is a function, or a list of
functions, use a name that ends in @samp{-function} or
@ -659,6 +661,7 @@ The value is a whole shell command.
@item @dots{}-switches
The value specifies options for a command.
@cindex internal variables, naming conventions
@item @var{prefix}--@dots{}
The variable is intended for internal use and is defined in the file
@file{@var{prefix}.el}. (Emacs code contributed before 2018 may