From: Chong Yidong Date: Wed, 5 Dec 2012 03:52:08 +0000 (+0800) Subject: Minor fixes for Lisp manual. X-Git-Url: https://git.hcoop.net/bpt/emacs.git/commitdiff_plain/a20ae0b91d9075a9ab13448b93ceffeaf50ddf29 Minor fixes for Lisp manual. * lists.texi (Plist Access): Move put example to Symbol Plists. * symbols.texi (Standard Properties): Fix typo. --- diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 22f20c7112..702db10154 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,9 @@ +2012-12-05 Chong Yidong + + * lists.texi (Plist Access): Move put example to Symbol Plists. + + * symbols.texi (Standard Properties): Fix typo. + 2012-12-02 Chong Yidong * symbols.texi (Symbol Properties): New node. diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index 1a3d85b9b3..d2eea67da4 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, @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}. diff --git a/doc/lispref/symbols.texi b/doc/lispref/symbols.texi index d3e5c1f157..8400970915 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