From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Robert Weiner <rsw@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: Improving describe-mode and discoverability
Date: Thu, 23 Jun 2016 15:11:44 -0400
Message-ID: <CA+OMD9jmxN03NjR9cSuXObmqOhTPv6MqgF6=tm_s14cPuOzvGg@mail.gmail.com>
References: <576C2A6C.3090908@gmail.com>
	<CA+OMD9hYGpGn=e_iKQQnFoAKrdk7dq=etOQ0Qjr7X_iF+o1FDg@mail.gmail.com>
	<576C2FE4.5000705@gmail.com>
Reply-To: rswgnu@gmail.com
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary=001a113d6c5ee3a5810535f6d4b7
X-Trace: ger.gmane.org 1466709185 28588 80.91.229.3 (23 Jun 2016 19:13:05 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Thu, 23 Jun 2016 19:13:05 +0000 (UTC)
Cc: Emacs developers <emacs-devel@gnu.org>
To: =?UTF-8?B?Q2zDqW1lbnQgUGl0LS1DbGF1ZGVs?= <clement.pit@gmail.com>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 23 21:13:00 2016
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane.org
Original-Received: from lists.gnu.org ([208.118.235.17])
	by plane.gmane.org with esmtp (Exim 4.69)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1bGA3e-0004Hd-3V
	for ged-emacs-devel@m.gmane.org; Thu, 23 Jun 2016 21:12:58 +0200
Original-Received: from localhost ([::1]:38854 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1bGA3d-0003gQ-Ek
	for ged-emacs-devel@m.gmane.org; Thu, 23 Jun 2016 15:12:57 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60747)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <rsw@gnu.org>)
	id 1bGA35-0003gA-Fn
	for emacs-devel@gnu.org; Thu, 23 Jun 2016 15:12:24 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <rsw@gnu.org>) id 1bGA2z-00026U-Be
	for emacs-devel@gnu.org; Thu, 23 Jun 2016 15:12:22 -0400
Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:41997)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <rsw@gnu.org>)
	id 1bGA2z-00026E-8d
	for emacs-devel@gnu.org; Thu, 23 Jun 2016 15:12:17 -0400
Original-Received: from mail-oi0-f41.google.com ([209.85.218.41]:34552)
	by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128)
	(Exim 4.82) (envelope-from <rsw@gnu.org>) id 1bGA2x-0007xz-9b
	for emacs-devel@gnu.org; Thu, 23 Jun 2016 15:12:15 -0400
Original-Received: by mail-oi0-f41.google.com with SMTP id s66so84648059oif.1
	for <emacs-devel@gnu.org>; Thu, 23 Jun 2016 12:12:15 -0700 (PDT)
X-Gm-Message-State: ALyK8tIry/BExbsW/5+bEhXXm5tBSiazZHSRF7aQJNCI1eBjnTYZ3vEQGfjFQC1Whpgz1HZa2r8UPqAnTsfC8A==
X-Received: by 10.202.193.2 with SMTP id r2mr114565oif.32.1466709133466; Thu,
	23 Jun 2016 12:12:13 -0700 (PDT)
Original-Received: by 10.202.212.143 with HTTP; Thu, 23 Jun 2016 12:11:44 -0700 (PDT)
In-Reply-To: <576C2FE4.5000705@gmail.com>
X-Gmail-Original-Message-ID: <CA+OMD9jmxN03NjR9cSuXObmqOhTPv6MqgF6=tm_s14cPuOzvGg@mail.gmail.com>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-devel/>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Original-Sender: "Emacs-devel" <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.devel:204703
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/204703>

--001a113d6c5ee3a5810535f6d4b7
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On Thu, Jun 23, 2016 at 2:52 PM, Cl=C3=A9ment Pit--Claudel <clement.pit@gma=
il.com
> wrote:

> On 2016-06-23 14:46, Robert Weiner wrote:
> > On Thu, Jun 23, 2016 at 2:29 PM, Cl=C3=A9ment Pit--Claudel <
> clement.pit@gmail.com <mailto:clement.pit@gmail.com>> wrote:
> >
> >     =E2=80=98C-M-q=E2=80=99 (prog-indent-sexp)
> >           Indent the expression after point.
> >
> > One small formatting suggestion is to surround the key sequences
> > with curly braces, {C-M-q}.
>


> Thanks! Isn't the convention to surround them in `single quotes' (which
> get translated into =E2=80=98curly quotes=E2=80=99), though?
>

=E2=80=8BI just find that quotes are not unique enough and do not set off k=
ey
bindings from other quoted items well.  Curly braces seem to do a better
job, that is all.
=E2=80=8B


> By invoke the keybinding, do you mean browse to the source, or run the
> associated command? The latter would be undesirable, since most of these
> commands are going to be context-sensitive.
>

=E2=80=8BYou could make them do whatever you want.  The default is to invok=
e the
key binding when one mouse button is pressed (shift-mouse2) and to show the
key binding's full documentation =E2=80=8Bwhen shift-mouse3 is pressed.  If=
 a key
binding is not useful within the current buffer, simply don't select it for
execution.

And I like your idea.  You could also consider the formatting and
hyperlinking from M-x apropos as a reference point.

Bob

--001a113d6c5ee3a5810535f6d4b7
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div class=3D"gmail_extra"><div class=3D"gmail_quote">On T=
hu, Jun 23, 2016 at 2:52 PM, Cl=C3=A9ment Pit--Claudel <span dir=3D"ltr">&l=
t;<a href=3D"mailto:clement.pit@gmail.com" target=3D"_blank">clement.pit@gm=
ail.com</a>&gt;</span> wrote:<br><blockquote class=3D"gmail_quote" style=3D=
"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 2016-06-=
23 14:46, Robert Weiner wrote:<br>
<span class=3D"">&gt; On Thu, Jun 23, 2016 at 2:29 PM, Cl=C3=A9ment Pit--Cl=
audel &lt;<a href=3D"mailto:clement.pit@gmail.com">clement.pit@gmail.com</a=
> &lt;mailto:<a href=3D"mailto:clement.pit@gmail.com">clement.pit@gmail.com=
</a>&gt;&gt; wrote:<br>
&gt;<br>
&gt;=C2=A0 =C2=A0 =C2=A0=E2=80=98C-M-q=E2=80=99 (prog-indent-sexp)<br>
&gt;=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0Indent the expression after po=
int.<br>
&gt;<br>
&gt; One small formatting suggestion is to surround the key sequences<br>
&gt; with curly braces, {C-M-q}.=C2=A0<br></span></blockquote><div>=C2=A0</=
div><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-lef=
t:1px #ccc solid;padding-left:1ex"><span class=3D"">
</span>Thanks! Isn&#39;t the convention to surround them in `single quotes&=
#39; (which get translated into =E2=80=98curly quotes=E2=80=99), though?<br=
></blockquote><div><br></div><div><div class=3D"gmail_default" style=3D"fon=
t-family:monospace,monospace;display:inline">=E2=80=8BI just find that quot=
es are not unique enough and do not set off key bindings from other quoted =
items well.=C2=A0 Curly braces seem to do a better job, that is all.</div><=
/div><div><div class=3D"gmail_default" style=3D"font-family:monospace,monos=
pace;display:inline">=E2=80=8B</div>=C2=A0</div><blockquote class=3D"gmail_=
quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1=
ex">
By invoke the keybinding, do you mean browse to the source, or run the asso=
ciated command? The latter would be undesirable, since most of these comman=
ds are going to be context-sensitive.<br></blockquote><div><br></div><div><=
div class=3D"gmail_default" style=3D"font-family:monospace,monospace;displa=
y:inline">=E2=80=8BYou could make them do whatever you want.=C2=A0 The defa=
ult is to invoke the key binding when one mouse button is pressed (shift-mo=
use2) and to show the key binding&#39;s full documentation =E2=80=8Bwhen sh=
ift-mouse3 is pressed.=C2=A0 If a key binding is not useful within the curr=
ent buffer, simply don&#39;t select it for execution.</div></div><div><div =
class=3D"gmail_default" style=3D"font-family:monospace,monospace;display:in=
line"><br></div></div><div><div class=3D"gmail_default" style=3D"font-famil=
y:monospace,monospace;display:inline">And I like your idea.=C2=A0 You could=
 also consider the formatting and hyperlinking from M-x apropos as a refere=
nce point.</div></div><div><div class=3D"gmail_default" style=3D"font-famil=
y:monospace,monospace;display:inline"><br></div></div><div><div class=3D"gm=
ail_default" style=3D"font-family:monospace,monospace;display:inline">Bob</=
div></div><div><br></div></div></div></div>

--001a113d6c5ee3a5810535f6d4b7--