Tiny doc tweaks for call-process's :file spec.

* doc/lispref/processes.texi (Synchronous Processes):
Mention call-process's :file gets overwritten.

* src/callproc.c (Fcall_process, Fcall_process_region): Doc fix.

* etc/NEWS: Markup.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index f95b53b..b441248 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,8 @@
 2012-02-02  Glenn Morris  <rgm@gnu.org>
 
+       * processes.texi (Synchronous Processes):
+       Mention call-process's :file gets overwritten.
+
        * commands.texi (Reading One Event):
        * help.texi (Help Functions): Document read-char-choice.
 

diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 38eb5a8..4cfc954 100644 (file)
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -300,7 +300,8 @@ MS-DOS doesn't support asynchronous subprocesses, so this option doesn't
 work there.
 
 @item @code{(:file @var{file-name})}
-Send the output to the file name specified.
+Send the output to the file name specified, overwriting it if it
+already exists.
 
 @item @code{(@var{real-destination} @var{error-destination})}
 Keep the standard output stream separate from the standard error stream;

diff --git a/etc/NEWS b/etc/NEWS
index ec50877..7bf9a1c 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1240,8 +1240,9 @@ set of "wrapping" filters, similar to around advice.
 ** `server-eval-at' is provided to allow evaluating forms on different
 Emacs server instances.
 
-** `call-process' allows a `(:file "file")' spec to redirect STDOUT to
-a file.
++++
+** `call-process' and `call-process-region' allow a `(:file "file")' spec
+to redirect STDOUT to a file.
 
 ---
 ** Variable `stack-trace-on-error' removed.

diff --git a/src/ChangeLog b/src/ChangeLog
index 800409d..77c3bc4 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,5 +1,7 @@
 2012-02-02  Glenn Morris  <rgm@gnu.org>
 
+       * callproc.c (Fcall_process, Fcall_process_region): Doc fix.
+
        * nsterm.m (syms_of_nsterm) <x-toolkit-scroll-bars>:
        Unconditionally set to t.  (Bug#10673)
        * nsterm.m (syms_of_nsterm) <x-toolkit-scroll-bars>:

diff --git a/src/callproc.c b/src/callproc.c
index c5208fb..b5b8cad 100644 (file)
--- a/src/callproc.c
+++ b/src/callproc.c
@@ -164,7 +164,8 @@ The remaining arguments are optional.
 The program's input comes from file INFILE (nil means `/dev/null').
 Insert output in BUFFER before point; t means current buffer; nil for BUFFER
  means discard it; 0 means discard and don't wait; and `(:file FILE)', where
- FILE is a file name string, means that it should be written to that file.
+ FILE is a file name string, means that it should be written to that file
+ \(if the file already exists it is overwritten).
 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
 REAL-BUFFER says what to do with standard output, as above,
 while STDERR-FILE says what to do with standard error in the child.
@@ -940,7 +941,7 @@ Delete the text if fourth arg DELETE is non-nil.
 Insert output in BUFFER before point; t means current buffer; nil for
  BUFFER means discard it; 0 means discard and don't wait; and `(:file
  FILE)', where FILE is a file name string, means that it should be
- written to that file.
+ written to that file (if the file already exists it is overwritten).
 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
 REAL-BUFFER says what to do with standard output, as above,
 while STDERR-FILE says what to do with standard error in the child.