Emacs: Make elisp-index-search use Current Symbol
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-functionso 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:
find-file→ See also:
mapcar→ See also:
beginning-of-line→ See also:
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
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.)
- Simple Changes Emacs Should Adopt
- Why Emacs Keys are Painful
- Problems of the Scratch Buffer
- M-key Notation vs Alt+key Notation
- Menu Problem
- Mode Line Problem
- cua-mode Problems
- kill-buffer Induces Buffer Accumulation
- Emacs Form Feed ^L
- Inconsistency of Search Features
- Single Key to Delete Whole Line
- Emacs HTML Mode Sucks
- Emacs Does Not Support Viewing Images Files In Windows
- Emacs Spell Checker Problems
- Adopt HTML as Texinfo Replacement
- Support HTML Mail
- Problems of “man” Command
- Emacs Lisp Mode Syntax Coloring Problem
- Emacs Ahk Mode Problems
- Problems of Emacs's Manual
- Problems of Emacs's Manual; Examples
- Emacs: Have You Read Emacs Manual?
- Elisp: Ban Syntax Table
- Emacs: Make elisp-index-search use Current Symbol
- Emacs: Usability Problems of Mode Documentation
- Emacs GNU Texinfo Problems; Invalid HTML
- A Record of Frustration in IT Industry; 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)
- Thoughts on Common Lisp Scheme Lisp Based Emacs
- Text Editors Popularity and Market Research
- Text Editor's Cursor Movement Behavior (emacs, vi, Notepad++)
- GNU Emacs Development Inefficiency
- Emacs Dev Inefficiency and Emacs Web 2.0?
- Letter-Case Commands Usability Problems
- Emacs: Select Line, between Quotes, Extend Selection
- Emacs: isearch Current Word
- Suggestions on Line Wrap Commands
- Emacs: Single Key to Delete Whole Line
- Emacs Undo and Emacs Cult Problem