Fix the description of --insert command-line option (Bug#19694)

 doc/emacs/cmdargs.texi (Action Arguments): Clarify into which buffer
 '--insert' inserts.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index d1378a34c19d95499bedad18604e9e0a8851f688..93ae618d1bcb01240f03bc167644dda1fb1bfd91 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,8 @@
+2015-01-26  Eli Zaretskii  <eliz@gnu.org>
+
+       * cmdargs.texi (Action Arguments): Clarify into which buffer
+       '--insert' inserts.  (Bug#19694)
+
 2015-01-21  Eli Zaretskii  <eliz@gnu.org>
 
        * programs.texi (Custom C Indent): Fix a typo.  (Bug#19647)

diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi
index f724f77e230b1bee11df869c4be7189bdcb9aff9..42c8e33d5c776af541d9107e128ba6d985ad81e1 100644 (file)
--- a/doc/emacs/cmdargs.texi
+++ b/doc/emacs/cmdargs.texi
@@ -165,9 +165,12 @@ Evaluate Lisp expression @var{expression}.
 @item --insert=@var{file}
 @opindex --insert
 @cindex insert file contents, command-line argument
-Insert the contents of @var{file} into the @file{*scratch*} buffer
-(@pxref{Lisp Interaction}).  This is like what @kbd{M-x insert-file}
-does (@pxref{Misc File Ops}).
+Insert the contents of @var{file} into the buffer that is current when
+this command-line argument is processed.  Usually, this is the
+@file{*scratch*} buffer (@pxref{Lisp Interaction}), but if arguments
+earlier on the command line visit files or switch buffers, that might
+be a different buffer.  The effect of this command-line argument is
+like what @kbd{M-x insert-file} does (@pxref{Misc File Ops}).
 
 @item --kill
 @opindex --kill