[Emacs-diffs] trunk r116527: Bit more doc for process filter and sentinel changes

[Glenn Morris]

------------------------------------------------------------
revno: 116527
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2014-02-22 13:08:22 -0800
message:
  Bit more doc for process filter and sentinel changes
  
  * src/process.c (Finternal_default_process_filter)
  (Finternal_default_process_sentinel): Doc tweaks.
  
  * doc/lispref/processes.texi: Typo fixes.
  
  * etc/NEWS: Related markup.
modified:
  doc/lispref/processes.texi     
processes.texi-20091113204419-o5vbwnq5f7feedwu-6207
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/process.c                  process.c-20091113204419-o5vbwnq5f7feedwu-462

=== modified file 'doc/lispref/processes.texi'
--- a/doc/lispref/processes.texi        2014-02-21 20:10:56 +0000
+++ b/doc/lispref/processes.texi        2014-02-22 21:08:22 +0000
@@ -112,7 +112,7 @@
 argument that specifies where the standard output from the program will
 go.  It should be a buffer or a buffer name; if it is a buffer name,
 that will create the buffer if it does not already exist.  It can also
-be @code{nil}, which says to discard the output unless a custom filter function
+be @code{nil}, which says to discard the output, unless a custom filter 
function
 handles it.  (@xref{Filter Functions}, and @ref{Read and Print}.)
 Normally, you should avoid having multiple processes send output to the
 same buffer because their output would be intermixed randomly.
@@ -1189,7 +1189,7 @@
 
   By default, process output is inserted in the associated buffer.
 (You can change this by defining a custom filter function,
address@hidden Functions}).  The position to insert the output is
address@hidden Functions}.)  The position to insert the output is
 determined by the @code{process-mark}, which is then updated to point
 to the end of the text just inserted.  Usually, but not always, the
 @code{process-mark} is at the end of the buffer.
@@ -1453,7 +1453,6 @@
 @c set-process-filter-multibyte and process-filter-multibyte-p,
 @cindex filter multibyte flag, of process
 @cindex process filter multibyte flag
address@hidden FIXME there is always a filter function now
   When Emacs calls a process filter function, it provides the process
 output as a multibyte string or as a unibyte string according to the
 process's filter coding system.  Emacs

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-02-22 17:57:57 +0000
+++ b/etc/NEWS  2014-02-22 21:08:22 +0000
@@ -1093,6 +1093,7 @@
 It used to disable the minor mode, major mode, and text-property keymaps,
 whereas now it simply has higher precedence.
 
++++
 ** Default process filters and sentinels are not nil any more.
 Instead they default to a function that does what the nil value used to do.
 

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2014-02-21 08:04:15 +0000
+++ b/src/ChangeLog     2014-02-22 21:08:22 +0000
@@ -1,3 +1,8 @@
+2014-02-22  Glenn Morris  <address@hidden>
+
+       * process.c (Finternal_default_process_filter)
+       (Finternal_default_process_sentinel): Doc tweaks.
+
 2014-02-21  Glenn Morris  <address@hidden>
 
        * process.c (Fprocess_buffer, Faccept_process_output)

=== modified file 'src/process.c'
--- a/src/process.c     2014-02-21 08:04:15 +0000
+++ b/src/process.c     2014-02-22 21:08:22 +0000
@@ -5188,7 +5188,8 @@
 DEFUN ("internal-default-process-filter", Finternal_default_process_filter,
        Sinternal_default_process_filter, 2, 2, 0,
        doc: /* Function used as default process filter.
-This inserts the process's output into its buffer.  */)
+This inserts the process's output into its buffer, if there is one.
+Otherwise it discards the output.  */)
   (Lisp_Object proc, Lisp_Object text)
 {
   struct Lisp_Process *p;
@@ -6413,7 +6414,7 @@
 DEFUN ("internal-default-process-sentinel", Finternal_default_process_sentinel,
        Sinternal_default_process_sentinel, 2, 2, 0,
        doc: /* Function used as default sentinel for processes.
-This inserts a status message into the process's buffer.  */)
+This inserts a status message into the process's buffer, if there is one.  */)
      (Lisp_Object proc, Lisp_Object msg)
 {
   Lisp_Object buffer, symbol;