From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: Getting to online manuals from Info [was: On being web-friendly...] Date: Sat, 20 Dec 2014 16:29:28 -0800 (PST) Message-ID: <80734d64-18fb-4e5e-b6e4-d7ad73ac76ff@default> References: <20141205123549.GA29331@thyrsus.com> <87mw72lyzs.fsf@earlgrey.lan> <20141205190925.GA5067@thyrsus.com> <20141206061019.GC14890@thyrsus.com> <87r3wdp0r5.fsf@fencepost.gnu.org> <2e3dd70f-e3b7-4fb7-81c2-72331b5bc520@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="__1419121767796263533abhmp0011.oracle.com" X-Trace: ger.gmane.org 1419121806 14840 80.91.229.3 (21 Dec 2014 00:30:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 21 Dec 2014 00:30:06 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 21 01:29:56 2014 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 1Y2UPC-0004eC-5J for ged-emacs-devel@m.gmane.org; Sun, 21 Dec 2014 01:29:54 +0100 Original-Received: from localhost ([::1]:36144 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2UPB-00079x-Cz for ged-emacs-devel@m.gmane.org; Sat, 20 Dec 2014 19:29:53 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51346) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2UOz-00079Z-Oo for emacs-devel@gnu.org; Sat, 20 Dec 2014 19:29:50 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y2UOr-0004pb-1S for emacs-devel@gnu.org; Sat, 20 Dec 2014 19:29:41 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:46525) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2UOq-0004km-R0 for emacs-devel@gnu.org; Sat, 20 Dec 2014 19:29:32 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id sBL0TTIR010875 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 21 Dec 2014 00:29:30 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id sBL0TSA1016943 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sun, 21 Dec 2014 00:29:29 GMT Original-Received: from abhmp0011.oracle.com (abhmp0011.oracle.com [141.146.116.17]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id sBL0TSx2004241 for ; Sun, 21 Dec 2014 00:29:28 GMT In-Reply-To: <2e3dd70f-e3b7-4fb7-81c2-72331b5bc520@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:180410 Archived-At: --__1419121767796263533abhmp0011.oracle.com Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable > > I frequently point people to particular nodes of our online HTML > > manuals that could answer their question. The way I do that is > > to find the information in Info, then copy&paste some recognizably > > unique text phrase into a web search engine, check that the > > reference this turns up is the corresponding online version of > > the Info manual and then post the HTML link. >=20 > Same here. Except I don't bother to search the web. I just go > to the GNU Emacs or Elisp manual on the web (separate HTML page > per node version), search the TOC (first page) for the node name, > and copy the URL of the link to that node. >=20 > I do this often. Instead of just answering questions, it is > most helpful to *point users to the doc*, so they get additional > info and they get the benefit of well thought out presentation. >=20 > It is even more helpful to also to tell them how _they_ can find > such doc, by *asking Emacs* directly. >=20 > Probably what I should do is write an Emacs command that does > all of that from an Info node: grab the URL to that same manual > node on the web. But it's so quick to get it manually that I > haven't bothered, so far. FWIW, attached is simple POC code to do this. It handles only the Emacs and Elisp manuals, but it could be extended to other GNU manuals. (The main use case for me is that expressed above.) Two commands, for use in Info: `Info-url-for-node': Prompts for a node name and returns a URL to that node on line. Interactively, it copies the URL to the `kill-ring'. `Info-goto-node-web': Prompts for a node name and goes to that node on line. --__1419121767796263533abhmp0011.oracle.com Content-Type: application/octet-stream; name="throw-manual-web.el" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="throw-manual-web.el" KGRlZnVuIEluZm8tZ290by1ub2RlLXdlYiAobm9kZSAmb3B0aW9uYWwgZmxpcC1uZXctd2luKQog ICJVc2UgYGJyb3dzZS11cmwnIHRvIGdvIHRvIEluZm8gbm9kZSBOT0RFIHVzaW5nIGEgV2ViIGJy b3dzZXIuCldpdGggYSBwcmVmaXggYXJnLCByZXZlcnNlIHRoZSBlZmZlY3Qgb2Ygb3B0aW9uCm9w dGlvbmBicm93c2UtdXJsLW5ldy13aW5kb3ctZmxhZycuCgpOT0RFIGlzIHRoZSBuYW1lIG9mIGEg bm9kZSBpbiB0aGUgR05VIEVtYWNzIG9yIEVsaXNwIG1hbnVhbC4KQWx0ZXJuYXRpdmVseSwgTk9E RSBjYW4gaGF2ZSB0aGUgZm9ybSAoTUFOVUFMKU5PREUsIHdoZXJlIE1BTlVBTCBpcwpcImVtYWNz XCIgb3IgXCJlbGlzcFwiIGFuZCBOT0RFIGlzIHRoZSBuYW1lIG9mIHRoZSBub2RlIGluIHRoYXQK bWFudWFsLiAgRW1wdHkgTk9ERSBpbiAoTUFOVUFMKSBkZWZhdWx0cyB0byB0aGUgYFRvcCcgbm9k ZS4iCiAgKGludGVyYWN0aXZlIChsaXN0IChJbmZvLXJlYWQtbm9kZS1uYW1lICJHbyB0byBub2Rl OiAiKSBjdXJyZW50LXByZWZpeC1hcmcpKQogIDs7IChpbmZvLWluaXRpYWxpemUpCiAgKHVubGVz cyBJbmZvLWN1cnJlbnQtZmlsZSAoZXJyb3IgIlRoaXMgY29tbWFuZCBtdXN0IGJlIGludm9rZWQg ZnJvbSBJbmZvIikpCiAgKGJyb3dzZS11cmwgKEluZm8tdXJsLWZvci1ub2RlIG5vZGUpIChsaXN0 IChpZiBmbGlwLW5ldy13aW4KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgIChub3QgYnJvd3NlLXVybC1uZXctd2luZG93LWZsYWcpCiAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgYnJvd3NlLXVybC1uZXctd2luZG93LWZs YWcpKSkpCgooZGVmdW4gSW5mby11cmwtZm9yLW5vZGUgKG5vZGUgJm9wdGlvbmFsIGNvcHktYXMt a2lsbCkKICAiUmV0dXJuIGEgVVJMIGZvciBOT0RFLCBhIG5vZGUgaW4gdGhlIEdOVSBFbWFjcyBv ciBFbGlzcCBtYW51YWwuCkFsdGVybmF0aXZlbHksIE5PREUgY2FuIGhhdmUgdGhlIGZvcm0gKE1B TlVBTClOT0RFLCB3aGVyZSBNQU5VQUwgaXMKXCJlbWFjc1wiIG9yIFwiZWxpc3BcIiBhbmQgTk9E RSBpcyB0aGUgbmFtZSBvZiB0aGUgbm9kZSBpbiB0aGF0Cm1hbnVhbC4gIEVtcHR5IE5PREUgaW4g KE1BTlVBTCkgZGVmYXVsdHMgdG8gdGhlIGBUb3AnIG5vZGUuCkludGVyYWN0aXZlbHksIHRoZSBV UkwgaXMgY29waWVkIHRvIGBraWxsLXJpbmcnLCBzbyB5b3UgY2FuIHlhbmsgaXQuIgogIChpbnRl cmFjdGl2ZSAobGlzdCAoSW5mby1yZWFkLW5vZGUtbmFtZSAiTm9kZTogIikgJ0NPUFkpKQogICh1 bmxlc3MgSW5mby1jdXJyZW50LWZpbGUgKGVycm9yICJUaGlzIGNvbW1hbmQgbXVzdCBiZSBpbnZv a2VkIGZyb20gSW5mbyIpKQogIChsZXQgKGZpbGUgdXJsKQogICAgKHN0cmluZy1tYXRjaCAiXFxz ICpcXCgoXFxzICpcXChbXlx0KV0qXFwpXFxzICopXFxzICpcXHxcXClcXCguKlxcKSIgbm9kZSkK ICAgIChzZXRxIGZpbGUgIChpZiAoPSAobWF0Y2gtYmVnaW5uaW5nIDEpIChtYXRjaC1lbmQgMSkp ICIiIChtYXRjaC1zdHJpbmcgMiBub2RlKSkKCSAgbm9kZSAgKG1hdGNoLXN0cmluZyAzIG5vZGUp KQogICAgKHdoZW4gKGVxdWFsIG5vZGUgIiIpIChzZXRxIG5vZGUgICJpbmRleCIpKSA7IGBUb3An IG5vZGUuCiAgICAobGV0ICgodHJpbSAgKHN0cmluZy1tYXRjaCAiXFxzICtcXCciIGZpbGUpKSkK ICAgICAgKHdoZW4gdHJpbSAoc2V0cSBmaWxlIChzdWJzdHJpbmcgZmlsZSAwIHRyaW0pKSkpCiAg ICAobGV0ICgodHJpbSAgKHN0cmluZy1tYXRjaCAiXFxzICtcXCciIG5vZGUpKSkKICAgICAgKHdo ZW4gdHJpbSAoc2V0cSBub2RlIChzdWJzdHJpbmcgbm9kZSAwIHRyaW0pKSkpCiAgICAod2hlbiAo ZXF1YWwgZmlsZSAiIikgKHNldHEgZmlsZSAgSW5mby1jdXJyZW50LWZpbGUpKQogICAgKHNldHEg ZmlsZSAgKGZpbGUtbmFtZS1zYW5zLWV4dGVuc2lvbiAoZmlsZS1uYW1lLW5vbmRpcmVjdG9yeSBm aWxlKSkpCiAgICAodW5sZXNzIChtZW1iZXIgZmlsZSAnKCJlbWFjcyIgImVsaXNwIikpCiAgICAg IChlcnJvciAiTWFudWFsIGNhbm5vdCBiZSBgJXMnOyBpdCBjYW4gb25seSBiZSBgZW1hY3MnIG9y IGBlbGlzcCciIGZpbGUpKQogICAgKHNldHEgbm9kZSAgKHJlcGxhY2UtcmVnZXhwLWluLXN0cmlu ZyAiWyBcdF0rIiAiLSIgbm9kZSB0IHQpCiAgICAgICAgICB1cmwgICAgICAgKGNvbmNhdCAiaHR0 cDovL3d3dy5nbnUub3JnL3NvZnR3YXJlL2VtYWNzL21hbnVhbC9odG1sX25vZGUvIgogICAgICAg ICAgICAgICAgICAgICAgICAgICAgZmlsZSAiLyIgbm9kZSAiLmh0bWwiKSkKICAgICh3aGVuIGNv cHktYXMta2lsbCAoa2lsbC1uZXcgdXJsKSAobWVzc2FnZSAiVVJMIGNvcGllZDogJXMiIHVybCkp CiAgICB1cmwpKQo= --__1419121767796263533abhmp0011.oracle.com--