summaryrefslogtreecommitdiff
path: root/doc/lispref/symbols.texi
diff options
context:
space:
mode:
authorChong Yidong <cyd@gnu.org>2012-12-05 11:52:08 +0800
committerChong Yidong <cyd@gnu.org>2012-12-05 11:52:08 +0800
commita20ae0b91d9075a9ab13448b93ceffeaf50ddf29 (patch)
treeb6dc9dd2227dd6365e5d8b9676c364312e9cfd62 /doc/lispref/symbols.texi
parent0b2224850be3a839c6125cda44934d494f8b1f81 (diff)
downloademacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.tar.gz
emacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.tar.bz2
emacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.zip
Minor fixes for Lisp manual.
* lists.texi (Plist Access): Move put example to Symbol Plists. * symbols.texi (Standard Properties): Fix typo.
Diffstat (limited to 'doc/lispref/symbols.texi')
-rw-r--r--doc/lispref/symbols.texi23
1 files changed, 16 insertions, 7 deletions
diff --git a/doc/lispref/symbols.texi b/doc/lispref/symbols.texi
index d3e5c1f1574..84009709156 100644
--- a/doc/lispref/symbols.texi
+++ b/doc/lispref/symbols.texi
@@ -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