unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* What're the proper names for the backspace and delete keys in files.texi?
@ 2005-12-19 21:47 Alan Mackenzie
  2005-12-20  5:33 ` Richard M. Stallman
  0 siblings, 1 reply; 19+ messages in thread
From: Alan Mackenzie @ 2005-12-19 21:47 UTC (permalink / raw)


Hi, Emacs!

In the Emacs manual, the <backspace> key (the one that deletes backwards)
seems sometimes to be called @key{BS}, and at other times @key{BACKSPACE}
or @key{DEL}.

The <delete> key (the one over the arrow keys and which deletes forward)
sports the name @key{DELETE}.  I think it's always written in capitals,
but I'm not sure.

The names recommended by the Texinfo manual (on page "key") are @key{BS}
for backspace and (I think) @key{DEL} for _FORWARD_ delete.

I'm not totally unconfused, and I'm surely not the only one.  Would it
perhaps be sensible to decide on standard names for these keys and
promulgate them through the Emacs, Elisp (and CC Mode :-) manuals?

My suggestion is that (i) the backspace key should always be called
@key{BS}, despite the fact that the character it generates is ASCII DEL;
(ii) the delete key gets called @key{Delete} or @key{delete}, despite the
recommendations of the Texinfo manual.  I think @key{DEL} should be
avoided altogether, since its use as a key name contradicts is use as an
ASCII character name.

-- 
Alan Mackenzie (Munich, Germany)

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2005-12-19 21:47 What're the proper names for the backspace and delete keys in files.texi? Alan Mackenzie
@ 2005-12-20  5:33 ` Richard M. Stallman
  2005-12-20  7:06   ` Stefan Monnier
                     ` (2 more replies)
  0 siblings, 3 replies; 19+ messages in thread
From: Richard M. Stallman @ 2005-12-20  5:33 UTC (permalink / raw)
  Cc: emacs-devel

    In the Emacs manual, the <backspace> key (the one that deletes backwards)
    seems sometimes to be called @key{BS}, and at other times @key{BACKSPACE}
    or @key{DEL}.

Those are not synonymous.  The chapter on Killing explains the difference.

We worked for a long time to get this consistent and (more or less)
clear.  Now I want to leave it alone.

    The names recommended by the Texinfo manual (on page "key") are @key{BS}
    for backspace and (I think) @key{DEL} for _FORWARD_ delete.

I will talk with the Texinfo maintainer about that.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2005-12-20  5:33 ` Richard M. Stallman
@ 2005-12-20  7:06   ` Stefan Monnier
  2006-01-12 13:16   ` Alan Mackenzie
  2006-01-16 12:39   ` Alan Mackenzie
  2 siblings, 0 replies; 19+ messages in thread
From: Stefan Monnier @ 2005-12-20  7:06 UTC (permalink / raw)
  Cc: Alan Mackenzie, emacs-devel

>     The names recommended by the Texinfo manual (on page "key") are @key{BS}
>     for backspace and (I think) @key{DEL} for _FORWARD_ delete.

That looks like the convention used by XEmacs IIRC,


        Stefan

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2005-12-20  5:33 ` Richard M. Stallman
  2005-12-20  7:06   ` Stefan Monnier
@ 2006-01-12 13:16   ` Alan Mackenzie
  2006-01-12 20:10     ` Eli Zaretskii
  2006-01-19 17:45     ` Richard M. Stallman
  2006-01-16 12:39   ` Alan Mackenzie
  2 siblings, 2 replies; 19+ messages in thread
From: Alan Mackenzie @ 2006-01-12 13:16 UTC (permalink / raw)
  Cc: emacs-devel

Hi, Richard and Emacs!

On Tue, 20 Dec 2005, Richard M. Stallman wrote:

>    In the Emacs manual, the <backspace> key (the one that deletes backwards)
>    seems sometimes to be called @key{BS}, and at other times @key{BACKSPACE}
>    or @key{DEL}.

>Those are not synonymous.  The chapter on Killing explains the difference.

The Killing chapter leaves me confused (see below).

>We worked for a long time to get this consistent and (more or less)
>clear.  Now I want to leave it alone.

OK.  But what are the standard names for these two keys?  I think they're
@key{DEL} for the big rectangular backspace key and @key{DELETE} (or
should it be @key{Delete}?) for the little key below <insert> and to the
left of <end>.  The Killing chapter leaves this unclear.

>    The names recommended by the Texinfo manual (on page "key") are @key{BS}
>    for backspace and (I think) @key{DEL} for _FORWARD_ delete.

>I will talk with the Texinfo maintainer about that.

OK, here are the problems I have with @node Killing in the Emacs manual:

       Every keyboard has a large key, labeled <DEL>, <BACKSPACE>, <BS> or
    <DELETE>, which is a short distance above the <RET> or <ENTER> key and
    is normally used for erasing what you have typed.  Regardless of the
    actual name on the key, in Emacs it is equivalent to <DEL>--or it
    should be.

The above paragraph appears to be an old, unreworked version of the next
paragraph.

       Many keyboards (including standard PC keyboards) have a <BACKSPACE>
    key a short ways above <RET> or <ENTER>, and a <DELETE> key elsewhere.
    In that case, the <BACKSPACE> key is <DEL>, and the <DELETE> key is
    equivalent to `C-d'--or it should be.

Again, what is the meaning of "is" in the phrase "the <BACKSPACE> key is
<DEL>"?  What does "<DEL>" mean here?  I think it means "the key which
produces the ASCII DEL character (0x7F)".  Or it could be "the key which
deletes backwards", which seems in danger of making some definitions
circular.  What is the meaning of "equivalent" in "the <DELETE> key is
equivalent to `C-d'"?  It surely must mean "is bound to the same function
as `C-d'", since it produces a different key code.

Incidentally, is "a short WAYS above" intentionally so (some dialect of
English I don't know), or should it read "a short WAY above"?

Incidentally[2], there are (at least) three ways of capitalising
@key{DELETE} throughout the Emacs manual and friends:

# grep -c "@key{DELETE}" *.texi | gawk '$0 !~ ":0$"'
  gives
basic.texi:6
frames.texi:2
glossary.texi:1
killing.texi:3
mh-e.texi:1
msdog.texi:1
trouble.texi:8

# grep -c "@key{Delete}" *.texi | gawk '$0 !~ ":0$"'
  gives
cc-mode.texi:10
faq.texi:7
killing.texi:2

# grep -c "@key{delete}" *.texi | gawk '$0 !~ ":0$"'
  gives
programs.texi:1

The all-caps version, @key{DELETE} is surely correct, isn't it?

Anyhow, here's a first attempt at a patch to sort this out.  It's main
point is a @dfn{@key{DEL}} as "the usual erasure key".  I've tidied up a
few Whoopses too.


2006-01-12  Alan Mackenzie  <acm@muc.de>

        * killing.texi (Deletion): Define @key{DEL}.  Tidied up a bit and
        clarified some things.

Index: killing.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/killing.texi,v
retrieving revision 1.46
diff -c -r1.46 killing.texi
*** killing.texi	16 Dec 2005 12:02:51 -0000	1.46
--- killing.texi	12 Jan 2006 13:03:14 -0000
***************
*** 100,145 ****
  
  @kindex DEL
  @kindex C-d
!   The most basic delete commands are @kbd{C-d} (@code{delete-char}) and
! @key{DEL} (@code{delete-backward-char}).  @kbd{C-d} deletes the
! character after point, the one the cursor is ``on top of.''  This
! doesn't move point.  @key{DEL} deletes the character before the cursor,
! and moves point back.  You can delete newlines like any other characters
! in the buffer; deleting a newline joins two lines.  Actually, @kbd{C-d}
! and @key{DEL} aren't always delete commands; when given arguments, they
! kill instead, since they can erase more than one character this way.
  
  @kindex BACKSPACE
  @kindex BS
  @kindex DELETE
-   Every keyboard has a large key, labeled @key{DEL}, @key{BACKSPACE},
- @key{BS} or @key{DELETE}, which is a short distance above the
- @key{RET} or @key{ENTER} key and is normally used for erasing what you
- have typed.  Regardless of the actual name on the key, in Emacs it is
- equivalent to @key{DEL}---or it should be.
- 
    Many keyboards (including standard PC keyboards) have a
! @key{BACKSPACE} key a short ways above @key{RET} or @key{ENTER}, and a
! @key{DELETE} key elsewhere.  In that case, the @key{BACKSPACE} key is
! @key{DEL}, and the @key{DELETE} key is equivalent to @kbd{C-d}---or it
! should be.
  
!   Why do we say ``or it should be''?  When Emacs starts up using a
  window system, it determines automatically which key or keys should be
! equivalent to @key{DEL}.  As a result, @key{BACKSPACE} and/or @key{DELETE}
! keys normally do the right things.  But in some unusual cases Emacs
! gets the wrong information from the system.  If these keys don't do
! what they ought to do, you need to tell Emacs which key to use for
  @key{DEL}.  @xref{DEL Does Not Delete}, for how to do this.
  
- @findex normal-erase-is-backspace-mode
    On most text-only terminals, Emacs cannot tell which keys the
  keyboard really has, so it follows a uniform plan which may or may not
! fit your keyboard.  The uniform plan is that the @acronym{ASCII} @key{DEL}
! character deletes, and the @acronym{ASCII} @key{BS} (backspace) character asks
! for help (it is the same as @kbd{C-h}).  If this is not right for your
! keyboard, such as if you find that the key which ought to delete backwards
! enters Help instead, see @ref{DEL Does Not Delete}.
  
  @kindex M-\
  @findex delete-horizontal-space
--- 100,142 ----
  
  @kindex DEL
  @kindex C-d
!   The most basic delete commands are @kbd{C-d} (@code{delete-char})
! and @kbd{@key{DEL}} (@code{delete-backward-char}).  @kbd{C-d} deletes
! the character after point, the one the cursor is ``on top of.''  This
! doesn't move point.  @key{DEL} deletes the character before the
! cursor, and moves point back.  You can delete newlines like any other
! characters in the buffer; deleting a newline joins two lines.
! Actually, @kbd{C-d} and @key{DEL} aren't always delete commands; when
! given arguments, they kill instead, since they can erase more than one
! character this way.
  
+ @cindex @key{DEL} key
  @kindex BACKSPACE
  @kindex BS
  @kindex DELETE
    Many keyboards (including standard PC keyboards) have a
! @key{BACKSPACE} key a short way above @key{RET} or @key{ENTER}, and a
! @key{DELETE} key elsewhere.  The @key{BACKSPACE} key, the ``usual
! erasure key'' which deletes the previous character, is called
! @dfn{@key{DEL}} throughout this manual.  The @key{DELETE} key, like
! @kbd{C-d}, deletes the following character---or it should do.
  
!   Why do we say ``or it should do''?  When Emacs starts up using a
  window system, it determines automatically which key or keys should be
! @key{DEL}.  As a result, the @key{BACKSPACE} and @key{DELETE} keys
! normally do the right things.  But in some unusual cases Emacs gets
! the wrong information from the system.  If these keys don't do what
! they ought to do, you need to tell Emacs which key to use for
  @key{DEL}.  @xref{DEL Does Not Delete}, for how to do this.
  
    On most text-only terminals, Emacs cannot tell which keys the
  keyboard really has, so it follows a uniform plan which may or may not
! fit your keyboard.  The uniform plan is that the @acronym{ASCII}
! @key{DEL} character deletes backwards, and the @acronym{ASCII}
! @key{BS} (backspace) character asks for help (it is the same as
! @kbd{C-h}).  If this is not right for your keyboard, such as if you
! find that the key which ought to delete backwards enters Help instead,
! see @ref{DEL Does Not Delete}.
  
  @kindex M-\
  @findex delete-horizontal-space

#########################################################################

-- 
Alan Mackenzie (Munich, Germany)

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-12 13:16   ` Alan Mackenzie
@ 2006-01-12 20:10     ` Eli Zaretskii
  2006-01-12 21:27       ` Alan Mackenzie
  2006-01-19 17:45     ` Richard M. Stallman
  1 sibling, 1 reply; 19+ messages in thread
From: Eli Zaretskii @ 2006-01-12 20:10 UTC (permalink / raw)
  Cc: rms, emacs-devel

> Date: Thu, 12 Jan 2006 13:16:59 +0000 (GMT)
> From: Alan Mackenzie <acm@muc.de>
> Cc: emacs-devel@gnu.org
> 
> OK, here are the problems I have with @node Killing in the Emacs manual:
> 
>        Every keyboard has a large key, labeled <DEL>, <BACKSPACE>, <BS> or
>     <DELETE>, which is a short distance above the <RET> or <ENTER> key and
>     is normally used for erasing what you have typed.  Regardless of the
>     actual name on the key, in Emacs it is equivalent to <DEL>--or it
>     should be.
> 
> The above paragraph appears to be an old, unreworked version of the next
> paragraph.
> 
>        Many keyboards (including standard PC keyboards) have a <BACKSPACE>
>     key a short ways above <RET> or <ENTER>, and a <DELETE> key elsewhere.
>     In that case, the <BACKSPACE> key is <DEL>, and the <DELETE> key is
>     equivalent to `C-d'--or it should be.

I actually like the first (older) version better.  I think "a short
distance" will be better understood, in particular by non-native
English speakers, than "a short ways".  And there's no confusing
"<BACKSPACE> key is <DEL>" wording.

> What is the meaning of "equivalent" in "the <DELETE> key is
> equivalent to `C-d'"?

What it always meant--that it produces the same effect.

> Incidentally, is "a short WAYS above" intentionally so (some dialect of
> English I don't know), or should it read "a short WAY above"?

No, it's "short ways", which means nearby.  Like I said: it's not
immediately understandable.

>                                     The @key{DELETE} key, like
> ! @kbd{C-d}, deletes the following character---or it should do.

I don't think ``it should do'' is correct English here.  I think the
correct wording is ``---or it should.''

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-12 20:10     ` Eli Zaretskii
@ 2006-01-12 21:27       ` Alan Mackenzie
  2006-01-13  8:04         ` Eli Zaretskii
  2006-01-13  9:09         ` Neil Jerram
  0 siblings, 2 replies; 19+ messages in thread
From: Alan Mackenzie @ 2006-01-12 21:27 UTC (permalink / raw)
  Cc: emacs-devel



On Thu, 12 Jan 2006, Eli Zaretskii wrote:

>> Date: Thu, 12 Jan 2006 13:16:59 +0000 (GMT)
>> From: Alan Mackenzie <acm@muc.de>
>> Cc: emacs-devel@gnu.org

>> OK, here are the problems I have with @node Killing in the Emacs manual:

>>        Every keyboard has a large key, labeled <DEL>, <BACKSPACE>, <BS> or
>>     <DELETE>, which is a short distance above the <RET> or <ENTER> key and
>>     is normally used for erasing what you have typed.  Regardless of the
>>     actual name on the key, in Emacs it is equivalent to <DEL>--or it
>>     should be.

>> The above paragraph appears to be an old, unreworked version of the next
>> paragraph.

>>        Many keyboards (including standard PC keyboards) have a <BACKSPACE>
>>     key a short ways above <RET> or <ENTER>, and a <DELETE> key elsewhere.
>>     In that case, the <BACKSPACE> key is <DEL>, and the <DELETE> key is
>>     equivalent to `C-d'--or it should be.

>I actually like the first (older) version better.  I think "a short
>distance" will be better understood, in particular by non-native
>English speakers, than "a short ways".  And there's no confusing
>"<BACKSPACE> key is <DEL>" wording.

>> What is the meaning of "equivalent" in "the <DELETE> key is
>> equivalent to `C-d'"?

>What it always meant--that it produces the same effect.

But there is vagueness there, though - the two keys cease to be
"equivalent" when the M- modifier is added.

>> Incidentally, is "a short WAYS above" intentionally so (some dialect of
>> English I don't know), or should it read "a short WAY above"?

>No, it's "short ways", which means nearby.  Like I said: it's not
>immediately understandable.

Agreed.  :-)

>>                                     The @key{DELETE} key, like
>> ! @kbd{C-d}, deletes the following character---or it should do.

>I don't think ``it should do'' is correct English here.  I think the
>correct wording is ``---or it should.''

"or it should do" is perfectly correct English - "do" is a sort of
"pro-verb" referring to the last used verb, much like the pronoun "it"
refers to the last used noun.  (English is my native language).  But "or
it should" is just as correct, and it's shorter (therefore better ;-).

-- 
Alan.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-12 21:27       ` Alan Mackenzie
@ 2006-01-13  8:04         ` Eli Zaretskii
  2006-01-13  9:09         ` Neil Jerram
  1 sibling, 0 replies; 19+ messages in thread
From: Eli Zaretskii @ 2006-01-13  8:04 UTC (permalink / raw)
  Cc: emacs-devel

> Date: Thu, 12 Jan 2006 21:27:42 +0000 (GMT)
> From: Alan Mackenzie <acm@muc.de>
> cc: emacs-devel@gnu.org
> 
> >> What is the meaning of "equivalent" in "the <DELETE> key is
> >> equivalent to `C-d'"?
> 
> >What it always meant--that it produces the same effect.
> 
> But there is vagueness there, though - the two keys cease to be
> "equivalent" when the M- modifier is added.

The text says "in Emacs it is equivalent to <DEL>".  And as you know,
in Emacs M-<DEL> and <DEL> are two different keys.

In other words, when we speak about ``keys'' in Emacs, we don't mean
the scancodes generated by pressing the key.  We mean the character or
symbol that Emacs sees in its keyboard input queue.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-12 21:27       ` Alan Mackenzie
  2006-01-13  8:04         ` Eli Zaretskii
@ 2006-01-13  9:09         ` Neil Jerram
  2006-01-13 16:55           ` Lennart Borgman
  2006-01-13 19:38           ` Eli Zaretskii
  1 sibling, 2 replies; 19+ messages in thread
From: Neil Jerram @ 2006-01-13  9:09 UTC (permalink / raw)
  Cc: emacs-devel

Alan Mackenzie <acm@muc.de> writes:

> On Thu, 12 Jan 2006, Eli Zaretskii wrote:
>
>>> Date: Thu, 12 Jan 2006 13:16:59 +0000 (GMT)
>>> From: Alan Mackenzie <acm@muc.de>
>>> Cc: emacs-devel@gnu.org
>
>>> Incidentally, is "a short WAYS above" intentionally so (some dialect of
>>> English I don't know), or should it read "a short WAY above"?
>
>>No, it's "short ways", which means nearby.  Like I said: it's not
>>immediately understandable.
>
> Agreed.  :-)

I don't agree!  "a short ways" may be considered proper in the US, but
in the UK it is definitely still US-style slang, and it may not be
understood in other English-speaking places.

Let's please change this to "a short way above", which is standard
English usage everywhere.

Regards,
        Neil

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-13  9:09         ` Neil Jerram
@ 2006-01-13 16:55           ` Lennart Borgman
  2006-01-13 17:26             ` Neil Jerram
  2006-01-13 20:03             ` Aidan Kehoe
  2006-01-13 19:38           ` Eli Zaretskii
  1 sibling, 2 replies; 19+ messages in thread
From: Lennart Borgman @ 2006-01-13 16:55 UTC (permalink / raw)
  Cc: Alan Mackenzie, emacs-devel


> I don't agree!  "a short ways" may be considered proper in the US, but
> in the UK it is definitely still US-style slang, and it may not be
> understood in other English-speaking places.
>
> Let's please change this to "a short way above", which is standard
> English usage everywhere.
>
> Regards,
>         Neil
>   
Is this my keyboard or my English? I would expect something like "just 
above", "right above" etc.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-13 16:55           ` Lennart Borgman
@ 2006-01-13 17:26             ` Neil Jerram
  2006-01-13 20:03             ` Aidan Kehoe
  1 sibling, 0 replies; 19+ messages in thread
From: Neil Jerram @ 2006-01-13 17:26 UTC (permalink / raw)
  Cc: Alan Mackenzie, emacs-devel

Lennart Borgman <lennart.borgman.073@student.lu.se> writes:

> Is this my keyboard or my English? I would expect something like "just
> above", "right above" etc.

Both of those would be equally good, IMO.

     Neil

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-13  9:09         ` Neil Jerram
  2006-01-13 16:55           ` Lennart Borgman
@ 2006-01-13 19:38           ` Eli Zaretskii
  2006-01-13 21:31             ` Drew Adams
  1 sibling, 1 reply; 19+ messages in thread
From: Eli Zaretskii @ 2006-01-13 19:38 UTC (permalink / raw)
  Cc: acm, emacs-devel

> From: Neil Jerram <neil@ossau.uklinux.net>
> Date: Fri, 13 Jan 2006 09:09:15 +0000
> Cc: emacs-devel@gnu.org
> 
> >>No, it's "short ways", which means nearby.  Like I said: it's not
> >>immediately understandable.
> >
> > Agreed.  :-)
> 
> I don't agree!  "a short ways" may be considered proper in the US, but
> in the UK it is definitely still US-style slang, and it may not be
> understood in other English-speaking places.

The Emacs manuals are written in the US English dialect.  That's why
we say "recognize", "color", etc.

But I think Alan said "agreed" to the "not immediately understandable"
part.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-13 16:55           ` Lennart Borgman
  2006-01-13 17:26             ` Neil Jerram
@ 2006-01-13 20:03             ` Aidan Kehoe
  1 sibling, 0 replies; 19+ messages in thread
From: Aidan Kehoe @ 2006-01-13 20:03 UTC (permalink / raw)
  Cc: emacs-devel


 Ar an triú lá déag de mí Eanair, scríobh Lennart Borgman: 

 > > I don't agree!  "a short ways" may be considered proper in the US, but
 > > in the UK it is definitely still US-style slang, and it may not be
 > > understood in other English-speaking places.
 > >
 > > Let's please change this to "a short way above", which is standard
 > > English usage everywhere.
 >
 > Is this my keyboard or my English? I would expect something like "just 
 > above", "right above" etc.

Your keyboard. Look through the layouts available with xkeycaps if you’re
curious.

-- 
I AM IN JAIL AND ALLOWED SEND ONLY ONE CABLE SINCE WAS ARRESTED WHILE
MEASURING FIFTEEN FOOT WALL OUTSIDE PALACE AND HAVE JUST FINISHED COUNTING
THIRTY EIGHT THOUSAND FIVE HUNDERED TWENTY TWO NAMES WHOS WHO IN MIDEAST.

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

* RE: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-13 19:38           ` Eli Zaretskii
@ 2006-01-13 21:31             ` Drew Adams
  0 siblings, 0 replies; 19+ messages in thread
From: Drew Adams @ 2006-01-13 21:31 UTC (permalink / raw)


    > I don't agree!  "a short ways" may be considered proper in the US, but
    > in the UK it is definitely still US-style slang, and it may not be
    > understood in other English-speaking places.

    The Emacs manuals are written in the US English dialect.  That's why
    we say "recognize", "color", etc.

Whech Amurcun dialec' didja mean, Eelah?

Ah'd say thet "a ways" be 'bout the same thing as "a fur piece": "He walked
a fur piece down th' road" = "He walked a ways down th' road."

Thats'd ah'd say 'bout et. The American Heritage Dictionary, however, says
this 'bout it (http://www.bartleby.com/61/57/W0065700.html):

 ways - NOUN: Informal (used with a sing. verb) Variant of way
              (sense 1). See Usage Note at way.

 way - USAGE NOTE: Way has long been an intensifying adverb meaning
       “to a great degree,” as in way over budget. This usage is both
       acceptable and common but has an informal ring. •Way is also
       used as a general intensifier, as in way cool and way
       depressing. This locution has expanded beyond its original
       range of younger speakers, but it is still regarded as slang.
       •In American English ways is often used as an equivalent of
       way in phrases such as a long ways to go. The usage is
       acceptable but is usually considered informal.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2005-12-20  5:33 ` Richard M. Stallman
  2005-12-20  7:06   ` Stefan Monnier
  2006-01-12 13:16   ` Alan Mackenzie
@ 2006-01-16 12:39   ` Alan Mackenzie
  2006-01-16 18:48     ` Thien-Thi Nguyen
  2006-01-17  3:25     ` Richard M. Stallman
  2 siblings, 2 replies; 19+ messages in thread
From: Alan Mackenzie @ 2006-01-16 12:39 UTC (permalink / raw)
  Cc: emacs-devel

Hi, Richard, Hi, Emacs!

On Tue, 20 Dec 2005, Richard M. Stallman wrote:

>    In the Emacs manual, the <backspace> key (the one that deletes backwards)
>    seems sometimes to be called @key{BS}, and at other times @key{BACKSPACE}
>    or @key{DEL}.

>Those are not synonymous.  The chapter on Killing explains the difference.

For the third time of asking, would somebody (Richard?) please state
definitively what the canonical names, to be used in files.texi, are for
the "backspace" key (typically the large rectangular key above CR that
deletes a single character backwards) and the "delete" key (typically the
bottom leftmost key of a block of 6 keys directly to the right of CR,
that deletes a single character forwards).

I think the canonical names for these keys are, respectively, @key{DEL}
and @key{DELETE} (with exactly that capitalization), but I'm not sure.

I want to amend the CC Mode manual to use the standard names for these
two keys.

>We worked for a long time to get this consistent and (more or less)
>clear.  Now I want to leave it alone.

-- 
Alan Mackenzie (Munich, Germany)

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-16 12:39   ` Alan Mackenzie
@ 2006-01-16 18:48     ` Thien-Thi Nguyen
  2006-01-17  3:25     ` Richard M. Stallman
  1 sibling, 0 replies; 19+ messages in thread
From: Thien-Thi Nguyen @ 2006-01-16 18:48 UTC (permalink / raw)
  Cc: emacs-devel

Alan Mackenzie <acm@muc.de> writes:

> For the third time of asking, would somebody (Richard?) please state
> definitively what the canonical names, to be used in files.texi, are
> for the "backspace" key (typically the large rectangular key above CR
> that deletes a single character backwards) and the "delete" key
> (typically the bottom leftmost key of a block of 6 keys directly to
> the right of CR, that deletes a single character forwards).

the actual form of the ink pressed onto the plastic is something that
has no hope of attaining universal standardization.  this means that if
you have to say "typically", then documentation purporting to use a
"canonical name" will be incorrect for some (many) situations.  it's
more slackful for everyone involved to not sing a false canon to the
un{willing,hearing} in the first place.

(btw, data point: my keyboard does not conform to the above layout.)

thi

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-16 12:39   ` Alan Mackenzie
  2006-01-16 18:48     ` Thien-Thi Nguyen
@ 2006-01-17  3:25     ` Richard M. Stallman
  2006-01-17 11:00       ` Alan Mackenzie
  1 sibling, 1 reply; 19+ messages in thread
From: Richard M. Stallman @ 2006-01-17  3:25 UTC (permalink / raw)
  Cc: emacs-devel

    For the third time of asking, would somebody (Richard?) please state
    definitively what the canonical names, to be used in files.texi, are for
    the "backspace" key (typically the large rectangular key above CR that
    deletes a single character backwards) and the "delete" key (typically the
    bottom leftmost key of a block of 6 keys directly to the right of CR,
    that deletes a single character forwards).

    I think the canonical names for these keys are, respectively, @key{DEL}
    and @key{DELETE} (with exactly that capitalization), but I'm not sure.

BACKSPACE or BS is the key labeled Backspace.  DELETE refers to the
key labeled "Delete".

DEL means the ASCII character 0177.  In Emacs, either DELETE or
BACKSPACE is equivalent to DEL.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-17  3:25     ` Richard M. Stallman
@ 2006-01-17 11:00       ` Alan Mackenzie
  2006-01-17 19:59         ` Richard M. Stallman
  0 siblings, 1 reply; 19+ messages in thread
From: Alan Mackenzie @ 2006-01-17 11:00 UTC (permalink / raw)
  Cc: emacs-devel

Hi, All!

On Mon, 16 Jan 2006, Richard M. Stallman wrote:

>    For the third time of asking, would somebody (Richard?) please state
>    definitively what the canonical names, to be used in files.texi, are for
>    the "backspace" key (typically the large rectangular key above CR that
>    deletes a single character backwards) and the "delete" key (typically the
>    bottom leftmost key of a block of 6 keys directly to the right of CR,
>    that deletes a single character forwards).

>    I think the canonical names for these keys are, respectively, @key{DEL}
>    and @key{DELETE} (with exactly that capitalization), but I'm not sure.

>BACKSPACE or BS is the key labeled Backspace.  DELETE refers to the
>key labeled "Delete".

>DEL means the ASCII character 0177.  In Emacs, either DELETE or
>BACKSPACE is equivalent to DEL.

Many Thanks!

So, a more prolix summary of these things:

@key{DEL} is a _logical_ key, that key which happens to generate ASCII
DEL (0x7f) when you press it.  So the sentence "Emacs binds @key{DEL} to
the command @code{delete-backward-char} by default." would be entirely
appropriate.

@key{BACKSPACE} (or @key{BS}) and @key{DELETE} are _physical_ keys,
characterised by their positions on the keyboard or the text embossed
upon them (even though these positions/embossments vary between keyboards
and cultures).  @key{BACKSPACE} and @key{DELETE} are thus the appropriate
names to use for the keys that delete in the wrong direction in "@node
DEL Does Not Delete".

The "Equivalent" above means "is configured, whether by the OS's keyboard
setup or Emacs's function-key-map or some other means, to produce the
same keycode as".

I think I've got it now!  Apologies to all fellow hackers whose patience
I've stretched in this thread.

-- 
Alan.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-17 11:00       ` Alan Mackenzie
@ 2006-01-17 19:59         ` Richard M. Stallman
  0 siblings, 0 replies; 19+ messages in thread
From: Richard M. Stallman @ 2006-01-17 19:59 UTC (permalink / raw)
  Cc: emacs-devel

    @key{DEL} is a _logical_ key, that key which happens to generate ASCII
    DEL (0x7f) when you press it.  So the sentence "Emacs binds @key{DEL} to
    the command @code{delete-backward-char} by default." would be entirely
    appropriate.

That's true, more or less--except that under X all keys are "logical"
in this sense.

Thus, `DEL' stands for ASCII code DEL.
'DELETE' stands for the symbol DELETE.

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

* Re: What're the proper names for the backspace and delete keys in files.texi?
  2006-01-12 13:16   ` Alan Mackenzie
  2006-01-12 20:10     ` Eli Zaretskii
@ 2006-01-19 17:45     ` Richard M. Stallman
  1 sibling, 0 replies; 19+ messages in thread
From: Richard M. Stallman @ 2006-01-19 17:45 UTC (permalink / raw)
  Cc: emacs-devel

	   Every keyboard has a large key, labeled <DEL>, <BACKSPACE>, <BS> or
	<DELETE>, which is a short distance above the <RET> or <ENTER> key and
	is normally used for erasing what you have typed.  Regardless of the
	actual name on the key, in Emacs it is equivalent to <DEL>--or it
	should be.

    The above paragraph appears to be an old, unreworked version of the next
    paragraph.

	   Many keyboards (including standard PC keyboards) have a <BACKSPACE>
	key a short ways above <RET> or <ENTER>, and a <DELETE> key elsewhere.
	In that case, the <BACKSPACE> key is <DEL>, and the <DELETE> key is
	equivalent to `C-d'--or it should be.

They are not redundant, and neither was derived from the other.
The second describes a special case of the first.  They are
both correct, and both necessary.

      What is the meaning of "equivalent" in "the <DELETE> key is
    equivalent to `C-d'"?  It surely must mean "is bound to the same function
    as `C-d'", since it produces a different key code.

That's right.  In normal Emacs usage, those two keys should be
equivalent, since they have the same standard bindings.

    The all-caps version, @key{DELETE} is surely correct, isn't it?

Yes--so the others should be fixed.  I will fix those in the Emacs
Manual proper; could you fix the rest?

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

end of thread, other threads:[~2006-01-19 17:45 UTC | newest]

Thread overview: 19+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2005-12-19 21:47 What're the proper names for the backspace and delete keys in files.texi? Alan Mackenzie
2005-12-20  5:33 ` Richard M. Stallman
2005-12-20  7:06   ` Stefan Monnier
2006-01-12 13:16   ` Alan Mackenzie
2006-01-12 20:10     ` Eli Zaretskii
2006-01-12 21:27       ` Alan Mackenzie
2006-01-13  8:04         ` Eli Zaretskii
2006-01-13  9:09         ` Neil Jerram
2006-01-13 16:55           ` Lennart Borgman
2006-01-13 17:26             ` Neil Jerram
2006-01-13 20:03             ` Aidan Kehoe
2006-01-13 19:38           ` Eli Zaretskii
2006-01-13 21:31             ` Drew Adams
2006-01-19 17:45     ` Richard M. Stallman
2006-01-16 12:39   ` Alan Mackenzie
2006-01-16 18:48     ` Thien-Thi Nguyen
2006-01-17  3:25     ` Richard M. Stallman
2006-01-17 11:00       ` Alan Mackenzie
2006-01-17 19:59         ` Richard M. Stallman

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