From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Robert Weiner Newsgroups: gmane.emacs.devel Subject: Re: Improving describe-mode and discoverability Date: Thu, 23 Jun 2016 15:11:44 -0400 Message-ID: References: <576C2A6C.3090908@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 To: =?UTF-8?B?Q2zDqW1lbnQgUGl0LS1DbGF1ZGVs?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 23 21:13:00 2016 Return-path: 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 ; 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: 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:204703 Archived-At: --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 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 > 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
On T= hu, Jun 23, 2016 at 2:52 PM, Cl=C3=A9ment Pit--Claudel &l= t;clement.pit@gm= ail.com> wrote:
On 2016-06-= 23 14:46, Robert Weiner wrote:
> On Thu, Jun 23, 2016 at 2:29 PM, Cl=C3=A9ment Pit--Cl= audel <clement.pit@gmail.com <mailto:clement.pit@gmail.com= >> wrote:
>
>=C2=A0 =C2=A0 =C2=A0=E2=80=98C-M-q=E2=80=99 (prog-indent-sexp)
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0Indent the expression after po= int.
>
> One small formatting suggestion is to surround the key sequences
> with curly braces, {C-M-q}.=C2=A0
=C2=A0
Thanks! Isn't the convention to surround them in `single quotes&= #39; (which get translated into =E2=80=98curly quotes=E2=80=99), though?

=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>
=E2=80=8B
=C2=A0
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.

<= 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'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't select it for execution.

And I like your idea.=C2=A0 You could= also consider the formatting and hyperlinking from M-x apropos as a refere= nce point.

Bob

--001a113d6c5ee3a5810535f6d4b7--