diff options
| author | Chong Yidong | 2012-12-05 11:52:08 +0800 |
|---|---|---|
| committer | Chong Yidong | 2012-12-05 11:52:08 +0800 |
| commit | a20ae0b91d9075a9ab13448b93ceffeaf50ddf29 (patch) | |
| tree | b6dc9dd2227dd6365e5d8b9676c364312e9cfd62 | |
| parent | 0b2224850be3a839c6125cda44934d494f8b1f81 (diff) | |
| download | emacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.tar.gz emacs-a20ae0b91d9075a9ab13448b93ceffeaf50ddf29.zip | |
Minor fixes for Lisp manual.
* lists.texi (Plist Access): Move put example to Symbol Plists.
* symbols.texi (Standard Properties): Fix typo.
| -rw-r--r-- | doc/lispref/ChangeLog | 6 | ||||
| -rw-r--r-- | doc/lispref/lists.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/symbols.texi | 23 |
3 files changed, 22 insertions, 15 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 22f20c7112c..702db101549 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog | |||
| @@ -1,3 +1,9 @@ | |||
| 1 | 2012-12-05 Chong Yidong <cyd@gnu.org> | ||
| 2 | |||
| 3 | * lists.texi (Plist Access): Move put example to Symbol Plists. | ||
| 4 | |||
| 5 | * symbols.texi (Standard Properties): Fix typo. | ||
| 6 | |||
| 1 | 2012-12-02 Chong Yidong <cyd@gnu.org> | 7 | 2012-12-02 Chong Yidong <cyd@gnu.org> |
| 2 | 8 | ||
| 3 | * symbols.texi (Symbol Properties): New node. | 9 | * symbols.texi (Symbol Properties): New node. |
diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index 1a3d85b9b35..d2eea67da40 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, | |||
| 1936 | @end example | 1936 | @end example |
| 1937 | @end defun | 1937 | @end defun |
| 1938 | 1938 | ||
| 1939 | You could define @code{put} in terms of @code{plist-put} as follows: | ||
| 1940 | |||
| 1941 | @example | ||
| 1942 | (defun put (symbol prop value) | ||
| 1943 | (setplist symbol | ||
| 1944 | (plist-put (symbol-plist symbol) prop value))) | ||
| 1945 | @end example | ||
| 1946 | |||
| 1947 | @defun lax-plist-get plist property | 1939 | @defun lax-plist-get plist property |
| 1948 | Like @code{plist-get} except that it compares properties | 1940 | Like @code{plist-get} except that it compares properties |
| 1949 | using @code{equal} instead of @code{eq}. | 1941 | using @code{equal} instead of @code{eq}. |
diff --git a/doc/lispref/symbols.texi b/doc/lispref/symbols.texi index d3e5c1f1574..84009709156 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 | |||
| 449 | purposes, it may make sense to use the property list cell in a | 449 | purposes, it may make sense to use the property list cell in a |
| 450 | nonstandard fashion; in fact, the abbrev mechanism does so | 450 | nonstandard fashion; in fact, the abbrev mechanism does so |
| 451 | (@pxref{Abbrevs}). | 451 | (@pxref{Abbrevs}). |
| 452 | |||
| 453 | You could define @code{put} in terms of @code{setplist} and | ||
| 454 | @code{plist-put}, as follows: | ||
| 455 | |||
| 456 | @example | ||
| 457 | (defun put (symbol prop value) | ||
| 458 | (setplist symbol | ||
| 459 | (plist-put (symbol-plist symbol) prop value))) | ||
| 460 | @end example | ||
| 452 | @end defun | 461 | @end defun |
| 453 | 462 | ||
| 454 | @defun function-get symbol property | 463 | @defun function-get symbol property |
| @@ -474,8 +483,8 @@ documentation, for the named function. @xref{Keys in Documentation}. | |||
| 474 | The value, if non-@code{nil}, specifies the number of extra slots in | 483 | The value, if non-@code{nil}, specifies the number of extra slots in |
| 475 | the named char-table type. @xref{Char-Tables}. | 484 | the named char-table type. @xref{Char-Tables}. |
| 476 | 485 | ||
| 477 | @itemx customized-face | 486 | @item customized-face |
| 478 | @item face-defface-spec | 487 | @itemx face-defface-spec |
| 479 | @itemx saved-face | 488 | @itemx saved-face |
| 480 | @itemx theme-face | 489 | @itemx theme-face |
| 481 | These properties are used to record a face's standard, saved, | 490 | 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 | |||
| 483 | managed by @code{defface} and related functions. @xref{Defining | 492 | managed by @code{defface} and related functions. @xref{Defining |
| 484 | Faces}. | 493 | Faces}. |
| 485 | 494 | ||
| 486 | @itemx customized-value | 495 | @item customized-value |
| 487 | @itemx saved-value | 496 | @itemx saved-value |
| 488 | @item standard-value | 497 | @itemx standard-value |
| 489 | @itemx theme-value | 498 | @itemx theme-value |
| 490 | These properties are used to record a customizable variable's standard | 499 | These properties are used to record a customizable variable's standard |
| 491 | value, saved value, customized-but-unsaved value, and themed values. | 500 | value, saved value, customized-but-unsaved value, and themed values. |
| @@ -498,7 +507,7 @@ command. @xref{Disabling Commands}. | |||
| 498 | 507 | ||
| 499 | @item face-documentation | 508 | @item face-documentation |
| 500 | The value stores the documentation string of the named face. This is | 509 | The value stores the documentation string of the named face. This is |
| 501 | normally set automatically by @code{defface}. @xref{Defining Faces}. | 510 | set automatically by @code{defface}. @xref{Defining Faces}. |
| 502 | 511 | ||
| 503 | @item history-length | 512 | @item history-length |
| 504 | The value, if non-@code{nil}, specifies the maximum minibuffer history | 513 | 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. | |||
| 555 | 564 | ||
| 556 | @item variable-documentation | 565 | @item variable-documentation |
| 557 | If non-@code{nil}, this specifies the named vaariable's documentation | 566 | If non-@code{nil}, this specifies the named vaariable's documentation |
| 558 | string. This is normally set automatically by @code{defvar} and | 567 | string. This is set automatically by @code{defvar} and related |
| 559 | related functions. @xref{Defining Faces}. | 568 | functions. @xref{Defining Faces}. |
| 560 | @end table | 569 | @end table |