emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Getting to online manuals from Info [was: On being web-friendly...]


From: Drew Adams
Subject: Getting to online manuals from Info [was: On being web-friendly...]
Date: Sat, 20 Dec 2014 16:29:28 -0800 (PST)

> > 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.
> 
> 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.
> 
> 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.
> 
> It is even more helpful to also to tell them how _they_ can find
> such doc, by *asking Emacs* directly.
> 
> 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.

Attachment: throw-manual-web.el
Description: Binary data


reply via email to

[Prev in Thread] Current Thread [Next in Thread]