diff options
author | Miles Bader <miles@gnu.org> | 2005-07-14 08:02:00 +0000 |
---|---|---|
committer | Miles Bader <miles@gnu.org> | 2005-07-14 08:02:00 +0000 |
commit | bacb9790f594207469f22ed9f3e8085ab76e5e2b (patch) | |
tree | b1cee62715d6cd2797f3122e4f058d7bc18ceef6 /lispref | |
parent | d3e4babdd1267fb5690a17949196640a47c6f159 (diff) | |
parent | ead25b5cabbe092711864eae13a76437e6a65ce1 (diff) | |
download | emacs-bacb9790f594207469f22ed9f3e8085ab76e5e2b.tar.gz |
Revision: miles@gnu.org--gnu-2005/emacs--unicode--0--patch-69
Merge from emacs--cvs-trunk--0
Patches applied:
* emacs--cvs-trunk--0 (patch 474-484)
- Update from CVS
- Merge from gnus--rel--5.10
* gnus--rel--5.10 (patch 88-91)
- Merge from emacs--cvs-trunk--0
- Update FSF's address in GPL notices
- Update from CVS
Diffstat (limited to 'lispref')
-rw-r--r-- | lispref/ChangeLog | 23 | ||||
-rw-r--r-- | lispref/README | 4 | ||||
-rw-r--r-- | lispref/book-spine.texinfo | 2 | ||||
-rw-r--r-- | lispref/customize.texi | 26 | ||||
-rw-r--r-- | lispref/display.texi | 14 | ||||
-rw-r--r-- | lispref/elisp.texi | 2 | ||||
-rw-r--r-- | lispref/os.texi | 2 |
7 files changed, 54 insertions, 19 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog index cddd1d506b0..d0590a47551 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,26 @@ +2005-07-13 Luc Teirlinck <teirllm@auburn.edu> + + * customize.texi (Variable Definitions): Add + `custom-initialize-safe-set' and `custom-initialize-safe-default'. + `standard-value' is a list too. + (Defining New Types): Use @key{RET} instead of @key{ret}. + +2005-07-13 Francis Litterio <franl@world.std.com> (tiny change) + + * os.texi (Translating Input): Fix typo. + +2005-07-08 Richard M. Stallman <rms@gnu.org> + + * README: Update edition number and size estimate. + + * elisp.texi (VERSION): Set to 2.9. + +2005-07-07 Richard M. Stallman <rms@gnu.org> + + * book-spine.texinfo: Update Emacs version. + + * display.texi (Inverse Video): Delete mode-line-inverse-video. + 2005-07-06 Richard M. Stallman <rms@gnu.org> * searching.texi (Regexp Search): Clarify what re-search-forward diff --git a/lispref/README b/lispref/README index 1600a5344b3..c9a49f8693b 100644 --- a/lispref/README +++ b/lispref/README @@ -1,4 +1,4 @@ -README for Edition 2.8 of the Emacs Lisp Reference Manual. +README for Edition 2.9 of the Emacs Lisp Reference Manual. * This directory contains the texinfo source files for the Reference Manual, make-permuted-index, and the latest version of texinfo.tex, @@ -11,7 +11,7 @@ Emacs bugs, use bug-gnu-emacs@gnu.org. To ask questions, use the newsgroup gnu.emacs.help. * The Emacs Lisp Reference Manual is quite large. It totals around -980 pages in smallbook format; the info files total almost +1100 pages in smallbook format; the info files total over 2.5 megabytes. * You can format this manual either for Info or for printing hardcopy diff --git a/lispref/book-spine.texinfo b/lispref/book-spine.texinfo index cb52cc6fc3c..7355c4530ae 100644 --- a/lispref/book-spine.texinfo +++ b/lispref/book-spine.texinfo @@ -11,7 +11,7 @@ @center @titlefont{GNU Emacs Lisp Reference Manual} @sp 5 @center GNU -@center Emacs Version 19.25 +@center Emacs Version 22.1 @center for Unix Users @sp 5 diff --git a/lispref/customize.texi b/lispref/customize.texi index baaceae47f0..8ee82f088a8 100644 --- a/lispref/customize.texi +++ b/lispref/customize.texi @@ -12,7 +12,7 @@ and also customization groups for classifying them. We use the term definitions---as well as face definitions (@pxref{Defining Faces}). @menu -* Common Keywords:: Common keyword arguments for all kinds of +* Common Keywords:: Common keyword arguments for all kinds of customization declarations. * Group Definitions:: Writing customization group definitions. * Variable Definitions:: Declaring user options. @@ -270,6 +270,22 @@ This is the default @code{:initialize} function. Use the @code{:set} function to initialize the variable, if it is already set or has been customized; otherwise, just use @code{set-default}. + +@item custom-initialize-safe-set +@itemx custom-initialize-safe-default +These functions behave like @code{custom-initialize-set} +(@code{custom-initialize-default}, respectively), but catch errors. +If an error occurs during initialization, they set the variable to +@code{nil} using @code{set-default}, and throw no error. + +These two functions are only meant for options defined in pre-loaded +files, where some variables or functions used to compute the option's +value may not yet be defined. The option normally gets updated in +@file{startup.el}, ignoring the previously computed value. Because of +this typical usage, the value which these two functions compute +normally only matters when, after startup, one unsets the option's +value and then reevaluates the defcustom. By that time, the necessary +variables and functions will be defined, so there will not be an error. @end table @item :set-after @var{variables} @@ -318,8 +334,8 @@ type of @var{symbol}. Internally, @code{defcustom} uses the symbol property @code{standard-value} to record the expression for the default value, and @code{saved-value} to record the value saved by the user with the -customization buffer. The @code{saved-value} property is actually a -list whose car is an expression which evaluates to the value. +customization buffer. Both properties are actually lists whose car is +an expression which evaluates to the value. @node Customization Types @section Customization Types @@ -1088,8 +1104,8 @@ widget. For the purpose of defining new customization types, the argument with the same syntax as the keyword argument to @code{defcustom} with the same name. The third argument is a documentation string for the new widget. You will be able to see that -string with the @kbd{M-x widget-browse @key{ret} binary-tree-of-string -@key{ret}} command. +string with the @kbd{M-x widget-browse @key{RET} binary-tree-of-string +@key{RET}} command. After these mandatory arguments follow the keyword arguments. The most important is @code{:type}, which describes the data type we want to match diff --git a/lispref/display.texi b/lispref/display.texi index 958ca0325e9..75d20f7e51c 100644 --- a/lispref/display.texi +++ b/lispref/display.texi @@ -1387,6 +1387,10 @@ modified, and the length of the pre-change text replaced by that range. length is the number of characters deleted, and the post-change beginning and end are equal.) +If these functions modify the buffer, they should bind +@code{inhibit-modification-hooks} to @code{t} around doing so, to +avoid confusing the internal mechanism that calls these hooks. + @item insert-in-front-hooks @kindex insert-in-front-hooks @r{(overlay property)} This property's value is a list of functions to be called before and @@ -1716,8 +1720,7 @@ This face is used for ordinary text. @item mode-line @kindex mode-line @r{(face name)} This face is used for the mode line of the selected window, and for -menu bars when toolkit menus are not used---but only if -@code{mode-line-inverse-video} is non-@code{nil}. +menu bars when toolkit menus are not used. @item modeline @kindex modeline @r{(face name)} @@ -4598,13 +4601,6 @@ on the screen. Non-@code{nil} means yes, @code{nil} means no. The default is @code{nil}. @end defopt -@defopt mode-line-inverse-video -This variable controls the use of inverse video for mode lines and -menu bars. If it is non-@code{nil}, then these lines are displayed in -the face @code{mode-line}. Otherwise, these lines are displayed -normally, just like other text. The default is @code{t}. -@end defopt - @node Usual Display @section Usual Display Conventions diff --git a/lispref/elisp.texi b/lispref/elisp.texi index f954cdc220e..64b4ee90292 100644 --- a/lispref/elisp.texi +++ b/lispref/elisp.texi @@ -6,7 +6,7 @@ @c Version of the manual and of Emacs. @c Please remember to update the edition number in README as well. -@set VERSION 2.7 +@set VERSION 2.9 @set EMACSVER 22.0.50 @dircategory Emacs diff --git a/lispref/os.texi b/lispref/os.texi index 7bc76799210..1e6dacb7d80 100644 --- a/lispref/os.texi +++ b/lispref/os.texi @@ -1721,7 +1721,7 @@ Note however that actual key bindings can have an effect on @code{key-translation-map}, even though they are overridden by it. Indeed, actual key bindings override @code{function-key-map} and thus may alter the key sequence that @code{key-translation-map} receives. -Clearly, it is better to avoid to avoid this type of situation. +Clearly, it is better to avoid this type of situation. The intent of @code{key-translation-map} is for users to map one character set to another, including ordinary characters normally bound |