From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] Generalize start-process with keyword args Date: Tue, 17 Mar 2015 09:50:09 +0200 Message-ID: <837fugysem.fsf@gnu.org> References: <87d24d3uwz.fsf-ueno@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1426578777 17236 80.91.229.3 (17 Mar 2015 07:52:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 17 Mar 2015 07:52:57 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Daiki Ueno Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Mar 17 08:52:43 2015 Return-path: Envelope-to: ged-emacs-devel@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 1YXmIt-0002W0-7A for ged-emacs-devel@m.gmane.org; Tue, 17 Mar 2015 08:52:43 +0100 Original-Received: from localhost ([::1]:53205 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXmIs-0002nn-KY for ged-emacs-devel@m.gmane.org; Tue, 17 Mar 2015 03:52:42 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47686) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXmIG-0001f3-SN for emacs-devel@gnu.org; Tue, 17 Mar 2015 03:52:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YXmID-0005bZ-BL for emacs-devel@gnu.org; Tue, 17 Mar 2015 03:52:04 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:64234) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXmGc-0005BX-9O; Tue, 17 Mar 2015 03:50:22 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0NLC00000IUUV500@a-mtaout22.012.net.il>; Tue, 17 Mar 2015 09:50:20 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NLC000NIJ3WTE40@a-mtaout22.012.net.il>; Tue, 17 Mar 2015 09:50:20 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.172 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:183944 Archived-At: > From: Daiki Ueno > Date: Tue, 17 Mar 2015 11:16:49 +0900 > Cc: emacs-devel@gnu.org > > +@item :command @var{command} > +Use @var{command} as the command line of the process. @var{command} > +is a list starting with the program name, followed by strings to give > +to program as arguments. I think it'd be good to clearly state here that "the program name" is actually the name of the program's executable file. > +@item :coding @var{coding} > +Use @var{coding} as the coding system for this process. To specify > +different coding systems for decoding data from the connection and for > +encoding data sent to it, specify @code{(@var{decoding} . > +@var{encoding})} for @var{coding}. FWIW, I like the doc string's wording better: If @var{coding} is a symbol, it specifies the coding system to be used for both reading and writing of data from and to the connection. If @var{coding} is a cons cell @w{@code{(@var{decoding} . @var{encoding})}}, then @var{decoding} will be used for reading and @var{encoding} for writing. > +If you don't specify this keyword at all, the default > +is to determine the coding systems from the data. Please mention 'undecided' explicitly here, since that is more specific than the more vague "determine from the data". Thanks.