unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Devon Sean McCullough <emacs-hacker@Jovi.Net>
To: bug-gnu-emacs@gnu.org
Subject: bug#4542: doc bug in lisp/comint.el
Date: Wed, 23 Sep 2009 19:47:23 -0700 (PDT)	[thread overview]
Message-ID: <200909240247.n8O2lNGq046509@jovi.net> (raw)

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






             reply	other threads:[~2009-09-24  2:47 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <87skebit6j.fsf@cyd.mit.edu>
2009-09-24  2:47 ` Devon Sean McCullough [this message]
2009-09-25  3:50   ` bug#4542: marked as done (doc bug in lisp/comint.el) Emacs bug Tracking System

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=200909240247.n8O2lNGq046509@jovi.net \
    --to=emacs-hacker@jovi.net \
    --cc=4542@emacsbugs.donarmstrong.com \
    --cc=bug-gnu-emacs@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).