unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#28957: 26.0; doc string of `dired-move-to-filename'
@ 2017-10-23 18:44 Drew Adams
  2018-04-15 19:10 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2017-10-23 18:44 UTC (permalink / raw)
  To: 28957

Please describe the parameters, RAISE-ERROR and EOL, in the doc string.

In GNU Emacs 26.0.90 (build 3, x86_64-w64-mingw32)
 of 2017-10-13
Repository revision: 906224eba147bdfc0514090064e8e8f53160f1d4
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''





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

* bug#28957: 26.0; doc string of `dired-move-to-filename'
  2017-10-23 18:44 bug#28957: 26.0; doc string of `dired-move-to-filename' Drew Adams
@ 2018-04-15 19:10 ` Lars Ingebrigtsen
  2018-04-15 22:39   ` Drew Adams
  0 siblings, 1 reply; 3+ messages in thread
From: Lars Ingebrigtsen @ 2018-04-15 19:10 UTC (permalink / raw)
  To: Drew Adams; +Cc: 28957

Drew Adams <drew.adams@oracle.com> writes:

> Please describe the parameters, RAISE-ERROR and EOL, in the doc string.

Nah.  Those parameters are so obscure that you'd have to put the entire
function in the doc string to explain them.  Especially RAISE-ERROR.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





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

* bug#28957: 26.0; doc string of `dired-move-to-filename'
  2018-04-15 19:10 ` Lars Ingebrigtsen
@ 2018-04-15 22:39   ` Drew Adams
  0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2018-04-15 22:39 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 28957

> > Please describe the parameters, RAISE-ERROR and EOL, in the doc string.
> 
> Nah.  Those parameters are so obscure that you'd have to put the entire
> function in the doc string to explain them.  Especially RAISE-ERROR.

That's a cop-out, and it flouts Emacs convention.  Users
deserve better.

Your comment is of course welcome.  But closing the bug
is inappropriate - c'est un bug.

If you don't want to fix it, or you don't know how, why
not at least leave it open for someone else to fix who
might want to and knows how?

Are you not finding enough Gnus bugs to close? ;-)





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

end of thread, other threads:[~2018-04-15 22:39 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-10-23 18:44 bug#28957: 26.0; doc string of `dired-move-to-filename' Drew Adams
2018-04-15 19:10 ` Lars Ingebrigtsen
2018-04-15 22:39   ` Drew Adams

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