[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/lispref symbols.texi
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] emacs/doc/lispref symbols.texi |
Date: |
Sun, 22 Feb 2009 21:56:05 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Chong Yidong <cyd> 09/02/22 21:56:05
Modified files:
doc/lispref : symbols.texi
Log message:
(Property Lists): Emphasize that property lists are not restricted to
symbol cells.
(Other Plists): Copyedit.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/symbols.texi?cvsroot=emacs&r1=1.6&r2=1.7
Patches:
Index: symbols.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/symbols.texi,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- symbols.texi 8 Jan 2009 05:29:02 -0000 1.6
+++ symbols.texi 22 Feb 2009 21:56:05 -0000 1.7
@@ -403,15 +403,17 @@
@cindex plist
A @dfn{property list} (@dfn{plist} for short) is a list of paired
-elements stored in the property list cell of a symbol. Each of the
-pairs associates a property name (usually a symbol) with a property or
-value. Property lists are generally used to record information about a
-symbol, such as its documentation as a variable, the name of the file
-where it was defined, or perhaps even the grammatical class of the
-symbol (representing a word) in a language-understanding system.
+elements. Each of the pairs associates a property name (usually a
+symbol) with a property or value.
- Character positions in a string or buffer can also have property lists.
address@hidden Properties}.
+ Every symbol has a cell that stores a property list (@pxref{Symbol
+Components}). This property list is used to record information about
+the symbol, such as its variable documentation and the name of the
+file where it was defined.
+
+ Property lists can also be used in other contexts. For instance,
+you can assign property lists to character positions in a string or
+buffer. @xref{Text Properties}.
The property names and values in a property list can be any Lisp
objects, but the names are usually symbols. Property list functions
@@ -529,8 +531,10 @@
that are stored in places other than symbols:
@defun plist-get plist property
-This returns the value of the @var{property} property
-stored in the property list @var{plist}. For example,
+This returns the value of the @var{property} property stored in the
+property list @var{plist}. It accepts a malformed @var{plist}
+argument. If @var{property} is not found in the @var{plist}, it
+returns @code{nil}. For example,
@example
(plist-get '(foo 4) 'foo)
@@ -539,12 +543,6 @@
@result{} 4
(plist-get '(foo 4 bad) 'bad)
@result{} @code{nil}
address@hidden example
-
-It accepts a malformed @var{plist} argument and always returns @code{nil}
-if @var{property} is not found in the @var{plist}. For example,
-
address@hidden
(plist-get '(foo 4 bad) 'bar)
@result{} nil
@end example
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs/doc/lispref symbols.texi,
Chong Yidong <=