From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?UTF-8?Q?Cl=c3=a9ment_Pit--Claudel?= Newsgroups: gmane.emacs.devel Subject: Re: Improving describe-mode and discoverability Date: Thu, 23 Jun 2016 14:52:20 -0400 Message-ID: <576C2FE4.5000705@gmail.com> References: <576C2A6C.3090908@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="lqwchuSHctbkmwhK3GijGvcbWQPe4O1pF" X-Trace: ger.gmane.org 1466708019 10655 80.91.229.3 (23 Jun 2016 18:53:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 23 Jun 2016 18:53:39 +0000 (UTC) Cc: Emacs developers To: rswgnu@gmail.com Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 23 20:53:24 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 1bG9kY-0002tY-4R for ged-emacs-devel@m.gmane.org; Thu, 23 Jun 2016 20:53:14 +0200 Original-Received: from localhost ([::1]:38765 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bG9kX-0008Tr-BV for ged-emacs-devel@m.gmane.org; Thu, 23 Jun 2016 14:53:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54986) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bG9jp-0008SL-Ce for emacs-devel@gnu.org; Thu, 23 Jun 2016 14:52:30 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bG9jl-0004vu-FH for emacs-devel@gnu.org; Thu, 23 Jun 2016 14:52:29 -0400 Original-Received: from mout.kundenserver.de ([217.72.192.74]:56197) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bG9jl-0004vZ-4n for emacs-devel@gnu.org; Thu, 23 Jun 2016 14:52:25 -0400 Original-Received: from [18.26.2.123] ([18.26.2.123]) by mrelayeu.kundenserver.de (mreue101) with ESMTPSA (Nemesis) id 0MYvrP-1av1wi1qNP-00VhIu; Thu, 23 Jun 2016 20:52:23 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.8.0 In-Reply-To: X-Provags-ID: V03:K0:jRObXHtIOwMfPJ642JJvJdZg06KKk1fvyQaCmNhqamFPG9G/9KS /7/JtHjL6jhWJ+QqyRLy+J0oORU57DecWf2xjPTkHk9/lkeQZzOkgUfo1PdBsjjzRXbQiCu fQn1oJ8X28ch4AgCl3tIGsAISrlppDKOqkAbCFl/Pgf1MhV8vaalpp/rC1RtnsoBybFcjfN oKTDHME7MShs+hA+agoFw== X-UI-Out-Filterresults: notjunk:1;V01:K0:JWkOgE9U7yc=:StdSl42Fz4FDGe1WiTXWXS Tr3kLgL+erTGN4TDMBZ/h80gH7PkvfFIxJ1smVsL8VFvIEB2tAQmQ2bAu4SP3bM1+/DJUbxob nSwP+YEOPo4jn762xlpV3vX1CnkBMR5gyv+oOzCkYaXwO3y7EsJvdTI0pQUPgh5bOFP56LdkU EXBKYNT3zJBG8/Jinwf62TWnK+C+WRCsZBO8e5BKVWd7SQ9qmCDlDDU2RQXIuJ5T34MjbTI90 BUSU7w3NPSKygECEhE1+nysX9cun8OYh0t5lYxzmMLncarAL+bi6hr+YkUozzZdMm5DVLyiIl osYoLtSngpSB90Ym3DCdn4+mspblbbMe497PhZsnCT+2C/W+T19spQlDF8KSjaKFdrGPfpkAG KOrDdIJDpGUxKsVKUwE3tofR21Gb0RoSklB11kI4IyOHj2FksULxWfguLAepSmv6MtI+IfBJj 601lWl64//XkFIvfRTWZ6HhPDNJ9ypA++k1Tul51ND7be8iQy45UG8tk29MPep1v9pzw0KRjY e+bTf7PhKADSIgGE4Or7LzaEj6Nm9DG+FkzqZAOOS6Qo8R9jECjjvyFJCRoN8BJRbQ5xDWzPa jFaRpVfzVGazNg33KSPmSqp4ILZghRCLVH+Sl49dNL1z41yc/yRAWh4DQXDIFp6AmuivRqlVN tPHJMToSCrjxdL3EZ6WHeSvscZIHB/56Xjfn+yq1XPuPzcxq6haCh6CiloWFZyKDVOMk= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 217.72.192.74 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:204702 Archived-At: This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --lqwchuSHctbkmwhK3GijGvcbWQPe4O1pF Content-Type: multipart/mixed; boundary="dtqe2tTpa9QfW3oKV5t8FSaSNxLfgMw4H" From: =?UTF-8?Q?Cl=c3=a9ment_Pit--Claudel?= To: rswgnu@gmail.com Cc: Emacs developers Message-ID: <576C2FE4.5000705@gmail.com> Subject: Re: Improving describe-mode and discoverability References: <576C2A6C.3090908@gmail.com> In-Reply-To: --dtqe2tTpa9QfW3oKV5t8FSaSNxLfgMw4H Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 2016-06-23 14:46, Robert Weiner wrote: > On Thu, Jun 23, 2016 at 2:29 PM, Cl=C3=A9ment Pit--Claudel > wrote: >=20 > =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}. I have been doing this for years and it > makes key sequences appear quite nicely in text. For Hyperbole users, > it has the additional benefit that a mouse click on the key sequence > will invoke its key binding, so you get an implicit hyperbutton for > free. Thanks! Isn't the convention to surround them in `single quotes' (which g= et translated into =E2=80=98curly quotes=E2=80=99), though? By invoke the keybinding, do you mean browse to the source, or run the as= sociated command? The latter would be undesirable, since most of these co= mmands are going to be context-sensitive. Cl=C3=A9ment. --dtqe2tTpa9QfW3oKV5t8FSaSNxLfgMw4H-- --lqwchuSHctbkmwhK3GijGvcbWQPe4O1pF Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (GNU/Linux) iQIcBAEBAgAGBQJXbC/kAAoJEPqg+cTm90wj2tsP/3hCZEyNronrgVfmbVBzvET+ +ChGHo6PVLgR0/bQxkKpvsRShel3p1IPFAQvheGaO1WKIV/JbO8l/IRwpBMr28hM 55q5u8qOJBsi7DtQYHOdcKyEzxZIgwHl0qbWh/2Zmo7p5ORf8P7LvhOj+6xnsvcC kek51/pQgpm0FvjWn1TfaLULRQCxykGJAy/xqAXEWMZK/lirjgNUQRdoZgLtCIIp P+P49GagdLy05loPaBDGTzp40OWz9HSuH4rf/o57JrcryZ6Ml3YNZKu5qAzhsv3R A3TXNVjKPK3UQvXJS9pHh7BiXUM7Ss7O3jTCzbT3wvoc6iW6EwsitZZfvF6qQDe1 MFb5hyYa3EZOnk/F1AcTgjRll+2mDF+vOMF2y6XCY7mVweIaigKTM36P0hv6teHt PS4DresRrhvCPyNQ9EjzHcOXlc6B8Krl9P4QBtZ2URTk2T5o9w7v+WvwuMpnMoAP H+1TbfsO4replNkZ272SLhDOy+bor/vdwnhj1Xa8nVjKlQVha/r1xc3o5snx4NNW eqS2+SAOUbCnhhIWdtS7FoAEvNdfg6IiDBlaFS/a67MJtzET3OzDOQqWexC9YE04 OGxO/Jgb3dMaZ0x0xsSdTjxKAh/rdzQXCKpFqFl+fgkTpVp2H9vNaciwSf34uFRg 7erFJnLvf8JFw7ISkpp0 =/eDi -----END PGP SIGNATURE----- --lqwchuSHctbkmwhK3GijGvcbWQPe4O1pF--