unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#52337: 27.2; Doc string of `dired-check-process'
@ 2021-12-06 20:55 Drew Adams
  2021-12-07 17:48 ` Eli Zaretskii
  0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2021-12-06 20:55 UTC (permalink / raw)
  To: 52337



1. Please consider filling the third sentence ("On error,...").

2. The "Else returns nil for success." isn't too clear.  Please consider
making it more clear that the return value is nil for success and either
ARGUMENTS or PROGRAM for failure.

It's also not clear under what conditions, or when, ARGUMENTS is
returned or PROGRAM is returned.  "Offending" doesn't help in that
regard.  Is it possible for both ARGUMENTS and PROGRAM to "offend"?

In GNU Emacs 27.2 (build 1, x86_64-w64-mingw32)
 of 2021-03-26 built on CIRROCUMULUS
Repository revision: deef5efafb70f4b171265b896505b92b6eef24e6
Repository branch: HEAD
Windowing system distributor 'Microsoft Corp.', version 10.0.19042
System Description: Microsoft Windows 10 Pro (v10.0.2009.19042.1348)

Recent messages:
For information about GNU Emacs and the GNU system, type C-h C-a.
Type C-x 1 to delete the help window.

Configured using:
 'configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static''





^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#52337: 27.2; Doc string of `dired-check-process'
  2021-12-06 20:55 bug#52337: 27.2; Doc string of `dired-check-process' Drew Adams
@ 2021-12-07 17:48 ` Eli Zaretskii
  0 siblings, 0 replies; 2+ messages in thread
From: Eli Zaretskii @ 2021-12-07 17:48 UTC (permalink / raw)
  To: Drew Adams; +Cc: 52337-done

> From: Drew Adams <drew.adams@oracle.com>
> Date: Mon, 6 Dec 2021 20:55:57 +0000
> 
> 1. Please consider filling the third sentence ("On error,...").
> 
> 2. The "Else returns nil for success." isn't too clear.  Please consider
> making it more clear that the return value is nil for success and either
> ARGUMENTS or PROGRAM for failure.
> 
> It's also not clear under what conditions, or when, ARGUMENTS is
> returned or PROGRAM is returned.  "Offending" doesn't help in that
> regard.  Is it possible for both ARGUMENTS and PROGRAM to "offend"?

Thanks, I fixed this on the emacs-28 branch.





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2021-12-07 17:48 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-12-06 20:55 bug#52337: 27.2; Doc string of `dired-check-process' Drew Adams
2021-12-07 17:48 ` Eli Zaretskii

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).