[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100222: Document some Emacs 23.3 changes in manuals.

[Chong Yidong]

------------------------------------------------------------
revno: 100222
committer: Chong Yidong <address@hidden>
branch nick: emacs-23
timestamp: Sat 2010-11-20 14:52:20 -0500
message:
  Document some Emacs 23.3 changes in manuals.
  
  * doc/emacs/macos.texi (Mac / GNUstep Basics): Document
  ns-right-alternate-modifier.
  
  * doc/lispref/numbers.texi (Float Basics): Document float-e and float-pi.
  
  * doc/lispref/symbols.texi (Creating Symbols): Using unintern without an
  obarray arg is now obsolete.
  
  * doc/lispref/text.texi (Kill Functions, Kill Functions)
  (Low-Level Kill Ring, Low-Level Kill Ring): Remove obsolete
  YANK-HANDLER args.
  
  * doc/lispref/variables.texi (Defining Variables): Change "pi" example to
  "float-pi".
modified:
  doc/emacs/ChangeLog
  doc/emacs/macos.texi
  doc/lispref/ChangeLog
  doc/lispref/numbers.texi
  doc/lispref/symbols.texi
  doc/lispref/text.texi
  doc/lispref/variables.texi
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2010-11-06 10:23:33 +0000
+++ b/doc/emacs/ChangeLog       2010-11-20 19:52:20 +0000
@@ -1,3 +1,8 @@
+2010-11-20  Chong Yidong  <address@hidden>
+
+       * macos.texi (Mac / GNUstep Basics): Document
+       ns-right-alternate-modifier.
+
 2010-11-06  Eli Zaretskii  <address@hidden>
 
        * msdog.texi (Windows HOME): Add information regarding startup

=== modified file 'doc/emacs/macos.texi'
--- a/doc/emacs/macos.texi      2010-01-13 08:35:10 +0000
+++ b/doc/emacs/macos.texi      2010-11-20 19:52:20 +0000
@@ -8,23 +8,22 @@
 @cindex Macintosh
 @cindex GNUstep
 
-  This section briefly describes the peculiarities of using Emacs built with
-the GNUstep libraries on GNU/Linux or other operating systems, or on Mac OS X
-with native window system support.  For Mac OS X, Emacs can be built either
-without window system support, with X11, or with the Cocoa interface.  This
-section only applies to the Cocoa build.  Emacs 23 does not support Mac OS
-Classic.
+  This section describes the peculiarities of using Emacs built with
+the GNUstep libraries on GNU/Linux or other operating systems, or on
+Mac OS X with native window system support.  On Mac OS X, Emacs can be
+built either without window system support, with X11, or with the
+Cocoa interface; this section only applies to the Cocoa build.  Emacs
+does not support earlier versions of Mac OS.
 
-  Emacs, when built on Mac OS X, uses the Cocoa application interface.  For
-various historical and technical reasons, Emacs uses the term @samp{Nextstep}
-internally, instead of ``Cocoa'' or ``Mac OS X''; for instance, most of the
-commands and variables described in the following sections begin with
address@hidden, which is short for @samp{Nextstep}.  NeXTstep was an application
-interface released by NeXT Inc during the 1980s, of which Cocoa is a direct
-descendant.  Apart from Cocoa, there is another NeXTstep-style system:
-GNUstep, which is free software.  As of this writing, the GNUstep support is
-alpha status (@pxref{GNUstep Support}), but we hope to improve it in the
-future.
+  For various historical and technical reasons, Emacs uses the term
address@hidden internally, instead of ``Cocoa'' or ``Mac OS X''; for
+instance, most of the commands and variables described in this section
+begin with @samp{ns-}, which is short for @samp{Nextstep}.  NeXTstep
+was an application interface released by NeXT Inc during the 1980s, of
+which Cocoa is a direct descendant.  Apart from Cocoa, there is
+another NeXTstep-style system: GNUstep, which is free software.  As of
+this writing, the GNUstep support is alpha status (@pxref{GNUstep
+Support}), but we hope to improve it in the future.
 
 @menu
 * Mac / GNUstep Basics::        Basic Emacs usage under GNUstep or Mac OS.
@@ -37,19 +36,24 @@
 @section Basic Emacs usage under Mac OS and GNUstep
 
   By default, the @key{alt} and @key{option} keys are the same as
address@hidden when running under Mac OS.  The Mac @key{Cmd} key is the
-same as @key{Super}, and Emacs provides a set of keybindings using
-this modifier key that mimic other Mac / GNUstep applications (@pxref{Mac /
-GNUstep Events}).  You can change these bindings in the usual way (@pxref{Key
-Bindings}).
-
-  The standard Mac / GNUstep font and color panels are accessible via Lisp 
commands.
-  To use the color panel, drag from it to an Emacs frame to change the
-foreground color of the face at that position (if the @key{shift} key
-is held down, it changes the background color instead). To discard the
-settings, create a new frame and close the altered one.
address@hidden [unclear if the following holds.]
address@hidden  To finalize the settings for either color or font, choose 
@samp{Save Options} in the @samp{Options} menu. 
address@hidden  The Mac @key{Cmd} key is the same as @key{Super}, and
+Emacs provides a set of keybindings using this modifier key that mimic
+other Mac / GNUstep applications (@pxref{Mac / GNUstep Events}).  You
+can change these bindings in the usual way (@pxref{Key Bindings}).
+
+  The variable @code{ns-right-alternate-modifier} controls the
+behavior of the right @key{alt} and @key{option} keys.  These keys
+behave like the left-hand keys if the value is @code{left} (the
+default).  A value of @code{control}, @code{meta}, @code{alt},
address@hidden, or @code{hyper} makes them behave like the corresponding
+modifier keys; a value of @code{none} tells Emacs to ignore them.
+
+  The standard Mac / GNUstep font and color panels are accessible via
+Lisp commands.  To use the color panel, drag from it to an Emacs frame
+to change the foreground color of the face at that position (if the
address@hidden key is held down, it changes the background color
+instead). To discard the settings, create a new frame and close the
+altered one.
 
   @key{S-Mouse-1} (i.e., clicking the left mouse button
 while holding down the @key{Shift} key) adjusts the region to the
@@ -58,7 +62,7 @@
 @key{S-Mouse-1} normally does (@pxref{Temporary Face Changes}).  This
 change makes Emacs behave more like other Mac / GNUstep applications.
 
-  When you open or save files using the menus, or using the 
+  When you open or save files using the menus, or using the
 @key{Cmd-o} and @key{Cmd-S} bindings, Emacs uses graphical file
 dialogs to read file names.  However, if you use the regular Emacs key
 sequences, such as @key{C-x C-f}, Emacs uses the minibuffer to read
@@ -110,7 +114,7 @@
 background color.
 
 @c To make the changes permanent select the "Save Options"
address@hidden item in the "Options" menu, or run @code{menu-bar-options-save}. 
address@hidden item in the "Options" menu, or run @code{menu-bar-options-save}.
 
 Useful in this context is the listing of all faces obtained by @key{M-x}
 @code{list-faces-display}.
@@ -193,7 +197,7 @@
 @code{ns-input-fontsize}, respectively.
 
 @item ns-power-off
-This event occurs when the user logs out and Emacs is still running, or when 
+This event occurs when the user logs out and Emacs is still running, or when
 `Quit Emacs' is chosen from the application menu.
 The default behavior is to save all file-visiting buffers.
 @end table
@@ -208,26 +212,9 @@
 services and receive the results back.  Note that you may need to
 restart Emacs to access newly-available services.
 
-
 @node GNUstep Support, , Mac / GNUstep Events, Mac OS / GNUstep
 @section GNUstep Support
 
-Emacs can be built and run under GNUstep, however there are still some
+Emacs can be built and run under GNUstep, but there are still some
 issues to be addressed.  Interested developers should contact
 @email{emacs-devel@@gnu.org}.
-
address@hidden Presumably no longer relevant since CANNOT_DUMP removed 
2009-05-06:
address@hidden
-In particular, it may be necessary to run @samp{make bootstrap} with a
-plain X configuration, then @samp{make clean} and @samp{./configure
---with-ns} followed by @samp{make install}.
-
-Currently CANNOT_DUMP is automatically enabled in GNUstep configurations,
-because the unex file(s) for GNUstep, mainly @samp{unexelf.c}, have not been
-updated yet with the ``zone'' code in and related to @samp{unexmacosx.c}.
address@hidden ignore
-
-
address@hidden
-   arch-tag: a822c2ab-4273-4997-927e-c153bb71dcf6
address@hidden ignore

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2010-11-12 17:03:57 +0000
+++ b/doc/lispref/ChangeLog     2010-11-20 19:52:20 +0000
@@ -1,3 +1,17 @@
+2010-11-20  Chong Yidong  <address@hidden>
+
+       * text.texi (Kill Functions, Kill Functions)
+       (Low-Level Kill Ring, Low-Level Kill Ring): Remove obsolete
+       YANK-HANDLER args.
+
+       * symbols.texi (Creating Symbols): Using unintern without an
+       obarray arg is now obsolete.
+
+       * numbers.texi (Float Basics): Document float-e and float-pi.
+
+       * variables.texi (Defining Variables): Change "pi" example to
+       "float-pi".
+
 2010-11-12  Eli Zaretskii  <address@hidden>
 
        * customize.texi (Composite Types): Lower-case index entry.

=== modified file 'doc/lispref/numbers.texi'
--- a/doc/lispref/numbers.texi  2010-06-23 03:36:56 +0000
+++ b/doc/lispref/numbers.texi  2010-11-20 19:52:20 +0000
@@ -224,6 +224,14 @@
 @end example
 @end defun
 
address@hidden float-e
+The mathematical constant @math{e} (address@hidden).
address@hidden defvar
+
address@hidden float-pi
+The mathematical constant @math{pi} (address@hidden).
address@hidden defvar
+
 @node Predicates on Numbers
 @section Type Predicates for Numbers
 @cindex predicates for numbers

=== modified file 'doc/lispref/symbols.texi'
--- a/doc/lispref/symbols.texi  2010-01-13 08:35:10 +0000
+++ b/doc/lispref/symbols.texi  2010-11-20 19:52:20 +0000
@@ -383,7 +383,7 @@
 example using @code{mapatoms}.
 @end defun
 
address@hidden unintern symbol &optional obarray
address@hidden unintern symbol obarray
 This function deletes @var{symbol} from the obarray @var{obarray}.  If
 @code{symbol} is not actually in the obarray, @code{unintern} does
 nothing.  If @var{obarray} is @code{nil}, the current obarray is used.

=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi     2010-11-10 08:42:42 +0000
+++ b/doc/lispref/text.texi     2010-11-20 19:52:20 +0000
@@ -865,7 +865,7 @@
 @code{last-command}) whether the previous command was a kill command,
 and if so appends the killed text to the most recent entry.
 
address@hidden Command kill-region start end &optional yank-handler
address@hidden Command kill-region start end
 This function kills the text in the region defined by @var{start} and
 @var{end}.  The text is deleted but saved in the kill ring, along with
 its text properties.  The value is always @code{nil}.
@@ -873,17 +873,10 @@
 In an interactive call, @var{start} and @var{end} are point and
 the mark.
 
address@hidden Emacs 19 feature
 If the buffer or text is read-only, @code{kill-region} modifies the kill
 ring just the same, then signals an error without modifying the buffer.
 This is convenient because it lets the user use a series of kill
 commands to copy text from a read-only buffer into the kill ring.
-
-If @var{yank-handler} is address@hidden, this puts that value onto
-the string of killed text, as a @code{yank-handler} text property.
address@hidden  Note that if @var{yank-handler} is @code{nil}, any
address@hidden properties present on the killed text are copied
-onto the kill ring, like other text properties.
 @end deffn
 
 @defopt kill-read-only-ok
@@ -1068,7 +1061,7 @@
 move the yanking pointer.
 @end defun
 
address@hidden kill-new string &optional replace yank-handler
address@hidden kill-new string &optional replace
 This function pushes the text @var{string} onto the kill ring and
 makes the yanking pointer point to it.  It discards the oldest entry
 if appropriate.  It also invokes the value of
@@ -1077,25 +1070,15 @@
 If @var{replace} is address@hidden, then @code{kill-new} replaces the
 first element of the kill ring with @var{string}, rather than pushing
 @var{string} onto the kill ring.
-
-If @var{yank-handler} is address@hidden, this puts that value onto
-the string of killed text, as a @code{yank-handler} property.
address@hidden  Note that if @var{yank-handler} is @code{nil}, then
address@hidden copies any @code{yank-handler} properties present on
address@hidden onto the kill ring, as it does with other text properties.
 @end defun
 
address@hidden kill-append string before-p &optional yank-handler
address@hidden kill-append string before-p
 This function appends the text @var{string} to the first entry in the
 kill ring and makes the yanking pointer point to the combined entry.
 Normally @var{string} goes at the end of the entry, but if
 @var{before-p} is address@hidden, it goes at the beginning.  This
 function also invokes the value of @code{interprogram-cut-function}
-(see below).  This handles @var{yank-handler} just like
address@hidden, except that if @var{yank-handler} is different from
-the @code{yank-handler} property of the first entry of the kill ring,
address@hidden pushes the concatenated string onto the kill ring,
-instead of replacing the original first entry with it.
+(see below).
 @end defun
 
 @defvar interprogram-paste-function

=== modified file 'doc/lispref/variables.texi'
--- a/doc/lispref/variables.texi        2010-01-13 08:35:10 +0000
+++ b/doc/lispref/variables.texi        2010-11-20 19:52:20 +0000
@@ -544,21 +544,23 @@
 buffer-local bindings for a symbol that is defined with
 @code{defconst}.)
 
-Here, @code{pi} is a constant that presumably ought not to be changed
-by anyone (attempts by the Indiana State Legislature notwithstanding).
-As the second form illustrates, however, this is only advisory.
+An example of the use of @code{defconst} is Emacs' definition of
address@hidden mathematical constant @math{pi}, which ought not
+to be changed by anyone (attempts by the Indiana State Legislature
+notwithstanding).  As the second form illustrates, however,
address@hidden is only advisory.
 
 @example
 @group
-(defconst pi 3.1415 "Pi to five places.")
-     @result{} pi
address@hidden group
address@hidden
-(setq pi 3)
-     @result{} pi
address@hidden group
address@hidden
-pi
+(defconst float-pi 3.141592653589793 "The value of Pi.")
+     @result{} float-pi
address@hidden group
address@hidden
+(setq float-pi 3)
+     @result{} float-pi
address@hidden group
address@hidden
+float-pi
      @result{} 3
 @end group
 @end example

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2010-11-18 02:09:41 +0000
+++ b/etc/NEWS  2010-11-20 19:52:20 +0000
@@ -26,9 +26,6 @@
 
 * Changes in Emacs 23.3
 
-** The nextstep port can have different modifiers for the left and right
-alt/option key by customizing the value for ns-right-alternate-modifier.
-
 
 * Editing Changes in Emacs 23.3
 
@@ -82,10 +79,12 @@
 
 
 * New Modes and Packages in Emacs 23.3
+
 ** smie.el is a generic navigation and indentation engine.
 It takes a simple BNF description of the grammar, and provides both
 sexp-style navigation (jumping over begin..end pairs) as well as
 indentation, which can be adjusted via ad-hoc indentation rules.
+
 
 * Incompatible Lisp Changes in Emacs 23.3
 
@@ -96,16 +95,28 @@
 
 * Lisp changes in Emacs 23.3
 
++++
 ** `e' and `pi' are now called `float-e' and `float-pi'.
   The old names are obsolete.
-** The use of unintern without an obarray arg is declared obsolete.
-** The function `princ-list' is declared obsolete.
-** The yank-handler argument to kill-region and friends is declared obsolete.
+
++++
+** The use of unintern without an obarray arg is now obsolete.
+
+---
+** The function `princ-list' is now obsolete.
+
++++
+** The yank-handler argument to kill-region and friends is now obsolete.
+
 ** New function byte-to-string, like char-to-string but for bytes.
 
 
 * Changes in Emacs 23.3 on non-free operating systems
 
++++
+** The nextstep port can have different modifiers for the left and right
+alt/option key by customizing the value for ns-right-alternate-modifier.
+
 
 * Installation Changes in Emacs 23.2