bug#40697: 25.3; sort-lines not accepting reverse parameter

[Štěpán Němec]

On Sat, 18 Apr 2020 06:34:58 -0500
Roland Hughes wrote:

> --text follows this line--
>
> I created a named buffer and pasted a few hundred lines of numbers in
> it. When I
> tried to enter the command "sort-lines reverse" as soon as I hit the
> spacebar I
> was greeted with [SoleCompletion] and could not enter the parameter.

The documentation string of `sort-line' reads:

---8<---
Sort lines in region alphabetically; argument means descending order.
Called from a program, there are three arguments:
REVERSE (non-nil means reverse order), BEG and END (region to sort).
The variable ‘sort-fold-case’ determines whether alphabetic case affects
the sort order.
--->8---

Note the "called from a program" before description of the arguments.

"argument" in the first sentence means the prefix argument during
interactive calls, as described in (info "(emacs) Arguments")

Maybe we should improve the wording? Would just saying "When called
interactively, prefix argument means sort in descending order" be
enough?

-- 
Štěpán