Emacs: Make elisp-index-search use Current Symbol
Emacs's elisp-index-search
command does not use the current symbol when called. This page shows code that fixes that, and also offer some other suggestions.
In emacs, you can press Ctrl+h f to see any emacs lisp function's doc string, and if the cursor is on a function, it defaults to lookup that function. This integrated facility is extremely convenient. However, some improvement can be made. Here are some suggestions:
- ① Make
elisp-index-search
's default prompt to be the word under cursor. This seems useful and consistent with other emacs lookup commands. - ② Make
describe-function
's result display a link to the elisp manual's node on that function. - ③ Make
describe-function
's result display related functions as in “See also: …” - ④ Extend
describe-function
so that it is not just for emacs lisp, but for any language as determined by the current mode.
Make elisp-index-search prompt Default to Current Symbol
Kevin Rodgers and others have suggested implementations. (Source groups.google.com) Here's one that works for me:
;; Kevin Rodgers [kevin.d.rodg…@gmail.com], 2008-10-09 (defadvice elisp-index-search (before interactive-default activate) "Provide the symbol at point as the default when reading TOPIC interactively." (interactive (let ((symbol-at-point (thing-at-point 'symbol))) (list (read-string (if symbol-at-point (format "Topic (%s): " symbol-at-point) (format "Topic: ")) nil nil symbol-at-point)))))
Link to Emacs Manual
Showing a link to elisp manual of pertinent page would be convenient. Because sometimes doc string is not detailed enough or doesn't provide context.
Link to Related Functions
Listing similar functions is a practical need. For example:
search-forward
-
See also:
search-forward-regexp
,skip-chars-forward
,looking-at
. find-file
-
See also:
with-temp-buffer
,with-temp-file
. mapcar
-
See also:
mapc
. beginning-of-line
-
See also:
line-beginning-position
,move-beginning-of-line
,previous-line
.
Listing related functions in a function's doc is in many programing lang manuals. e.g Mathematica, Microsoft's JScript, PHP. They are quite useful. Because, for those who are not yet expert of a language (which is majority), often they do not know similar functions or do not know if there's manual page that list such, and often are confused about the differences of many functions that seem the same. By providing a list of similar functions, a coder can easily locate the right function he need.
Note: some of the above suggestions are reported to emacs dev as bugs: bug#575, bug#1119.
Make describe-function Work for All Popular Languages
Extend describe-function
to other languages than emacs lisp, would be a major improvement. For example, in Perl, to lookup a function, i have to type
Meta+! perldoc -f function_name Enter. To look up a function while coding in Python, i typically have to switch to shell, start Python interactive interpreter, type “help()” then the function's name. To lookup PHP keywords, i have to switch to browser then type “http://php.net/keyword”. Emacs can automate all these. When describe-function
is called, it can simply check the value of “major-mode” local variable to determine the current language, then, switch to web browser with a appropriate URL for that function's doc. If the language's documentation does provide a info
format, then the integration would be seamless.
(for a proof of concept, see:
Emacs: Lookup Google, Dictionary, Documentation.)
Emacs Modernization
- Simple Changes Emacs Should Adopt
- Why Emacs Keys are Painful
- Ban Scratch Buffer
- M-x vs Alt+x Notation
- Menu Idiocy
- Mode Line Problem
- cua-mode Problem
- Inconsistency of Search
- grep in emacs Pain
- Problems of describe-mode
- Problems of Emacs Manual
- Emacs Manual Sucks by Examples
- kill-buffer Problem
- Emacs Spell Checker Pain
- Form Feed ^L
- Single Key Delete Whole Line
- Emacs HTML Mode Sucks
- Emacs No View Image on Windows
- HTML should replace Texinfo
- Support HTML Mail
- Problems of “man”
- Emacs Lisp Mode Syntax Coloring Problem
- Emacs AHK Mode Problems
- Ban Syntax Table
- Make elisp-index-search use Current Symbol
- Texinfo Invalid HTML
- Disappearing FSF URLs, 2006
- Emacs Manual Node Persistency Issues
- Emacs: dired-do-query-replace-regex Replace ALL (fixed)
- Problems of Emacs Supporting Obsolete Systems
- Elisp: Function to Copy/Delete a Dir Recursively (fixed)
- CommonLisp/SchemeLisp Emacs
- Text Editors Popularity
- Cursor Movement Behavior Survey
- Letter-Case Commands Problem
- Select Line/Block/Quote, Extend
- isearch Current Word
- Reformat Line Wrap