]> code.delx.au - gnu-emacs/blobdiff - lispref/symbols.texi
(url-current-object, url-package-name, url-package-version): Add defvars.
[gnu-emacs] / lispref / symbols.texi
index 858918445ffeabf749f28128d698f58ccc1d9773..9e4b482cfa0f3322fb5b9a1eaab6131b47b12074 100644 (file)
@@ -1,7 +1,7 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2003
-@c   Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2002, 2003,
+@c   2004, 2005 Free Software Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/symbols
 @node Symbols, Evaluation, Hash Tables, Top
@@ -115,10 +115,10 @@ the four cells of the symbol @code{buffer-file-name}:
      @result{} "buffer-file-name"
 (symbol-value 'buffer-file-name)
      @result{} "/gnu/elisp/symbols.texi"
-(symbol-plist 'buffer-file-name)
-     @result{} (variable-documentation 29529)
 (symbol-function 'buffer-file-name)
      @result{} #<subr buffer-file-name>
+(symbol-plist 'buffer-file-name)
+     @result{} (variable-documentation 29529)
 @end example
 
 @noindent
@@ -528,9 +528,7 @@ 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}.
-A @code{wrong-type-argument} error may be signaled if @var{plist} is
-not a valid property list.  For example,
+stored in the property list @var{plist}.  For example,
 
 @example
 (plist-get '(foo 4) 'foo)
@@ -540,16 +538,12 @@ not a valid property list.  For example,
 (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}
+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)
+(plist-get '(foo 4 bad) 'bar)
      @result{} nil
 @end example
 @end defun