From unknown Wed Jun 18 00:26:28 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#20737 <20737@debbugs.gnu.org> To: bug#20737 <20737@debbugs.gnu.org> Subject: Status: 25.0.50; doc of `process-file' Reply-To: bug#20737 <20737@debbugs.gnu.org> Date: Wed, 18 Jun 2025 07:26:28 +0000 retitle 20737 25.0.50; doc of `process-file' reassign 20737 emacs submitter 20737 Drew Adams severity 20737 minor tag 20737 fixed thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 05 01:26:06 2015 Received: (at submit) by debbugs.gnu.org; 5 Jun 2015 05:26:06 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_40 autolearn=disabled version=3.3.2 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 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 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 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 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 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 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 MIME-Version: 1.0 Message-ID: <0363f153-da92-4838-b581-9896fb99290b@default> Date: Thu, 4 Jun 2015 22:25:47 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.0.50; doc of `process-file' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) 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' From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 30 15:53:00 2016 Received: (at 20737) by debbugs.gnu.org; 30 Apr 2016 19:53:00 +0000 Received: from localhost ([127.0.0.1]:58494 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awawm-0001iJ-8x for submit@debbugs.gnu.org; Sat, 30 Apr 2016 15:53:00 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:60079) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awawl-0001iB-Aa for 20737@debbugs.gnu.org; Sat, 30 Apr 2016 15:52:59 -0400 Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1awawi-0006A5-2z; Sat, 30 Apr 2016 21:52:58 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#20737: 25.0.50; doc of `process-file' References: <0363f153-da92-4838-b581-9896fb99290b@default> Date: Sat, 30 Apr 2016 21:52:55 +0200 In-Reply-To: <0363f153-da92-4838-b581-9896fb99290b@default> (Drew Adams's message of "Thu, 4 Jun 2015 22:25:47 -0700 (PDT)") Message-ID: <87oa8qc1rc.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 20737 Cc: 20737@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) Drew Adams writes: > 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. `process-file' seems to be a shim over `call-process', but: ---- Similar to `call-process', but may invoke a file handler based on `default-directory'. The current working directory of the subprocess is `default-directory'. ---- I think the rest of the doc string tries to say what's different in the arguments between `process-file' and `call-process', but it kinda fails at doing that. Especially since ARGS and DISPLAY are just passed on to `call-process' verbatim in the default case. So somebody who knows what this function is meant to be doing (I've never heard of it before now) should take another crack at writing a new doc string. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed May 26 19:41:04 2021 Received: (at 20737) by debbugs.gnu.org; 26 May 2021 23:41:04 +0000 Received: from localhost ([127.0.0.1]:50331 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lm396-0003tl-FO for submit@debbugs.gnu.org; Wed, 26 May 2021 19:41:04 -0400 Received: from quimby.gnus.org ([95.216.78.240]:35836) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lm394-0003t9-Sn for 20737@debbugs.gnu.org; Wed, 26 May 2021 19:41:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=fieoKOb2MIZrOzIrhD/tpr9NVIBnoGHmHtFCuhL1XN4=; b=aP1YC03kRi63lcGL5NfGXJ+ZIM MiaCUqMuKxvaGYa9KxFviM1ElCm8VPho7SAQrJ0J+ulVUo9k+l6VW/qPs1IkFldPgXI8FqHCtB8BX 0JoL7sVusg3j80Gtt7h3+VYjYYV5DApuob+aYnmTIvctLyj/bKlSaTtCiqEd0pWynbxY=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lm38w-0004nY-Fk; Thu, 27 May 2021 01:40:56 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#20737: 25.0.50; doc of `process-file' References: <0363f153-da92-4838-b581-9896fb99290b@default> <87oa8qc1rc.fsf@gnus.org> X-Now-Playing: Radio Slave's _Fabriclive 96 Mixed by Skream_: "Screaming Hands (Tuff City Kids 'Krautdrums' Mix)" Date: Thu, 27 May 2021 01:40:54 +0200 In-Reply-To: <87oa8qc1rc.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sat, 30 Apr 2016 21:52:55 +0200") Message-ID: <87sg295aih.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Lars Ingebrigtsen writes: > So somebody who knows what this function is meant to be doing (I've > never heard of it before now) should take another crack at writing a new > doc string. Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 20737 Cc: 20737@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Lars Ingebrigtsen writes: > So somebody who knows what this function is meant to be doing (I've > never heard of it before now) should take another crack at writing a new > doc string. This was fixed in commit 2e8825d6c55409c15749b12dacc1f49f9c8783c7 Author: Eli Zaretskii AuthorDate: Sat Dec 29 17:34:57 2018 +0200 and commit 0b47d731c08d0d5d4ba4a0c31f9be1152fd8c2c8 Author: Paul Eggert AuthorDate: Sun Nov 17 15:26:55 2019 -0800 and the doc string seems pretty clear to me now. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed May 26 19:41:11 2021 Received: (at control) by debbugs.gnu.org; 26 May 2021 23:41:12 +0000 Received: from localhost ([127.0.0.1]:50334 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lm39D-0003u6-NI for submit@debbugs.gnu.org; Wed, 26 May 2021 19:41:11 -0400 Received: from quimby.gnus.org ([95.216.78.240]:35852) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lm39B-0003tm-NZ for control@debbugs.gnu.org; Wed, 26 May 2021 19:41:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=S6XVAw3TRpvUTz6ReHZ3xWMBWRK2/sbQYmHounJHpM8=; b=iVIU2q3c/rIBNyqc87PAkeU6Mn jEHur1y2XNotEDXdFWoAnHb8KNHnnaqwxqP0ca2EqgdYlmvk+Zjmst0buyPLDVbmt9gn9dEKSZLfP /am5syUnic9GcCxif8NapclHjTuQ2G5GaYY90mL1HQNkjkigUTPGfTD08IZJO8Fftzew=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lm394-0004nk-9D for control@debbugs.gnu.org; Thu, 27 May 2021 01:41:04 +0200 Date: Thu, 27 May 2021 01:41:01 +0200 Message-Id: <87r1ht5aia.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #20737 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 20737 fixed close 20737 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 20737 fixed close 20737 28.1 quit From unknown Wed Jun 18 00:26:28 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 24 Jun 2021 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator