bug#57278: 26.3; Doc of `delete-indentation'

bug#57278: 26.3; Doc of `delete-indentation'

[Drew Adams]

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''

bug#57278: 26.3; Doc of `delete-indentation'

[Robert Pluim]

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

bug#57278: 26.3; Doc of `delete-indentation'

[Drew Adams]

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

bug#57278: 26.3; Doc of `delete-indentation'

[Robert Pluim]

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

bug#57278: 26.3; Doc of `delete-indentation'

[Drew Adams]

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

bug#57278: 26.3; Doc of `delete-indentation'

[Stefan Kangas]

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.

bug#57278: 26.3; Doc of `delete-indentation'

[Stefan Kangas]

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.

bug#57278: 26.3; Doc of `delete-indentation'

[Drew Adams]

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