all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Virtual Info Help manual
@ 2010-04-16 23:45 Juri Linkov
  0 siblings, 0 replies; only message in thread
From: Juri Linkov @ 2010-04-16 23:45 UTC (permalink / raw)
  To: emacs-devel

[-- Attachment #1: Type: text/plain, Size: 2024 bytes --]

There are two different sources of information about Emacs now:

1. Info manuals
2. Help documentation

They have different UI for the same purpose.

If the online Help documentation were in an Info manual,
that would have several advantages:

1. the same UI for browsing online documentation -
   Info manuals or Help documentation alike.

2. consistent cross references between Info manuals.

   For instance, a cross reference (info "(*Help*) Function car")
   will go to a virtual Info node equivalent to `C-h f car RET'.

   Previously visited cross references will be highlighted
   in a different face.

3. common history

   The `l' command will go back in the history to the last Info node
   with a function's docstring, etc.

4. other rich Info functionality will be available
   for the online Help documentation.

All this is easy to do using virtual Info manuals.

The patch below implements a virtual Info manual *Help*
with the following virtual nodes:

* Top - a menu of top nodes.

* About Emacs - like the About screen (`C-h C-a')
    displays the current version string and some useful links
    to other Emacs manuals.

* Statistics - the memory usage (garbage collection stats, etc.)

* Functions Index - a list of all defined functions

* Functions by Prefix
* Functions by Suffix - a list of functions grouped
    by common prefix/suffux

* Function <name> - like the output of `C-h f'
    with cross references to other Info nodes.

* Variables Index - a list of all defined variables

* Variables by Prefix
* Variables by Suffix - a list of variables grouped
    by common prefix/suffux

* Variable <name> - like the output of `C-h v'
    with cross references to other Info nodes.

* Buffers - a list of buffers

* Buffer <name> - complete information about buffer: name, major mode,
    cross references to nodes of its minor modes and buffer-local
    variables.

* Mule Diagnosis - a menu for all chapters of `describe-*' functions

** Input Methods

** Coding Systems

** Character Sets

...


[-- Attachment #2: info-help.el --]
[-- Type: application/emacs-lisp, Size: 22649 bytes --]

[-- Attachment #3: Type: text/plain, Size: 45 bytes --]


-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2010-04-16 23:45 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-04-16 23:45 Virtual Info Help manual Juri Linkov

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.