From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Francesco Potorti` <pot@gnu.org>
Newsgroups: gmane.emacs.bugs
Subject: inconsistent doc for call-process-regione
Date: Sun, 18 May 2003 01:51:56 +0200
Sender: bug-gnu-emacs-bounces+gnu-bug-gnu-emacs=m.gmane.org@gnu.org
Message-ID: <E19HBT2-0003d2-00@pot.cnuce.cnr.it>
NNTP-Posting-Host: main.gmane.org
X-Trace: main.gmane.org 1053215561 31977 80.91.224.249 (17 May 2003 23:52:41 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Sat, 17 May 2003 23:52:41 +0000 (UTC)
Original-X-From: bug-gnu-emacs-bounces+gnu-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 18 01:52:39 2003
Return-path: <bug-gnu-emacs-bounces+gnu-bug-gnu-emacs=m.gmane.org@gnu.org>
Original-Received: from monty-python.gnu.org ([199.232.76.173])
	by main.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 19HBTj-0008Jd-00
	for <gnu-bug-gnu-emacs@m.gmane.org>; Sun, 18 May 2003 01:52:39 +0200
Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.10.13)
	id 19HBUU-0004gj-03
	for gnu-bug-gnu-emacs@m.gmane.org; Sat, 17 May 2003 19:53:26 -0400
Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13)
	id 19HBTU-0003ne-00
	for bug-gnu-emacs@gnu.org; Sat, 17 May 2003 19:52:24 -0400
Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13)
	id 19HBTG-0003aU-00
	for bug-gnu-emacs@gnu.org; Sat, 17 May 2003 19:52:11 -0400
Original-Received: from pot.cnuce.cnr.it ([146.48.83.182])
	by monty-python.gnu.org with esmtp (Exim 4.10.13)
	id 19HBT4-0003Gx-00
	for bug-gnu-emacs@gnu.org; Sat, 17 May 2003 19:51:58 -0400
Original-Received: from pot by pot.cnuce.cnr.it with local (Exim 3.36 #1 (Debian))
	id 19HBT2-0003d2-00
	for <bug-gnu-emacs@gnu.org>; Sun, 18 May 2003 01:51:56 +0200
Original-To: bug-gnu-emacs@gnu.org
X-fingerprint: 4B2 6187 5C3 D6B1 2E31  7666 9DF 2DC9 BE21 6115
X-BeenThere: bug-gnu-emacs@gnu.org
X-Mailman-Version: 2.1b5
Precedence: list
List-Id: Bug reports for GNU Emacs, the Swiss army knife of text editors
 <bug-gnu-emacs.gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
List-Archive: <http://mail.gnu.org/pipermail/bug-gnu-emacs>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
Errors-To: bug-gnu-emacs-bounces+gnu-bug-gnu-emacs=m.gmane.org@gnu.org
Xref: main.gmane.org gmane.emacs.bugs:5101
X-Report-Spam: http://spam.gmane.org/gmane.emacs.bugs:5101

In GNU Emacs 21.3.1 (i686-pc-linux-gnu, X toolkit, Xaw3d scroll bars)

The doc string for call-process says:

|Insert output in BUFFER before point; t means current buffer;
| nil for BUFFER means discard it; 0 means discard and don't wait.

But later it says:

|If BUFFER is nil, `call-process-region' returns immediately with value nil.
|Otherwise it waits for PROGRAM to terminate
|and returns a numeric exit status or a signal description string.

If I am not wrong, these are contradictory.  If they are not, then I do
not understand, and probably they should be cleared.