all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#57278: 26.3; Doc of `delete-indentation'
@ 2022-08-18 14:29 Drew Adams
  2022-08-18 14:52 ` Robert Pluim
  0 siblings, 1 reply; 8+ messages in thread
From: Drew Adams @ 2022-08-18 14:29 UTC (permalink / raw)
  To: 57278

The doc string and the description in (elisp) `User-Level Deletion' are
insufficiently oriented to end usage.  They should say clearly that a
prefix argument joins this line to the next one.

The doc string talks about "argument".  It should say "a prefix
argument".  The manual says nothing about the prefix argument.  It talks
only about argument JOIN-FOLLOWING-P.

Please write the descriptions first of all with interactive use in mind,
speaking of the prefix arg.  Then say that when called from Lisp the
argument corresponds to the prefix argument when used interactively.

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.19044
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''






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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 14:29 bug#57278: 26.3; Doc of `delete-indentation' Drew Adams
@ 2022-08-18 14:52 ` Robert Pluim
  2022-08-18 15:17   ` Drew Adams
  0 siblings, 1 reply; 8+ messages in thread
From: Robert Pluim @ 2022-08-18 14:52 UTC (permalink / raw)
  To: Drew Adams; +Cc: 57278

>>>>> On Thu, 18 Aug 2022 14:29:08 +0000, Drew Adams <drew.adams@oracle.com> said:

    Drew> The doc string and the description in (elisp) `User-Level Deletion' are
    Drew> insufficiently oriented to end usage.  They should say clearly that a
    Drew> prefix argument joins this line to the next one.

    Drew> The doc string talks about "argument".  It should say "a prefix
    Drew> argument".  The manual says nothing about the prefix argument.  It talks
    Drew> only about argument JOIN-FOLLOWING-P.

    Drew> Please write the descriptions first of all with interactive use in mind,
    Drew> speaking of the prefix arg.  Then say that when called from Lisp the
    Drew> argument corresponds to the prefix argument when used interactively.

These kinds of bug reports from you would be much more useful if they
were based off the latest code in master

Robert
-- 





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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 14:52 ` Robert Pluim
@ 2022-08-18 15:17   ` Drew Adams
  2022-08-18 15:25     ` Robert Pluim
  2022-08-18 15:47     ` Stefan Kangas
  0 siblings, 2 replies; 8+ messages in thread
From: Drew Adams @ 2022-08-18 15:17 UTC (permalink / raw)
  To: Robert Pluim; +Cc: 57278@debbugs.gnu.org

> These kinds of bug reports from you would be much more useful if they
> were based off the latest code in master

Please feel free to do that.  Or to close the bug if
you feel it no longer exists.





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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 15:17   ` Drew Adams
@ 2022-08-18 15:25     ` Robert Pluim
  2022-08-18 15:48       ` Drew Adams
  2022-08-18 15:47     ` Stefan Kangas
  1 sibling, 1 reply; 8+ messages in thread
From: Robert Pluim @ 2022-08-18 15:25 UTC (permalink / raw)
  To: Drew Adams; +Cc: 57278@debbugs.gnu.org

>>>>> On Thu, 18 Aug 2022 15:17:37 +0000, Drew Adams <drew.adams@oracle.com> said:

    >> These kinds of bug reports from you would be much more useful if they
    >> were based off the latest code in master

    Drew> Please feel free to do that.  Or to close the bug if
    Drew> you feel it no longer exists.

Iʼm not about to do that. This is your bug report, itʼs on you to
ensure itʼs relevant and appropriate.

Robert
-- 





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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 15:17   ` Drew Adams
  2022-08-18 15:25     ` Robert Pluim
@ 2022-08-18 15:47     ` Stefan Kangas
  2022-08-18 15:48       ` Drew Adams
  1 sibling, 1 reply; 8+ messages in thread
From: Stefan Kangas @ 2022-08-18 15:47 UTC (permalink / raw)
  To: Drew Adams, Robert Pluim; +Cc: 57278-done

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

>> These kinds of bug reports from you would be much more useful if they
>> were based off the latest code in master
>
> Please feel free to do that.  Or to close the bug if
> you feel it no longer exists.

I looked at it, and I think it's been fixed already.  Closing, thanks.





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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 15:25     ` Robert Pluim
@ 2022-08-18 15:48       ` Drew Adams
  2022-08-18 16:41         ` Stefan Kangas
  0 siblings, 1 reply; 8+ messages in thread
From: Drew Adams @ 2022-08-18 15:48 UTC (permalink / raw)
  To: Robert Pluim; +Cc: 57278@debbugs.gnu.org

>>> These kinds of bug reports from you would be much
>>> more useful if they were based off the latest code
>>> in master
>>
>> Please feel free to do that.  Or to close the bug
>> if you feel it no longer exists.
> 
> Iʼm not about to do that. This is your bug report,
> it's on you to ensure itʼs relevant and appropriate.

I do believe it's relevant and appropriate for the
release I reported it in.

If you use a later release, and you want to investigate
whether it's relevant and appropriate for that release,
feel free to do so.  If you don't want to do that, don't.

And no, it's not "on" a user to investigate that.  It's
not on anyone.  If you want to do that, do it.

And no, it's not "my" bug report.  It's a bug that I
reported.  You're welcome.

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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 15:47     ` Stefan Kangas
@ 2022-08-18 15:48       ` Drew Adams
  0 siblings, 0 replies; 8+ messages in thread
From: Drew Adams @ 2022-08-18 15:48 UTC (permalink / raw)
  To: Stefan Kangas, Robert Pluim; +Cc: 57278-done@debbugs.gnu.org

> >> These kinds of bug reports from you would be much more useful if they
> >> were based off the latest code in master
> >
> > Please feel free to do that.  Or to close the bug if
> > you feel it no longer exists.
> 
> I looked at it, and I think it's been fixed already.  Closing, thanks.

Thanks.  You're welcome.

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

* bug#57278: 26.3; Doc of `delete-indentation'
  2022-08-18 15:48       ` Drew Adams
@ 2022-08-18 16:41         ` Stefan Kangas
  0 siblings, 0 replies; 8+ messages in thread
From: Stefan Kangas @ 2022-08-18 16:41 UTC (permalink / raw)
  To: Drew Adams, Robert Pluim; +Cc: 57278@debbugs.gnu.org

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

>> Iʼm not about to do that. This is your bug report,
>> it's on you to ensure itʼs relevant and appropriate.
[...]
> And no, it's not "on" a user to investigate that.  It's
> not on anyone.  If you want to do that, do it.

We generally close bug reports rather unceremoniously if they are not up
to scratch.  It's not like you are some rando either, so expectations
are if anything even higher.

When documentation bugs are not double-checked against "master", that
creates extra work (in this case for me and Robert), even if only just
to close the bug report.  Please consider trying to be as collaborative
as possible.

> And no, it's not "my" bug report.  It's a bug that I reported.  You're
> welcome.

Thanks again.





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

end of thread, other threads:[~2022-08-18 16:41 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-08-18 14:29 bug#57278: 26.3; Doc of `delete-indentation' Drew Adams
2022-08-18 14:52 ` Robert Pluim
2022-08-18 15:17   ` Drew Adams
2022-08-18 15:25     ` Robert Pluim
2022-08-18 15:48       ` Drew Adams
2022-08-18 16:41         ` Stefan Kangas
2022-08-18 15:47     ` Stefan Kangas
2022-08-18 15:48       ` Drew Adams

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.