From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#20737: 25.0.50; doc of `process-file' Date: Thu, 4 Jun 2015 22:25:47 -0700 (PDT) Message-ID: <0363f153-da92-4838-b581-9896fb99290b@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1433482047 13317 80.91.229.3 (5 Jun 2015 05:27:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 5 Jun 2015 05:27:27 +0000 (UTC) To: 20737@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jun 05 07:27:12 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Z0k9v-0006Ga-95 for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Jun 2015 07:27:11 +0200 Original-Received: from localhost ([::1]:45315 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0k9u-0000Hn-CB for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Jun 2015 01:27:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50423) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0k9q-0000Hi-WD for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:27:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z0k9n-0006wK-Gm for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:27:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:59221) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0k9n-0006wC-E4 for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:27:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Z0k9m-00077W-QE for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:27:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Jun 2015 05:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20737 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.143348196627296 (code B ref -1); Fri, 05 Jun 2015 05:27:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Jun 2015 05:26:06 +0000 Original-Received: from localhost ([127.0.0.1]:40963 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z0k8r-00076B-EZ for submit@debbugs.gnu.org; Fri, 05 Jun 2015 01:26:06 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:36784) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z0k8o-00075f-0g for submit@debbugs.gnu.org; Fri, 05 Jun 2015 01:26:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z0k8h-0006IJ-O4 for submit@debbugs.gnu.org; Fri, 05 Jun 2015 01:25:56 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:34801) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0k8h-0006IF-LI for submit@debbugs.gnu.org; Fri, 05 Jun 2015 01:25:55 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50287) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0k8g-0000FT-Je for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:25:55 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z0k8d-0006HX-DW for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:25:54 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:19146) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0k8d-0006HO-6S for bug-gnu-emacs@gnu.org; Fri, 05 Jun 2015 01:25:51 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t555Pmte014937 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 5 Jun 2015 05:25:49 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t555PmfV032371 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 5 Jun 2015 05:25:48 GMT Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t555Pl0x018160 for ; Fri, 5 Jun 2015 05:25:47 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:103585 Archived-At: The parameters are not described correctly. This is the complete description/explanation of INFILE and BUFFER: File names in INFILE and BUFFER are handled normally, but file names in ARGS should be relative to `default-directory', as they are passed to the process verbatim. (This is a difference to `call-process' which does not support file handlers for INFILE and BUFFER.) What does that even mean? One might deduce that INFILE, BUFFER, and ARGS are lists that can contain file names (and perhaps other stuff), but that's about all. What their structure is or what they are for are completely unknown. And this is all that is said about parameter DISPLAY: Some file handlers might not support all variants, for example they might behave as if DISPLAY was nil, regardless of the actual value passed. That tells you less than nothing. This is really useless doc. Please do something to document `process-file' properly. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'