Commit f33095ed authored by Glenn Morris's avatar Glenn Morris
Browse files

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.
parent b7aa5ad6
...@@ -112,7 +112,7 @@ described below. ...@@ -112,7 +112,7 @@ described below.
argument that specifies where the standard output from the program will 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, 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 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}.) handles it. (@xref{Filter Functions}, and @ref{Read and Print}.)
Normally, you should avoid having multiple processes send output to the Normally, you should avoid having multiple processes send output to the
same buffer because their output would be intermixed randomly. same buffer because their output would be intermixed randomly.
...@@ -1189,7 +1189,7 @@ be sent to the process, but this is not built into Emacs Lisp. ...@@ -1189,7 +1189,7 @@ be sent to the process, but this is not built into Emacs Lisp.
By default, process output is inserted in the associated buffer. By default, process output is inserted in the associated buffer.
(You can change this by defining a custom filter function, (You can change this by defining a custom filter function,
@pxref{Filter Functions}). The position to insert the output is @pxref{Filter Functions}.) The position to insert the output is
determined by the @code{process-mark}, which is then updated to point 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 to the end of the text just inserted. Usually, but not always, the
@code{process-mark} is at the end of the buffer. @code{process-mark} is at the end of the buffer.
...@@ -1453,7 +1453,6 @@ code conversion and the end of line conversion---that is, one like ...@@ -1453,7 +1453,6 @@ code conversion and the end of line conversion---that is, one like
@c set-process-filter-multibyte and process-filter-multibyte-p, @c set-process-filter-multibyte and process-filter-multibyte-p,
@cindex filter multibyte flag, of process @cindex filter multibyte flag, of process
@cindex process filter multibyte flag @cindex process filter multibyte flag
@c FIXME there is always a filter function now
When Emacs calls a process filter function, it provides the process When Emacs calls a process filter function, it provides the process
output as a multibyte string or as a unibyte string according to the output as a multibyte string or as a unibyte string according to the
process's filter coding system. Emacs process's filter coding system. Emacs
......
...@@ -1093,6 +1093,7 @@ errors. You should either convert them to utf-8 or add an explicit ...@@ -1093,6 +1093,7 @@ errors. You should either convert them to utf-8 or add an explicit
It used to disable the minor mode, major mode, and text-property keymaps, It used to disable the minor mode, major mode, and text-property keymaps,
whereas now it simply has higher precedence. whereas now it simply has higher precedence.
+++
** Default process filters and sentinels are not nil any more. ** 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. Instead they default to a function that does what the nil value used to do.
......
2014-02-22 Glenn Morris <rgm@gnu.org>
* process.c (Finternal_default_process_filter)
(Finternal_default_process_sentinel): Doc tweaks.
2014-02-21 Glenn Morris <rgm@gnu.org> 2014-02-21 Glenn Morris <rgm@gnu.org>
* process.c (Fprocess_buffer, Faccept_process_output) * process.c (Fprocess_buffer, Faccept_process_output)
......
...@@ -5188,7 +5188,8 @@ read_and_dispose_of_process_output (struct Lisp_Process *p, char *chars, ...@@ -5188,7 +5188,8 @@ read_and_dispose_of_process_output (struct Lisp_Process *p, char *chars,
DEFUN ("internal-default-process-filter", Finternal_default_process_filter, DEFUN ("internal-default-process-filter", Finternal_default_process_filter,
Sinternal_default_process_filter, 2, 2, 0, Sinternal_default_process_filter, 2, 2, 0,
doc: /* Function used as default process filter. 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) (Lisp_Object proc, Lisp_Object text)
{ {
struct Lisp_Process *p; struct Lisp_Process *p;
...@@ -6413,7 +6414,7 @@ status_notify (struct Lisp_Process *deleting_process) ...@@ -6413,7 +6414,7 @@ status_notify (struct Lisp_Process *deleting_process)
DEFUN ("internal-default-process-sentinel", Finternal_default_process_sentinel, DEFUN ("internal-default-process-sentinel", Finternal_default_process_sentinel,
Sinternal_default_process_sentinel, 2, 2, 0, Sinternal_default_process_sentinel, 2, 2, 0,
doc: /* Function used as default sentinel for processes. 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 proc, Lisp_Object msg)
{ {
Lisp_Object buffer, symbol; Lisp_Object buffer, symbol;
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment