[Emacs-diffs] Changes to emacs/lispref/symbols.texi

[Kim F . Storm]

Index: emacs/lispref/symbols.texi
diff -c emacs/lispref/symbols.texi:1.23 emacs/lispref/symbols.texi:1.24
*** emacs/lispref/symbols.texi:1.23     Wed Jun 23 16:23:07 2004
--- emacs/lispref/symbols.texi  Mon Nov 15 15:19:48 2004
***************
*** 528,538 ****
  
  @defun plist-get plist property
  This returns the value of the @var{property} property
! stored in the property list @var{plist}.  For example,
  
  @example
  (plist-get '(foo 4) 'foo)
       @result{} 4
  @end example
  @end defun
  
--- 528,556 ----
  
  @defun plist-get plist property
  This returns the value of the @var{property} property
! stored in the property list @var{plist}.
! A @code{wrong-type-argument} error may be signaled if @var{plist} is
! not a valid property list.  For example,
  
  @example
  (plist-get '(foo 4) 'foo)
       @result{} 4
+ (plist-get '(foo 4 bad) 'foo)
+      @result{} 4
+ (plist-get '(foo 4 bad) 'bar)
+      @result{} @code{wrong-type-argument} error
+ @end example
+ @end defun
+ 
+ @defun safe-plist-get plist property
+ This returns the value of the @var{property} property
+ stored in the property list @var{plist}.  Unlike @code{plist-get}, it
+ accepts a malformed @var{plist} argument and always returns @code{nil}
+ if @var{property} is not found in the @var{plist}.  For example,
+ 
+ @example
+ (safe-plist-get '(foo 4 bad) 'bar)
+      @result{} nil
  @end example
  @end defun