[Emacs-diffs] /srv/bzr/emacs/trunk r107059: Tiny doc tweaks for call-process's :file spec.

[Glenn Morris]

------------------------------------------------------------
revno: 107059
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2012-02-01 23:21:20 -0800
message:
  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.
modified:
  doc/lispref/ChangeLog
  doc/lispref/processes.texi
  etc/NEWS
  src/ChangeLog
  src/callproc.c

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-02 07:06:37 +0000
+++ b/doc/lispref/ChangeLog     2012-02-02 07:21:20 +0000
@@ -1,5 +1,8 @@
 2012-02-02  Glenn Morris  <address@hidden>
 
+       * processes.texi (Synchronous Processes):
+       Mention call-process's :file gets overwritten.
+
        * commands.texi (Reading One Event):
        * help.texi (Help Functions): Document read-char-choice.
 

=== modified file 'doc/lispref/processes.texi'
--- a/doc/lispref/processes.texi        2012-01-19 07:21:25 +0000
+++ b/doc/lispref/processes.texi        2012-02-02 07:21:20 +0000
@@ -300,7 +300,8 @@
 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;

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-02 07:06:37 +0000
+++ b/etc/NEWS  2012-02-02 07:21:20 +0000
@@ -1240,8 +1240,9 @@
 ** `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.

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2012-02-02 02:12:57 +0000
+++ b/src/ChangeLog     2012-02-02 07:21:20 +0000
@@ -1,5 +1,7 @@
 2012-02-02  Glenn Morris  <address@hidden>
 
+       * 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>:

=== modified file 'src/callproc.c'
--- a/src/callproc.c    2012-01-19 07:21:25 +0000
+++ b/src/callproc.c    2012-02-02 07:21:20 +0000
@@ -164,7 +164,8 @@
 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 @@
 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.