org-info: Try info index if info node is not found
commit96e1971f0fac6db1ac133faab0f7ed3bc38d96e7
authorKim <emacs18@gmail.com>
Sat, 15 Nov 2014 18:37:39 +0000 (15 10:37 -0800)
committerNicolas Goaziou <mail@nicolasgoaziou.fr>
Sat, 15 Nov 2014 23:14:29 +0000 (16 00:14 +0100)
tree653b7a9d1c9055bb300b9fd51b653652e916f451
parent4670b0420cb1487d52ea9eb89a0a25ed48a09046
org-info: Try info index if info node is not found

* lisp/org-info.el (org-info-follow-link): Attempt index lookup if node
  lookup fails.

* doc/org.texi (External links): Update info links.

Info index is almost always finer grain than info nodes.  For example
with this change, [[info:libc#close]] brings up not only
"(libc)Opening and Closing Files" info node, but also place the cursor
on the line that documents "close" function within the node.  This is
done by looking up "close"in the index upon failing to find a node
named "close".  Hence one can now link function, variable and other
names that are in the index rather than being limited to info node
names.  Typically there are far more index items than there are node
names.  For example libc manual has about 700 nodes, but over 4000
concept, type, function, and variables index items.  More examples of
new ways to create links are shown using org.info as example

- [[info:org#org-clock-idle-time]] uses "Variable Index"
- [[info:org#org-capture]] uses "Command and Function Index".
- [[info:org#timestamp]] uses "Main Index"
- [[info:org#C-c C-c]] uses "Key Index"

TINYCHANGE
doc/org.texi
lisp/org-info.el