GNU bug report logs - #24693
Small doc improvement of start-process

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 24693 in the body.
You can then email your comments to 24693 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Hong Xu <hong <at> topbug.net>
To: bug-gnu-emacs <at> gnu.org
Subject: Small doc improvement of start-process
Date: Fri, 14 Oct 2016 11:15:40 -0700

[Message part 1 (text/plain, inline)]

PROGARM-ARGS are not mentioned in the docstring. The attached patch is a
draft of the small improvement. Thanks!

[doc-improvement.patch (text/x-patch, attachment)]

[signature.asc (application/pgp-signature, attachment)]

Message #8 received at 24693 <at> debbugs.gnu.org (full text, mbox):

From: Andreas Schwab <schwab <at> linux-m68k.org>
To: Hong Xu <hong <at> topbug.net>
Cc: 24693 <at> debbugs.gnu.org
Subject: Re: bug#24693: Small doc improvement of start-process
Date: Fri, 14 Oct 2016 20:25:04 +0200

On Okt 14 2016, Hong Xu <hong <at> topbug.net> wrote:

> PROGARM-ARGS are not mentioned in the docstring. The attached patch is a
> draft of the small improvement. Thanks!
>
> diff --git a/lisp/subr.el b/lisp/subr.el
> index 8a1792ad8b78..c3524ef1fccb 100644
> --- a/lisp/subr.el
> +++ b/lisp/subr.el
> @@ -2001,6 +2001,9 @@ PROGRAM is the program file name.  It is searched for in `exec-path'
>  \(which see).  If nil, just associate a pty with the buffer.  Remaining
>  arguments are strings to give program as arguments.
>  
> +PROGRAM-ARGS are strings that specify command line arguments for the
> +subprocess.
> +

That's what it says in the preceding sentence.

Andreas.

-- 
Andreas Schwab, schwab <at> linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

Message #11 received at 24693 <at> debbugs.gnu.org (full text, mbox):

From: Hong Xu <hong <at> topbug.net>
To: Andreas Schwab <schwab <at> linux-m68k.org>
Cc: 24693 <at> debbugs.gnu.org
Subject: Re: bug#24693: Small doc improvement of start-process
Date: Fri, 14 Oct 2016 11:39:19 -0700

[Message part 1 (text/plain, inline)]

On 10/14/2016 11:25 AM, Andreas Schwab wrote:
> On Okt 14 2016, Hong Xu <hong <at> topbug.net> wrote:
> 
>> PROGARM-ARGS are not mentioned in the docstring. The attached patch is a
>> draft of the small improvement. Thanks!
>>
>> diff --git a/lisp/subr.el b/lisp/subr.el
>> index 8a1792ad8b78..c3524ef1fccb 100644
>> --- a/lisp/subr.el
>> +++ b/lisp/subr.el
>> @@ -2001,6 +2001,9 @@ PROGRAM is the program file name.  It is searched for in `exec-path'
>>  \(which see).  If nil, just associate a pty with the buffer.  Remaining
>>  arguments are strings to give program as arguments.
>>  
>> +PROGRAM-ARGS are strings that specify command line arguments for the
>> +subprocess.
>> +
> 
> That's what it says in the preceding sentence.
> 

I see. Maybe mention PROGRAM-ARGS explicitly like: Remaining
arguments PROGRAM-ARGS are strings to give program as arguments.

[signature.asc (application/pgp-signature, attachment)]

Message #14 received at 24693 <at> debbugs.gnu.org (full text, mbox):

From: Hong Xu <hong <at> topbug.net>
To: 24693 <at> debbugs.gnu.org
Subject: Re: bug#24693: Small doc improvement of start-process
Date: Mon, 17 Oct 2016 17:06:01 -0700

[Message part 1 (text/plain, inline)]

On 10/14/2016 11:39 AM, Hong Xu wrote:
> 
> I see. Maybe mention PROGRAM-ARGS explicitly like: Remaining
> arguments PROGRAM-ARGS are strings to give program as arguments.
> 
> 

Can we push the small fix? This is a tiny fix but it certainly improves
the quality of the doc.

[signature.asc (application/pgp-signature, attachment)]

Message #19 received at 24693-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Hong Xu <hong <at> topbug.net>
Cc: 24693-done <at> debbugs.gnu.org
Subject: Re: bug#24693: Small doc improvement of start-process
Date: Tue, 18 Oct 2016 09:25:02 +0300

> From: Hong Xu <hong <at> topbug.net>
> Date: Mon, 17 Oct 2016 17:06:01 -0700
> 
> On 10/14/2016 11:39 AM, Hong Xu wrote:
> > 
> > I see. Maybe mention PROGRAM-ARGS explicitly like: Remaining
> > arguments PROGRAM-ARGS are strings to give program as arguments.
> > 
> 
> Can we push the small fix? This is a tiny fix but it certainly improves
> the quality of the doc.

Done.

Thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.