unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#40697: 25.3; sort-lines not accepting reverse parameter
@ 2020-04-18 11:34 Roland Hughes
  2020-04-18 16:13 ` Eli Zaretskii
  2020-04-18 16:15 ` Štěpán Němec
  0 siblings, 2 replies; 17+ messages in thread
From: Roland Hughes @ 2020-04-18 11:34 UTC (permalink / raw)
  To: 40697

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



In GNU Emacs 25.3.1 (x86_64-w64-mingw32)
  of 2017-09-12 built on KAEL
Windowing system distributor 'Microsoft Corp.', version 10.0.18363
Configured using:
  'configure --prefix=/tmp/emacs --without-imagemagick --without-dbus
  --with-modules 'CFLAGS=-O2 -g0''

Configured features:
XPM JPEG TIFF GIF PNG RSVG SOUND NOTIFY ACL GNUTLS LIBXML2 ZLIB
TOOLKIT_SCROLL_BARS MODULES

Important settings:
   value of $LANG: ENU
   locale-coding-system: cp1252

Major mode: Fundamental

Minor modes in effect:
   desktop-save-mode: t
   recentf-mode: t
   delete-selection-mode: t
   show-paren-mode: t
   cua-mode: t
   override-global-mode: t
   tooltip-mode: t
   global-eldoc-mode: t
   electric-indent-mode: t
   mouse-wheel-mode: t
   tool-bar-mode: t
   menu-bar-mode: t
   file-name-shadow-mode: t
   global-font-lock-mode: t
   blink-cursor-mode: t
   auto-composition-mode: t
   auto-encryption-mode: t
   auto-compression-mode: t
   column-number-mode: t
   line-number-mode: t
   transient-mark-mode: t

Recent messages:
book-link.txt has auto save data; consider M-x recover-this-file
Wrote c:/Users/rolan/AppData/Roaming/.emacs.d/.emacs.desktop.lock
Desktop: 1 frame, 6 buffers restored.
For information about GNU Emacs and the GNU system, type C-h C-a.
Loading c:/Users/rolan/AppData/Roaming/.edt-gnu-W32-keys...done
Default EDT keymap active
Mark set [2 times]
Making completion list...
mwheel-scroll: Beginning of buffer [2 times]
Making completion list...

Load-path shadows:
None found.

Features:
(shadow mail-extr emacsbug message dired format-spec rfc822 mml mml-sec
password-cache epg gnus-util mm-decode mm-bodies mm-encode mail-parse 
rfc2231
mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util
help-fns mail-prsvr mail-utils sort edt picture ehelp cc-mode cc-fonts 
cc-guess
cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs flyspell 
ispell
linum astyle reformatter cl-seq ansi-color edmacro kmacro desktop frameset
recentf tree-widget wid-edit leuven-theme delsel paren cua-base cus-start
cus-load bind-key cl-macs easy-mmode finder-inf package epg-config seq 
byte-opt
gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs 
pcase
cl-lib time-date mule-util tooltip eldoc electric uniquify ediff-hook 
vc-hooks
lisp-float-type mwheel dos-w32 ls-lisp disp-table w32-win w32-vars
term/common-win tool-bar dnd fontset image regexp-opt fringe tabulated-list
newcomment elisp-mode lisp-mode prog-mode register page menu-bar 
rfn-eshadow
timer select scroll-bar mouse jit-lock font-lock syntax facemenu 
font-core frame
cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai 
tai-viet
lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech 
european
ethiopic indian cyrillic chinese charscript case-table epa-hook 
jka-cmpr-hook
help simple abbrev minibuffer cl-preloaded nadvice loaddefs button faces
cus-face macroexp files text-properties overlay sha1 md5 base64 format env
code-pages mule custom widget hashtable-print-readable backquote 
w32notify w32
multi-tty make-network-process emacs)

Memory information:
((conses 16 168359 8409)
  (symbols 56 26502 0)
  (miscs 48 447 295)
  (strings 32 35909 5259)
  (string-bytes 1 1094788)
  (vectors 16 18978)
  (vector-slots 8 499407 4275)
  (floats 8 236 65)
  (intervals 56 1017 8)
  (buffers 976 25))

-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 11:34 bug#40697: 25.3; sort-lines not accepting reverse parameter Roland Hughes
@ 2020-04-18 16:13 ` Eli Zaretskii
  2020-04-18 18:43   ` Roland Hughes
  2020-04-18 16:15 ` Štěpán Němec
  1 sibling, 1 reply; 17+ messages in thread
From: Eli Zaretskii @ 2020-04-18 16:13 UTC (permalink / raw)
  To: Roland Hughes; +Cc: 40697

> From: Roland Hughes <roland@logikalsolutions.com>
> Date: Sat, 18 Apr 2020 06:34:58 -0500
> 
> 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.

If you want to sort lines in reverse order, you need to provide a
prefix argument: "C-u M-x sort-lines RET".





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 11:34 bug#40697: 25.3; sort-lines not accepting reverse parameter Roland Hughes
  2020-04-18 16:13 ` Eli Zaretskii
@ 2020-04-18 16:15 ` Štěpán Němec
  2020-04-18 16:27   ` Eli Zaretskii
  2020-04-18 18:45   ` Roland Hughes
  1 sibling, 2 replies; 17+ messages in thread
From: Štěpán Němec @ 2020-04-18 16:15 UTC (permalink / raw)
  To: Roland Hughes; +Cc: 40697

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





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 16:15 ` Štěpán Němec
@ 2020-04-18 16:27   ` Eli Zaretskii
  2022-04-13  1:59     ` Lars Ingebrigtsen
  2020-04-18 18:45   ` Roland Hughes
  1 sibling, 1 reply; 17+ messages in thread
From: Eli Zaretskii @ 2020-04-18 16:27 UTC (permalink / raw)
  To: Štěpán Němec; +Cc: roland, 40697

> From: Štěpán Němec
>  <stepnem@gmail.com>
> Date: Sat, 18 Apr 2020 18:15:37 +0200
> Cc: 40697@debbugs.gnu.org
> 
> Maybe we should improve the wording? Would just saying "When called
> interactively, prefix argument means sort in descending order" be
> enough?

Yes, and BEG/END being the region was also not described.  I fixed
that now.





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 16:13 ` Eli Zaretskii
@ 2020-04-18 18:43   ` Roland Hughes
  2020-04-18 18:53     ` Eli Zaretskii
  0 siblings, 1 reply; 17+ messages in thread
From: Roland Hughes @ 2020-04-18 18:43 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 40697

It won't let me enter the argument, that is the point of the bug.

On 4/18/20 11:13 AM, Eli Zaretskii wrote:
>> From: Roland Hughes <roland@logikalsolutions.com>
>> Date: Sat, 18 Apr 2020 06:34:58 -0500
>>
>> 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.
> If you want to sort lines in reverse order, you need to provide a
> prefix argument: "C-u M-x sort-lines RET".

-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 16:15 ` Štěpán Němec
  2020-04-18 16:27   ` Eli Zaretskii
@ 2020-04-18 18:45   ` Roland Hughes
  2020-04-18 19:12     ` Štěpán Němec
  2020-04-18 19:27     ` Eli Zaretskii
  1 sibling, 2 replies; 17+ messages in thread
From: Roland Hughes @ 2020-04-18 18:45 UTC (permalink / raw)
  To: Štěpán Němec; +Cc: 40697

Okay, I was not descriptive enough.

In interactive mode you cannot enter the argument but according to the 
documentation I should be able to. To enter an argument I would have to 
be able to use the space bar after entering sort-lines. When I try using 
the spacebar I get [SoleCompletion] and no space. Cannot enter argument.

On 4/18/20 11:15 AM, Štěpán Němec wrote:
> 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?
>
-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 18:43   ` Roland Hughes
@ 2020-04-18 18:53     ` Eli Zaretskii
  2020-04-18 19:05       ` Roland Hughes
  0 siblings, 1 reply; 17+ messages in thread
From: Eli Zaretskii @ 2020-04-18 18:53 UTC (permalink / raw)
  To: Roland Hughes; +Cc: 40697

> Cc: 40697@debbugs.gnu.org
> From: Roland Hughes <roland@logikalsolutions.com>
> Date: Sat, 18 Apr 2020 13:43:12 -0500
> 
> It won't let me enter the argument, that is the point of the bug.

I'm sorry, I don't think I understand what you mean by "enter the
argument".  Please elaborate.





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 18:53     ` Eli Zaretskii
@ 2020-04-18 19:05       ` Roland Hughes
  0 siblings, 0 replies; 17+ messages in thread
From: Roland Hughes @ 2020-04-18 19:05 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 40697


On 4/18/20 1:53 PM, Eli Zaretskii wrote:
>> Cc: 40697@debbugs.gnu.org
>> From: Roland Hughes <roland@logikalsolutions.com>
>> Date: Sat, 18 Apr 2020 13:43:12 -0500
>>
>> It won't let me enter the argument, that is the point of the bug.
> I'm sorry, I don't think I understand what you mean by "enter the
> argument".  Please elaborate.

According to the help text and the online doc

===

sort-lines is an interactive compiled Lisp function.

(sort-lines REVERSE BEG END)

===

I have EDT emulation on (biggest draw ever!)

[GOLD]-7

brings up the M-x prompt without my having to remember cryptic keystrokes.

If I type

sort-lines [RETURN]

it sorts the entire buffer as expect. No prompt for an optional 
argument, the sort just happens.

If I type

sort-lines[spacebar]

I get the [Sole Completion] message and the cursor remains firmly mushed 
against the "s". I tried [TAB], I tried everything. There is no way to 
enter

sort-lines REVERSE [RETURN]

_that_ is my bug report.

On Linux I have the version from the Emacs PPA. On Windows 10 it came 
straight from the GNU site. Both behave exactly the same way.

All of the sort-something commands work from [GOLD]-7. You just cannot 
enter any parameters.

I started using Emacs specifically for EDT emulation.


-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 18:45   ` Roland Hughes
@ 2020-04-18 19:12     ` Štěpán Němec
  2020-04-18 19:35       ` Roland Hughes
  2020-04-18 19:27     ` Eli Zaretskii
  1 sibling, 1 reply; 17+ messages in thread
From: Štěpán Němec @ 2020-04-18 19:12 UTC (permalink / raw)
  To: Roland Hughes; +Cc: 40697

On Sat, 18 Apr 2020 13:45:17 -0500
Roland Hughes wrote:

> Okay, I was not descriptive enough.
>
> In interactive mode you cannot enter the argument but according to the
> documentation I should be able to. To enter an argument I would have
> to be able to use the space bar after entering sort-lines. When I try
> using the spacebar I get [SoleCompletion] and no space. Cannot enter
> argument.

I think you misunderstand. The command does not read any arguments. The
"argument" mentioned in the doc string is the interactive _prefix_
argument.

Please do have a look at the manual section I mentioned:

  (info "(emacs) Arguments")

(you can put point after the closing paren and press C-x C-e)

Or even try the Emacs tutorial (C-h t) if it's still unclear.

Also, Eli has since tried to clarify the doc string on the emacs-27
branch:

2020-04-18T19:26:30+03:00!eliz@gnu.org
6c187ed6b0 (Improve documentation of 'sort-lines')
https://git.sv.gnu.org/cgit/emacs.git/commit/?id=6c187ed6b0

-- 
Štěpán





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 18:45   ` Roland Hughes
  2020-04-18 19:12     ` Štěpán Němec
@ 2020-04-18 19:27     ` Eli Zaretskii
  2020-04-18 19:48       ` Roland Hughes
  1 sibling, 1 reply; 17+ messages in thread
From: Eli Zaretskii @ 2020-04-18 19:27 UTC (permalink / raw)
  To: Roland Hughes; +Cc: stepnem, 40697

> From: Roland Hughes <roland@logikalsolutions.com>
> Date: Sat, 18 Apr 2020 13:45:17 -0500
> Cc: 40697@debbugs.gnu.org
> 
> Okay, I was not descriptive enough.
> 
> In interactive mode you cannot enter the argument but according to the 
> documentation I should be able to. To enter an argument I would have to 
> be able to use the space bar after entering sort-lines. When I try using 
> the spacebar I get [SoleCompletion] and no space. Cannot enter argument.

I modified the doc string to say this instead:

  Sort lines in region alphabetically; REVERSE non-nil means descending order.
  Interactively, REVERSE is the prefix argument, and BEG and END are the region.
  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.

Does this modified doc string resolve the issue you had?





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 19:12     ` Štěpán Němec
@ 2020-04-18 19:35       ` Roland Hughes
  0 siblings, 0 replies; 17+ messages in thread
From: Roland Hughes @ 2020-04-18 19:35 UTC (permalink / raw)
  To: Štěpán Němec; +Cc: 40697


On 4/18/20 2:12 PM, Štěpán Němec wrote:
> On Sat, 18 Apr 2020 13:45:17 -0500
> Roland Hughes wrote:
>
>> Okay, I was not descriptive enough.
>>
>> In interactive mode you cannot enter the argument but according to the
>> documentation I should be able to. To enter an argument I would have
>> to be able to use the space bar after entering sort-lines. When I try
>> using the spacebar I get [SoleCompletion] and no space. Cannot enter
>> argument.
> I think you misunderstand. The command does not read any arguments. The
> "argument" mentioned in the doc string is the interactive _prefix_
> argument.
>
> Please do have a look at the manual section I mentioned:
>
>    (info "(emacs) Arguments")
>
> (you can put point after the closing paren and press C-x C-e)
>
> Or even try the Emacs tutorial (C-h t) if it's still unclear.
>
> Also, Eli has since tried to clarify the doc string on the emacs-27
> branch:
>
> 2020-04-18T19:26:30+03:00!eliz@gnu.org
> 6c187ed6b0 (Improve documentation of 'sort-lines')
> https://git.sv.gnu.org/cgit/emacs.git/commit/?id=6c187ed6b0
>
The biggest turn-off for most new users, even of GUI Emacs is the 
endless string of C-u M-x C-h letter sequences. EDT mode was a big draw 
because it could eliminate almost all of that. I've been in IT over 30 
years and never found anything more intuitive than keypad navigation.

C-u [GOLD]-7 doesn't reliably work. It works the first time, but if you 
try another sort in the same buffer they don't seem to work. I got 
similar results with C-u M-x in a shiny new buffer with the same data. 
First sort worked, second one didn't.

 From the doc I was really hoping they (whoever they are) had made Emacs 
more intuitive with EDT mode.

[GOLD]-7 sort-lines reverse [RETURN]

is much more intuitive IMO, as someone who used EDT for years. I've also 
done Linux and embedded systems work for years too.

The emacswiki site was much more informative than the doc.

https://www.emacswiki.org/emacs/Sorting

According to the doc the "sort-lines reverse" should have worked. The 
wiki doesn't even present that as a possibility.

Thanks for the assistance.

-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 19:27     ` Eli Zaretskii
@ 2020-04-18 19:48       ` Roland Hughes
  2020-04-19 13:08         ` Eli Zaretskii
  0 siblings, 1 reply; 17+ messages in thread
From: Roland Hughes @ 2020-04-18 19:48 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: stepnem, 40697


On 4/18/20 2:27 PM, Eli Zaretskii wrote:
>> From: Roland Hughes <roland@logikalsolutions.com>
>> Date: Sat, 18 Apr 2020 13:45:17 -0500
>> Cc: 40697@debbugs.gnu.org
>>
>> Okay, I was not descriptive enough.
>>
>> In interactive mode you cannot enter the argument but according to the
>> documentation I should be able to. To enter an argument I would have to
>> be able to use the space bar after entering sort-lines. When I try using
>> the spacebar I get [SoleCompletion] and no space. Cannot enter argument.
> I modified the doc string to say this instead:
>
>    Sort lines in region alphabetically; REVERSE non-nil means descending order.
>    Interactively, REVERSE is the prefix argument, and BEG and END are the region.
>    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.
>
> Does this modified doc string resolve the issue you had?

No, the wiki page does.

https://www.emacswiki.org/emacs/Sorting

The wording in the help text is rather expert friendly. A user coming in 
cold to Emacs is going to interpret "prefix argument" as

[GOLD]-7 REVERSE sort-lines [RETURN]

I've been getting back into Emacs because I was getting back into COBOL 
and working with GNUCOBOL. Emacs is currently as close to an IDE as 
their is until one of the 3.x versions of GNUCOBOL is officially 
released. It will work with a few more then. EDT on GUI Emacs makes the 
editor vastly more accessible to anyone who has used EDT, LSE, JED (with 
EDT keypad enabled) and others than mirror the EDT keypad.

Of course, any time I have to deep dive to get into something I tend to 
write a book about it.

https://www.theminimumyouneedtoknow.com/app_book.html

The GUI Emacs book focusing on using EDT keypad is almost complete. Sort 
was the last topic before creating cover art, tagging indexes, and 
sending off for first round edit.

-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 19:48       ` Roland Hughes
@ 2020-04-19 13:08         ` Eli Zaretskii
  2020-04-19 13:40           ` Roland Hughes
  0 siblings, 1 reply; 17+ messages in thread
From: Eli Zaretskii @ 2020-04-19 13:08 UTC (permalink / raw)
  To: Roland Hughes; +Cc: stepnem, 40697

> Cc: stepnem@gmail.com, 40697@debbugs.gnu.org
> From: Roland Hughes <roland@logikalsolutions.com>
> Date: Sat, 18 Apr 2020 14:48:19 -0500
> 
> The wording in the help text is rather expert friendly. A user coming in 
> cold to Emacs is going to interpret "prefix argument" as
> 
> [GOLD]-7 REVERSE sort-lines [RETURN]

I can only say that I used the terminology and style that are used
everywhere in our doc strings.





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-19 13:08         ` Eli Zaretskii
@ 2020-04-19 13:40           ` Roland Hughes
  2020-04-19 16:21             ` Noam Postavsky
  0 siblings, 1 reply; 17+ messages in thread
From: Roland Hughes @ 2020-04-19 13:40 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: stepnem, 40697


On 4/19/20 8:08 AM, Eli Zaretskii wrote:
>> Cc: stepnem@gmail.com, 40697@debbugs.gnu.org
>> From: Roland Hughes <roland@logikalsolutions.com>
>> Date: Sat, 18 Apr 2020 14:48:19 -0500
>>
>> The wording in the help text is rather expert friendly. A user coming in
>> cold to Emacs is going to interpret "prefix argument" as
>>
>> [GOLD]-7 REVERSE sort-lines [RETURN]
> I can only say that I used the terminology and style that are used
> everywhere in our doc strings.

Yeah, I know. Not slamming you. Just pointing out the reason more 
people, especially from non-Linux platforms don't use Emacs is the 
"expert friendly" doc and culture around it. One must know all of the 
secret handshakes to join the club. New people, especially from a 
Windows world, aren't willing to do that. The GUI version of Emacs was a 
giant step in the right direction. Combined with EDT emulation it can 
eliminate needing to know most of the super secret handshakes.

Perhaps the "correct" solution here is for EDT or the sort- maintainers 
to add -reverse versions of each method so they are a single command 
with a common naming format requiring no super secret handshakes.

[GOLD]-7 sort-lines [RETURN]

[GOLD]-7 sort-lines-reverse [RETURN]

same with numbers and a few of the others. They would just be a wrapper 
layer, but they would provide an easily digestible interface for those 
not looking to become one with the internals of Emacs or Linux.

-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog






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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-19 13:40           ` Roland Hughes
@ 2020-04-19 16:21             ` Noam Postavsky
  2020-04-19 16:58               ` Roland Hughes
  0 siblings, 1 reply; 17+ messages in thread
From: Noam Postavsky @ 2020-04-19 16:21 UTC (permalink / raw)
  To: Roland Hughes; +Cc: stepnem, 40697

Roland Hughes <roland@logikalsolutions.com> writes:

> On 4/19/20 8:08 AM, Eli Zaretskii wrote:
>>> Cc: stepnem@gmail.com, 40697@debbugs.gnu.org
>>> From: Roland Hughes <roland@logikalsolutions.com>
>>> Date: Sat, 18 Apr 2020 14:48:19 -0500
>>>
>>> The wording in the help text is rather expert friendly. A user coming in
>>> cold to Emacs is going to interpret "prefix argument" as
>>>
>>> [GOLD]-7 REVERSE sort-lines [RETURN]
>> I can only say that I used the terminology and style that are used
>> everywhere in our doc strings.
>
> Yeah, I know. Not slamming you. Just pointing out the reason more
> people, especially from non-Linux platforms don't use Emacs is the
> "expert friendly" doc and culture around it. One must know all of the
> secret handshakes to join the club. New people, especially from a
> Windows world, aren't willing to do that. The GUI version of Emacs was
> a giant step in the right direction. Combined with EDT emulation it
> can eliminate needing to know most of the super secret handshakes.

Um, how many users "coming in cold to Emacs" will be coming from EDT, do
you think?  It seems to me that adding stuff to the docs about EDT style
args everywhere will only add more confusing "secret handshakes".

> Perhaps the "correct" solution here is for EDT or the sort-
> maintainers to add -reverse versions of each method so they are a
> single command with a common naming format requiring no super secret
> handshakes.
>
> [GOLD]-7 sort-lines [RETURN]
>
> [GOLD]-7 sort-lines-reverse [RETURN]
>
> same with numbers and a few of the others. They would just be a
> wrapper layer, but they would provide an easily digestible interface
> for those not looking to become one with the internals of Emacs or
> Linux.

Not sure where are any EDT maintainers at the moment, but I agree it
does sound useful for the emulation to be extended in this way.





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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-19 16:21             ` Noam Postavsky
@ 2020-04-19 16:58               ` Roland Hughes
  0 siblings, 0 replies; 17+ messages in thread
From: Roland Hughes @ 2020-04-19 16:58 UTC (permalink / raw)
  To: Noam Postavsky; +Cc: stepnem, 40697

[-- Attachment #1: Type: text/plain, Size: 3426 bytes --]


On 4/19/20 11:21 AM, Noam Postavsky wrote:
> Roland Hughes <roland@logikalsolutions.com> writes:
>
>> On 4/19/20 8:08 AM, Eli Zaretskii wrote:
>>>> Cc: stepnem@gmail.com, 40697@debbugs.gnu.org
>>>> From: Roland Hughes <roland@logikalsolutions.com>
>>>> Date: Sat, 18 Apr 2020 14:48:19 -0500
>>>>
>>>> The wording in the help text is rather expert friendly. A user coming in
>>>> cold to Emacs is going to interpret "prefix argument" as
>>>>
>>>> [GOLD]-7 REVERSE sort-lines [RETURN]
>>> I can only say that I used the terminology and style that are used
>>> everywhere in our doc strings.
>> Yeah, I know. Not slamming you. Just pointing out the reason more
>> people, especially from non-Linux platforms don't use Emacs is the
>> "expert friendly" doc and culture around it. One must know all of the
>> secret handshakes to join the club. New people, especially from a
>> Windows world, aren't willing to do that. The GUI version of Emacs was
>> a giant step in the right direction. Combined with EDT emulation it
>> can eliminate needing to know most of the super secret handshakes.
> Um, how many users "coming in cold to Emacs" will be coming from EDT, do
> you think?  It seems to me that adding stuff to the docs about EDT style
> args everywhere will only add more confusing "secret handshakes".

Not as much the point as the attached image is not only easier to 
understand and can be printed then taped to the keyboard/monitor.

There are actually still a lot of people using EDT keypad mode in 
various editors both on and off of VMS. One of the reasons JED has such 
a large community is they emulate EDT well. They even manage to make 
NUMLOCK_IS_GOLD work. (Another bug I need to fine because I can do this 
in Windows 10 and Linux with Qt just fine.

http://www.chiark.greenend.org.uk/doc/jed/html/jed006.html

One of the biggest complaints about Emacs on OpenVMS I always here is 
the complete inability to map NumLock to GOLD. Actually it is the 
biggest complaint on all platforms once people get used to keypad 
navigation.

>
>> Perhaps the "correct" solution here is for EDT or the sort-
>> maintainers to add -reverse versions of each method so they are a
>> single command with a common naming format requiring no super secret
>> handshakes.
>>
>> [GOLD]-7 sort-lines [RETURN]
>>
>> [GOLD]-7 sort-lines-reverse [RETURN]
>>
>> same with numbers and a few of the others. They would just be a
>> wrapper layer, but they would provide an easily digestible interface
>> for those not looking to become one with the internals of Emacs or
>> Linux.
> Not sure where are any EDT maintainers at the moment, but I agree it
> does sound useful for the emulation to be extended in this way.

If I get some free time I may just hack at a version for the book. It 
seems I should be able to create a command called sort-lines-reverse in 
my .emacs file and have it issue sort-lines with the prefix. I should be 
able to remove almost all of the "secret handshakes" for basic editing. 
Was trying to keep the book under 250 pages for printing reasons, but it 
isn't that big of a hit to push into the 250-300 page count price range 
for printing.

Thank you for all of your assistance.

-- 
Roland Hughes, President
Logikal Solutions
(630)-205-1593

http://www.theminimumyouneedtoknow.com
http://www.infiniteexposure.net
http://www.johnsmith-book.com
http://www.logikalblog.com
http://www.interestingauthors.com/blog


[-- Attachment #2: emacs-edt-keypad.png --]
[-- Type: image/png, Size: 30490 bytes --]

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

* bug#40697: 25.3; sort-lines not accepting reverse parameter
  2020-04-18 16:27   ` Eli Zaretskii
@ 2022-04-13  1:59     ` Lars Ingebrigtsen
  0 siblings, 0 replies; 17+ messages in thread
From: Lars Ingebrigtsen @ 2022-04-13  1:59 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: roland, Štěpán Němec, 40697

Eli Zaretskii <eliz@gnu.org> writes:

> Yes, and BEG/END being the region was also not described.  I fixed
> that now.

(I'm going through old bug reports that unfortunately weren't resolved
at the time.)

The discussion then went on to using EDT, but skimming this bug report,
the documentation was fixed, so I don't think there's anything more to
do here, so I'm closing this bug report.

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





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

end of thread, other threads:[~2022-04-13  1:59 UTC | newest]

Thread overview: 17+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-04-18 11:34 bug#40697: 25.3; sort-lines not accepting reverse parameter Roland Hughes
2020-04-18 16:13 ` Eli Zaretskii
2020-04-18 18:43   ` Roland Hughes
2020-04-18 18:53     ` Eli Zaretskii
2020-04-18 19:05       ` Roland Hughes
2020-04-18 16:15 ` Štěpán Němec
2020-04-18 16:27   ` Eli Zaretskii
2022-04-13  1:59     ` Lars Ingebrigtsen
2020-04-18 18:45   ` Roland Hughes
2020-04-18 19:12     ` Štěpán Němec
2020-04-18 19:35       ` Roland Hughes
2020-04-18 19:27     ` Eli Zaretskii
2020-04-18 19:48       ` Roland Hughes
2020-04-19 13:08         ` Eli Zaretskii
2020-04-19 13:40           ` Roland Hughes
2020-04-19 16:21             ` Noam Postavsky
2020-04-19 16:58               ` Roland Hughes

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