procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Minor fixes for Lisp manual.

Browse source 
* lists.texi (Plist Access): Move put example to Symbol Plists.

* symbols.texi (Standard Properties): Fix typo.
This commit is contained in:
Chong Yidong 2012-12-05 11:52:08 +08:00
parent 0b2224850b
commit a20ae0b91d
3 changed files with 22 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/lispref/ChangeLog
View file

@ -1,3 +1,9 @@
2012-12-05 Chong Yidong <cyd@gnu.org>
* lists.texi (Plist Access): Move put example to Symbol Plists.
* symbols.texi (Standard Properties): Fix typo.
2012-12-02 Chong Yidong <cyd@gnu.org>
* symbols.texi (Symbol Properties): New node.

8
doc/lispref/lists.texi
View file

@ -1936,14 +1936,6 @@ in the place where you got @var{plist}. For example,
@end example
@end defun
You could define @code{put} in terms of @code{plist-put} as follows:
@example
(defun put (symbol prop value)
(setplist symbol
(plist-put (symbol-plist symbol) prop value)))
@end example
@defun lax-plist-get plist property
Like @code{plist-get} except that it compares properties
using @code{equal} instead of @code{eq}.

23
doc/lispref/symbols.texi
View file

@ -449,6 +449,15 @@ For symbols in special obarrays, which are not used for ordinary
purposes, it may make sense to use the property list cell in a
nonstandard fashion; in fact, the abbrev mechanism does so
(@pxref{Abbrevs}).
You could define @code{put} in terms of @code{setplist} and
@code{plist-put}, as follows:
@example
(defun put (symbol prop value)
(setplist symbol
(plist-put (symbol-plist symbol) prop value)))
@end example
@end defun
@defun function-get symbol property
@ -474,8 +483,8 @@ documentation, for the named function. @xref{Keys in Documentation}.
The value, if non-@code{nil}, specifies the number of extra slots in
the named char-table type. @xref{Char-Tables}.
@itemx customized-face
@item face-defface-spec
@item customized-face
@itemx face-defface-spec
@itemx saved-face
@itemx theme-face
These properties are used to record a face's standard, saved,
@ -483,9 +492,9 @@ customized, and themed face specs. Do not set them directly; they are
managed by @code{defface} and related functions. @xref{Defining
Faces}.
@itemx customized-value
@item customized-value
@itemx saved-value
@item standard-value
@itemx standard-value
@itemx theme-value
These properties are used to record a customizable variable's standard
value, saved value, customized-but-unsaved value, and themed values.
@ -498,7 +507,7 @@ command. @xref{Disabling Commands}.
@item face-documentation
The value stores the documentation string of the named face. This is
normally set automatically by @code{defface}. @xref{Defining Faces}.
set automatically by @code{defface}. @xref{Defining Faces}.
@item history-length
The value, if non-@code{nil}, specifies the maximum minibuffer history
@ -555,6 +564,6 @@ Safety}) as well as for byte compiler optimizations. Do not set it.
@item variable-documentation
If non-@code{nil}, this specifies the named vaariable's documentation
string. This is normally set automatically by @code{defvar} and
related functions. @xref{Defining Faces}.
string. This is set automatically by @code{defvar} and related
functions. @xref{Defining Faces}.
@end table