# HG changeset patch
# User Kim F. Storm <storm@cua.dk>
# Date 1113901911 0
# Node ID d1980873b72251c036002e267117199fb9b1a02b
# Parent  a39c60b30e5a07c6a872f6104f1bf59ae904106c
(Symbol Plists): Add safe-get.
Mention that `get' may signal an error.

diff -r a39c60b30e5a -r d1980873b722 lispref/symbols.texi
--- a/lispref/symbols.texi	Tue Apr 19 08:34:50 2005 +0000
+++ b/lispref/symbols.texi	Tue Apr 19 09:11:51 2005 +0000
@@ -496,6 +496,8 @@
 @var{symbol}'s property list.  If there is no such property, @code{nil}
 is returned.  Thus, there is no distinction between a value of
 @code{nil} and the absence of the property.
+A @code{wrong-type-argument} error may be signaled if @var{symbol}
+has a malformed property list.
 
 The name @var{property} is compared with the existing property names
 using @code{eq}, so any object is a legitimate property.
@@ -503,6 +505,12 @@
 See @code{put} for an example.
 @end defun
 
+@defun safe-get symbol property
+This function finds the value of the property named @var{property} in
+@var{symbol}'s property list.  Unlike @code{get}, it just returns
+@code{nil} if @var{symbol} has a malformed property list.
+@end defun
+
 @defun put symbol property value
 This function puts @var{value} onto @var{symbol}'s property list under
 the property name @var{property}, replacing any previous property value.