From: Glenn Morris <rgm@gnu.org>
Date: Thu, 2 Feb 2012 07:21:20 +0000 (-0800)
Subject: Tiny doc tweaks for call-process's :file spec.
X-Git-Tag: emacs-pretest-24.0.94~360^2~1
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1b9f60cc53ca3918bbf807920cbaa43cf298a4cb;p=emacs.git

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 f95b53bc45f..b441248858e 100644
--- 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 38eb5a86471..4cfc954cd1f 100644
--- 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 ec508771abc..7bf9a1c36c4 100644
--- 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 800409d2377..77c3bc4f5dd 100644
--- 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 c5208fb93d9..b5b8cadeb68 100644
--- 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.