X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/545c2782247d305aa2fc0e53c3ff1f086a839093..4b0f717890dd0951bf68ebccada20f90580cdc30:/doc/lispref/processes.texi diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index c0beb7a67d..7795ddfc3a 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001, -@c 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../../info/processes @node Processes, Display, Abbrevs, Top @@ -206,9 +206,9 @@ regular expression @var{separators}, like @code{split-string} does the substrings. It then makes a list of the substrings and returns it. -If @var{separators} is omitted or nil, it defaults to @code{"\\s-+"}, -which is a regular expression that matches one or more characters with -whitespace syntax (@pxref{Syntax Class Table}). +If @var{separators} is omitted or @code{nil}, it defaults to +@code{"\\s-+"}, which is a regular expression that matches one or more +characters with whitespace syntax (@pxref{Syntax Class Table}). The quoting this function supports is of 2 styles: by enclosing a whole string in double quotes @code{"@dots{}"}, or by quoting @@ -791,8 +791,8 @@ This function returns the name of @var{process}. @defun process-status process-name This function returns the status of @var{process-name} as a symbol. -The argument @var{process-name} must be a process, a buffer, a -process name (string) or a buffer name (string). +The argument @var{process-name} must be a process, a buffer, or a +process name (a string). The possible values for an actual subprocess are: @@ -823,10 +823,6 @@ if @var{process-name} is not the name of an existing process. @smallexample @group -(process-status "shell") - @result{} run -@end group -@group (process-status (get-buffer "*shell*")) @result{} run @end group @@ -1392,7 +1388,10 @@ converts the unibyte output to multibyte using system to use (@pxref{Process Information}). Otherwise, the coding system comes from @code{coding-system-for-read}, if that is non-@code{nil}; or else from the defaulting mechanism (@pxref{Default -Coding Systems}). +Coding Systems}). If the text output by a process contains null +bytes, Emacs by default uses @code{no-conversion} for it; see +@ref{Lisp and Coding Systems, inhibit-null-byte-detection}, for how to +control this behavior. @strong{Warning:} Coding systems such as @code{undecided} which determine the coding system from the data do not work entirely @@ -1645,7 +1644,7 @@ from all the other processes running on the same machine at the same time. @end defun -@defun system-process-attributes pid +@defun process-attributes pid This function returns an alist of attributes for the process specified by its process ID @var{pid}. Each association in the alist is of the form @code{(@var{key} . @var{value})}, where @var{key} designates the @@ -1748,10 +1747,15 @@ Time spent by the process in the system (kernel) context, for processing system calls. The corresponding @var{value} is in the same format as for @code{utime}. +@item time +The sum of @code{utime} and @code{stime}. The corresponding +@var{value} is in the same format as for @code{utime}. + @item cutime @itemx cstime -Like @code{utime} and @code{stime}, but includes the times of all the -child processes of the given process. +@itemx ctime +Like @code{utime}, @code{stime}, and @code{time}, but include the +times of all the child processes of the given process. @item pri The numerical priority of the process. @@ -1832,8 +1836,8 @@ The argument @var{regexp} is a regular expression that should match text at the end of the entire answer, but nothing before; that's how @code{tq-enqueue} determines where the answer ends. -If the argument @var{delay-question} is non-nil, delay sending this -question until the process has finished replying to any previous +If the argument @var{delay-question} is non-@code{nil}, delay sending +this question until the process has finished replying to any previous questions. This produces more reliable results with some processes. The return value of @code{tq-enqueue} itself is not meaningful. @@ -2505,8 +2509,8 @@ most common value. If @var{speed} is @code{nil}, the function ignores all other arguments and does not configure the port. This may be useful for special serial ports such as Bluetooth-to-serial converters which can only be configured through AT commands sent through the -connection. You can use the value of @code{nil} for @var{speed} only -for connections that are already open by a previous call to +connection. The value of @code{nil} for @var{speed} is valid only for +connections that were already opened by a previous call to @code{make-serial-process} or @code{serial-term}. @item :bytesize @var{bytesize}