[Emacs-diffs] /srv/bzr/emacs/trunk r105116: Document several Emacs 24 changes.

[Chong Yidong]

------------------------------------------------------------
revno: 105116
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Mon 2011-07-11 21:38:28 -0400
message:
  Document several Emacs 24 changes.
  
  * doc/emacs/cmdargs.texi (Initial Options): Document --no-site-lisp.
  (Misc X): Document --parent-id.
  
  * doc/emacs/frames.texi (Frame Commands): Note that focus-follows-mouse now
  defaults to nil.
  
  * doc/emacs/misc.texi (emacsclient Options): Document --parent-id.
  
  * doc/emacs/msdog.texi (Windows HOME): Document _emacs as obsolete.
  
  * doc/man/emacsclient.1: Document exit status.
modified:
  doc/emacs/ChangeLog
  doc/emacs/cmdargs.texi
  doc/emacs/frames.texi
  doc/emacs/misc.texi
  doc/emacs/msdog.texi
  doc/man/ChangeLog
  doc/man/emacsclient.1
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2011-07-11 20:52:09 +0000
+++ b/doc/emacs/ChangeLog       2011-07-12 01:38:28 +0000
@@ -1,3 +1,15 @@
+2011-07-12  Chong Yidong  <address@hidden>
+
+       * cmdargs.texi (Initial Options): Document --no-site-lisp.
+       (Misc X): Document --parent-id.
+
+       * frames.texi (Frame Commands): Note that focus-follows-mouse now
+       defaults to nil.
+
+       * misc.texi (emacsclient Options): Document --parent-id.
+
+       * msdog.texi (Windows HOME): Document _emacs as obsolete.
+
 2011-07-11  Lars Magne Ingebrigtsen  <address@hidden>
 
        * emacs.texi: Use "..." instead of ``...'' in the menus

=== modified file 'doc/emacs/cmdargs.texi'
--- a/doc/emacs/cmdargs.texi    2011-07-10 14:29:19 +0000
+++ b/doc/emacs/cmdargs.texi    2011-07-12 01:38:28 +0000
@@ -289,9 +289,14 @@
 @item --no-site-file
 @opindex --no-site-file
 @cindex @file{site-start.el} file, not loading
-Do not load @file{site-start.el}.  The options @samp{-q}, @samp{-u}
-and @samp{--batch} have no effect on the loading of this file---this
-option and @samp{-Q} are the only options that block it.
+Do not load @file{site-start.el} (@pxref{Init File}).  The @samp{-Q}
+option does this too, but other options like @samp{-q} do not.
+
address@hidden --no-site-lisp
address@hidden --no-site-lisp
address@hidden @file{site-start.el} file, not loading
+Do not include the @file{site-lisp} directories in @code{load-path}
+(@pxref{Init File}).  The @samp{-Q} option does this too.
 
 @item --no-splash
 @opindex --no-splash
@@ -307,9 +312,9 @@
 @itemx --quick
 @opindex --quick
 Start emacs with minimum customizations, similar to using @samp{-q},
address@hidden, and @samp{--no-splash} together.  This also
-stops Emacs from processing X resources by setting
address@hidden to @code{t} (@pxref{Resources}).
address@hidden, @samp{--no-site-lisp}, and @samp{--no-splash}
+together.  This also stops Emacs from processing X resources by
+setting @code{inhibit-x-resources} to @code{t} (@pxref{Resources}).
 
 @item -daemon
 @opindex -daemon
@@ -1131,6 +1136,11 @@
 @c Enable horizontal scroll bars.  Since horizontal scroll bars
 @c are not yet implemented, this actually does nothing.
 
address@hidden --parent-id @var{ID}
+Open Emacs as a client X window via the XEmbed protocol, with @var{ID}
+as the parent X window id.  Currently, this option is mainly useful
+for developers.
+
 @item -vb
 @opindex -vb
 @itemx --vertical-scroll-bars

=== modified file 'doc/emacs/frames.texi'
--- a/doc/emacs/frames.texi     2011-07-11 18:40:48 +0000
+++ b/doc/emacs/frames.texi     2011-07-12 01:38:28 +0000
@@ -460,15 +460,15 @@
 can use @command{emacsclient} to reconnect to the Emacs session.
 
 @vindex focus-follows-mouse
-  On X, you may have to tell Emacs how the system (or the window
-manager) handles focus-switching between windows, in order for the
-command @kbd{C-x 5 o} (@code{other-frame}) to work properly.
-Unfortunately, there is no way for Emacs to detect this automatically,
-so you should set the variable @code{focus-follows-mouse}.  If simply
-moving the mouse onto a window selects it and gives it focus, the
-variable should be @code{t}; if you have to click on the window to
-select it, the variable should be @code{nil}.  The default is
address@hidden
+  On X, you may have to tell Emacs how the window manager handles
+focus-switching between windows, in order for @kbd{C-x 5 o}
+(@code{other-frame}) to work properly.  Unfortunately, there is no way
+for Emacs to detect this automatically, so you should set the variable
address@hidden  The default is @code{nil}, meaning you
+have to click on the window to select it (the default for most modern
+window managers).  You should change it to @code{t} if your window
+manager selects and window and gives it focus anytime you move the
+mouse onto the window.
 
   The window manager that is part of MS-Windows always gives focus to
 a frame that raises, so this variable has no effect in the native

=== modified file 'doc/emacs/misc.texi'
--- a/doc/emacs/misc.texi       2011-07-10 04:12:48 +0000
+++ b/doc/emacs/misc.texi       2011-07-12 01:38:28 +0000
@@ -1678,6 +1678,11 @@
 edit the server buffers within Emacs, and they are @emph{not} killed
 when you type @kbd{C-x #} in them.
 
address@hidden --parent-id @var{ID}
+Open an @command{emacsclient} frame as a client frame in the parent X
+window with id @var{ID}, via the XEmbed protocol.  Currently, this
+option is mainly useful for developers.
+
 @item -q
 @itemx --quiet
 Do not let @command{emacsclient} display messages about waiting for

=== modified file 'doc/emacs/msdog.texi'
--- a/doc/emacs/msdog.texi      2011-05-17 02:26:56 +0000
+++ b/doc/emacs/msdog.texi      2011-07-12 01:38:28 +0000
@@ -445,10 +445,10 @@
 
 @cindex @file{_emacs} init file, MS-Windows
   Because MS-DOS does not allow file names with leading dots, and
-because older Windows systems made it hard to create files with such
-names, the Windows port of Emacs supports an alternative name
address@hidden as a fallback, if such a file exists in the home
-directory, whereas @file{.emacs} does not.
+older Windows systems made it hard to create files with such names,
+the Windows port of Emacs supports an init file name @file{_emacs}, if
+such a file exists in the home directory and @file{.emacs} does not.
+This name is considered obsolete.
 
 @node Windows Keyboard
 @section Keyboard Usage on MS-Windows

=== modified file 'doc/man/ChangeLog'
--- a/doc/man/ChangeLog 2011-06-25 18:05:48 +0000
+++ b/doc/man/ChangeLog 2011-07-12 01:38:28 +0000
@@ -1,3 +1,7 @@
+2011-07-12  Chong Yidong  <address@hidden>
+
+       * emacsclient.1: Document exit status.
+
 2011-06-25  Andreas Rottmann  <address@hidden>
 
        * emacsclient.1: Mention --frame-parameters.

=== modified file 'doc/man/emacsclient.1'
--- a/doc/man/emacsclient.1     2011-06-25 18:05:48 +0000
+++ b/doc/man/emacsclient.1     2011-07-12 01:38:28 +0000
@@ -87,6 +87,9 @@
 .TP
 .B \-H, \-\-help
 print this usage information message and exit
+.SH "EXIT STATUS"
+Normally, the exit status is 0.  If emacsclient shuts down due to
+Emacs signaling an error, the exit status is 1.
 .SH "SEE ALSO"
 The program is documented fully in
 .IR "Using Emacs as a Server"

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2011-07-11 18:40:48 +0000
+++ b/etc/NEWS  2011-07-12 01:38:28 +0000
@@ -58,13 +58,16 @@
 
 * Startup Changes in Emacs 24.1
 
+---
 ** The --unibyte, --multibyte, --no-multibyte, and --no-unibyte
 command line arguments, and the EMACS_UNIBYTE environment variable, no
 longer have any effect.  (They were declared obsolete in Emacs 23.)
 
++++
 ** New command line option `--no-site-lisp' removes site-lisp directories
 from load-path.  -Q now implies this.
 
+---
 ** On Windows, Emacs now warns when the obsolete _emacs init file is used,
 and also when HOME is set to C:\ by default.
 
@@ -77,6 +80,7 @@
 
 ** emacsclient changes
 
++++
 *** New emacsclient argument --parent-id ID can be used to open a
 client frame in parent X window ID, via XEmbed.  This works like the
 --parent-id argument to Emacs.
@@ -88,10 +92,12 @@
 *** New emacsclient argument --frame-parameters can be used to set the
 frame parameters of a newly-created graphical frame.
 
++++
 *** If emacsclient shuts down as a result of Emacs signalling an
 error, its exit status is 1.
 
 ** Completion
+
 *** shell-mode uses pcomplete rules, with the standard completion UI.
 
 *** Many packages have been changed to use completion-at-point rather than
@@ -353,6 +359,7 @@
 ** The standalone program `fakemail' has been removed.
 If you need it, feedmail.el ought to provide a superset of the functionality.
 
++++
 ** The variable `focus-follows-mouse' now always defaults to nil.
 
 ** New primitive `secure-hash' that supports many secure hash algorithms