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>></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"">> On Thu, Jun 23, 2016 at 2:29 PM, Cl=C3=A9ment Pit--Cl= audel <<a href=3D"mailto:clement.pit@gmail.com">clement.pit@gmail.com</a= > <mailto:<a href=3D"mailto:clement.pit@gmail.com">clement.pit@gmail.com= </a>>> wrote:<br> ><br> >=C2=A0 =C2=A0 =C2=A0=E2=80=98C-M-q=E2=80=99 (prog-indent-sexp)<br> >=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0Indent the expression after po= int.<br> ><br> > One small formatting suggestion is to surround the key sequences<br> > 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'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'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.</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--