From unknown Thu Aug 14 21:54:07 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#4542 <4542@debbugs.gnu.org> To: bug#4542 <4542@debbugs.gnu.org> Subject: Status: doc bug in lisp/comint.el Reply-To: bug#4542 <4542@debbugs.gnu.org> Date: Fri, 15 Aug 2025 04:54:07 +0000 retitle 4542 doc bug in lisp/comint.el reassign 4542 emacs submitter 4542 Devon Sean McCullough severity 4542 normal thanks From Devon@Jovi.Net Wed Sep 23 20:16:30 2009 Received: (at submit) by emacsbugs.donarmstrong.com; 24 Sep 2009 03:16:30 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.1 required=4.0 tests=AWL,FOURLA,MURPHY_DRUGS_REL8 autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8O3GSUb019687 for ; Wed, 23 Sep 2009 20:16:30 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mqeom-0002H5-Dw for bug-gnu-emacs@gnu.org; Wed, 23 Sep 2009 23:16:28 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mqeoi-0002GV-UL for bug-gnu-emacs@gnu.org; Wed, 23 Sep 2009 23:16:28 -0400 Received: from [199.232.76.173] (port=59367 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mqeoi-0002GS-Pn for bug-gnu-emacs@gnu.org; Wed, 23 Sep 2009 23:16:24 -0400 Received: from jovi.net ([66.161.136.54]:1290) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Mqeoh-0005CL-1o for bug-gnu-emacs@gnu.org; Wed, 23 Sep 2009 23:16:24 -0400 Received: from jovi.net (localhost [127.0.0.1]) by jovi.net (8.14.1/8.14.1) with ESMTP id n8O2loj5046527 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 23 Sep 2009 22:47:50 -0400 (EDT) (envelope-from Devon@Jovi.Net) Received: (from devon@localhost) by jovi.net (8.14.1/8.14.1/Submit) id n8O2lNGq046509; Wed, 23 Sep 2009 19:47:23 -0700 (PDT) (envelope-from Devon@Jovi.Net) Date: Wed, 23 Sep 2009 19:47:23 -0700 (PDT) Message-Id: <200909240247.n8O2lNGq046509@jovi.net> X-Authentication-Warning: jovi.net: devon set sender to Devon@Jovi.Net using -f From: Devon Sean McCullough To: bug-gnu-emacs@gnu.org Subject: doc bug in lisp/comint.el Received-SPF: Pass (client IP white listed); receiver=localhost; client-ip=127.0.0.1; envelope-from= Received-SPF: Pass (client IP white listed); receiver=localhost; client-ip=127.0.0.1; helo= X-DCC-dcc.uncw.edu-Metrics: grant.org 1201; Body=2 Fuz1=2 Fuz2=2 X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.6-4.9 Three lines in comint.el read like a hilarious game of "telephone" ... STARTFILE is the name of a file to send the contents of to the process. STARTFILE is the name of a file to send the contents of the process to. Runs the given COMMAND with SWITCHES with output to STARTFILE. ... going from confusing to incoherent to false. Patch follows. Peace --Devon /~\ \ / Health Care X not warfare / \ --- comint.el.~1.392.~ 2009-08-30 15:24:05.000000000 -0700 +++ comint.el 2009-09-23 18:01:50.000000000 -0700 @@ -686,7 +686,7 @@ via `start-file-process', or a cons pair of the form (HOST . SERVICE) denoting a TCP connection to be opened via `open-network-stream'. If there is already a running process in that buffer, it is not restarted. Optional fourth arg -STARTFILE is the name of a file to send the contents of to the process. +STARTFILE names a file of initial input to send to the process. If PROGRAM is a string, any more args are arguments to PROGRAM." (or (fboundp 'start-file-process) @@ -709,7 +709,7 @@ via `start-file-process', or a cons pair of the form (HOST . SERVICE) denoting a TCP connection to be opened via `open-network-stream'. If there is already a running process in that buffer, it is not restarted. Optional third arg -STARTFILE is the name of a file to send the contents of the process to. +STARTFILE names a file of initial input to send to the process. If PROGRAM is a string, any more args are arguments to PROGRAM." (apply #'make-comint-in-buffer name nil program startfile switches)) @@ -728,7 +728,7 @@ (defun comint-exec (buffer name command startfile switches) "Start up a process named NAME in buffer BUFFER for Comint modes. -Runs the given COMMAND with SWITCHES with output to STARTFILE. +Runs the given COMMAND with SWITCHES and initial input from STARTFILE. Blasts any old process running in the buffer. Doesn't set the buffer mode. You can use this to cheaply run a series of processes in the same Comint buffer. The hook `comint-exec-hook' is run after each exec." @@ -746,7 +746,7 @@ ;; Jump to the end, and set the process mark. (goto-char (point-max)) (set-marker (process-mark proc) (point)) - ;; Feed it the startfile. + ;; First feed it from startfile. (cond (startfile ;;This is guaranteed to wait long enough ;;but has bad results if the comint does not prompt at all From cyd@stupidchicken.com Thu Sep 24 20:43:32 2009 Received: (at 4542-done) by emacsbugs.donarmstrong.com; 25 Sep 2009 03:43:32 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-1.6 required=4.0 tests=AWL,MURPHY_DRUGS_REL8 autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8P3hUCt024452 for <4542-done@emacsbugs.donarmstrong.com>; Thu, 24 Sep 2009 20:43:31 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id 45B4757E266; Thu, 24 Sep 2009 23:45:08 -0400 (EDT) From: Chong Yidong To: Devon Sean McCullough Cc: 4542-done@debbugs.gnu.org Subject: Re: doc bug in lisp/comint.el Date: Thu, 24 Sep 2009 23:45:08 -0400 Message-ID: <87skebit6j.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > Three lines in comint.el read like a hilarious game of "telephone" ... > > STARTFILE is the name of a file to send the contents of to the process. > STARTFILE is the name of a file to send the contents of the process to. > Runs the given COMMAND with SWITCHES with output to STARTFILE. > > ... going from confusing to incoherent to false. Patch follows. Thanks. I've checked it in (with minor tweaks). From unknown Thu Aug 14 21:54:07 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 23 Oct 2009 14:24:13 +0000 User-Agent: Fakemail v42.6.9 # A New Hope # A long time ago, in a galaxy far, far away # something happened. # # Magically this resulted in the following # action being taken, but this fake control # message doesn't tell you why it happened # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator