aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2012-12-05 11:52:08 +0800
committerChong Yidong2012-12-05 11:52:08 +0800
commita20ae0b91d9075a9ab13448b93ceffeaf50ddf29 (patch)
treeb6dc9dd2227dd6365e5d8b9676c364312e9cfd62
parent0b2224850be3a839c6125cda44934d494f8b1f81 (diff)
downloademacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.tar.gz
emacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.zip
Minor fixes for Lisp manual.
* lists.texi (Plist Access): Move put example to Symbol Plists. * symbols.texi (Standard Properties): Fix typo.
-rw-r--r--doc/lispref/ChangeLog6
-rw-r--r--doc/lispref/lists.texi8
-rw-r--r--doc/lispref/symbols.texi23
3 files changed, 22 insertions, 15 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 22f20c7112c..702db101549 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,9 @@
12012-12-05 Chong Yidong <cyd@gnu.org>
2
3 * lists.texi (Plist Access): Move put example to Symbol Plists.
4
5 * symbols.texi (Standard Properties): Fix typo.
6
12012-12-02 Chong Yidong <cyd@gnu.org> 72012-12-02 Chong Yidong <cyd@gnu.org>
2 8
3 * symbols.texi (Symbol Properties): New node. 9 * symbols.texi (Symbol Properties): New node.
diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi
index 1a3d85b9b35..d2eea67da40 100644
--- a/doc/lispref/lists.texi
+++ b/doc/lispref/lists.texi
@@ -1936,14 +1936,6 @@ in the place where you got @var{plist}. For example,
1936@end example 1936@end example
1937@end defun 1937@end defun
1938 1938
1939 You could define @code{put} in terms of @code{plist-put} as follows:
1940
1941@example
1942(defun put (symbol prop value)
1943 (setplist symbol
1944 (plist-put (symbol-plist symbol) prop value)))
1945@end example
1946
1947@defun lax-plist-get plist property 1939@defun lax-plist-get plist property
1948Like @code{plist-get} except that it compares properties 1940Like @code{plist-get} except that it compares properties
1949using @code{equal} instead of @code{eq}. 1941using @code{equal} instead of @code{eq}.
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
449purposes, it may make sense to use the property list cell in a 449purposes, it may make sense to use the property list cell in a
450nonstandard fashion; in fact, the abbrev mechanism does so 450nonstandard fashion; in fact, the abbrev mechanism does so
451(@pxref{Abbrevs}). 451(@pxref{Abbrevs}).
452
453You could define @code{put} in terms of @code{setplist} and
454@code{plist-put}, as follows:
455
456@example
457(defun put (symbol prop value)
458 (setplist symbol
459 (plist-put (symbol-plist symbol) prop value)))
460@end example
452@end defun 461@end defun
453 462
454@defun function-get symbol property 463@defun function-get symbol property
@@ -474,8 +483,8 @@ documentation, for the named function. @xref{Keys in Documentation}.
474The value, if non-@code{nil}, specifies the number of extra slots in 483The value, if non-@code{nil}, specifies the number of extra slots in
475the named char-table type. @xref{Char-Tables}. 484the named char-table type. @xref{Char-Tables}.
476 485
477@itemx customized-face 486@item customized-face
478@item face-defface-spec 487@itemx face-defface-spec
479@itemx saved-face 488@itemx saved-face
480@itemx theme-face 489@itemx theme-face
481These properties are used to record a face's standard, saved, 490These 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
483managed by @code{defface} and related functions. @xref{Defining 492managed by @code{defface} and related functions. @xref{Defining
484Faces}. 493Faces}.
485 494
486@itemx customized-value 495@item customized-value
487@itemx saved-value 496@itemx saved-value
488@item standard-value 497@itemx standard-value
489@itemx theme-value 498@itemx theme-value
490These properties are used to record a customizable variable's standard 499These properties are used to record a customizable variable's standard
491value, saved value, customized-but-unsaved value, and themed values. 500value, saved value, customized-but-unsaved value, and themed values.
@@ -498,7 +507,7 @@ command. @xref{Disabling Commands}.
498 507
499@item face-documentation 508@item face-documentation
500The value stores the documentation string of the named face. This is 509The value stores the documentation string of the named face. This is
501normally set automatically by @code{defface}. @xref{Defining Faces}. 510set automatically by @code{defface}. @xref{Defining Faces}.
502 511
503@item history-length 512@item history-length
504The value, if non-@code{nil}, specifies the maximum minibuffer history 513The 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.
555 564
556@item variable-documentation 565@item variable-documentation
557If non-@code{nil}, this specifies the named vaariable's documentation 566If non-@code{nil}, this specifies the named vaariable's documentation
558string. This is normally set automatically by @code{defvar} and 567string. This is set automatically by @code{defvar} and related
559related functions. @xref{Defining Faces}. 568functions. @xref{Defining Faces}.
560@end table 569@end table