lynx-dev
[Top][All Lists]
Advanced
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: lynx-dev info pages

From: David Combs
Subject: Re: lynx-dev info pages
Date: Wed, 27 Jan 1999 09:26:31 -0800 (PST) 
> From address@hidden Wed Jan 27 01:35:12 1999
> X-Authentication-Warning: satellite.misc.org: collinf owned process doing -bs
> Date: Wed, 27 Jan 1999 01:31:37 -0800 (PST)
> From: Collin Forbes <address@hidden>
> 
> On Tue, 26 Jan 1999, Jason Price wrote:
> 
> > I was ranting at Stallman today, wilst trying to read the info
> > documentation for mysql.  And I was wishing that he had made it as easy and
> > intuitive as lynx was. 
> 
> There exists a info->html converter in the form of a short perl script.
> 
>       http://www.freebsd.org/~wosch/src/info2html-1.1.tar.gz
> 
> 
> <html><head><title>.signature</title></head>
> <body><h1> Collin Forbes </h1></body></html>
> 
> 

Actually, "info" is REALLY cool.  You read info-type stuff via the
gnu program "info", OR via emacs.  It is like html in a way, with
links to other "pages" in the info files.

Here is my own doc on info, grabbed from their doc on it:


info:::   (also see just below, "texinfo   makeinfo")
info:  m
info:  f  f to "FOLLOW a ref" eg   *Note Cross: Help-Cross.  f?  lists'em.
info: 
info: 
info: 
info: 
info: 
info: 
info: simple keying "h"  --> the main HELP node.
info: n=next, p=prev, u=up
info: 
info: 
info: TAB               Info-next-reference
info: RET               Info-next-preorder
info: SPC               Info-scroll-up
info: ,         Info-index-next
info: 1 .. 9            Info-nth-menu-item
info: <         Info-top-node
info: >         Info-final-node
info: ?         Info-summary
info: [         Info-backward-node
info: ]         Info-forward-node
info: d         Info-directory
info: e         Info-edit
info: f         Info-follow-reference
info: g         Info-goto-node
info: h         Info-help
info: i         Info-index    <<<==== NEAT!
info: l         Info-last
info: m         Info-menu
info: n         Info-next
info: p         Info-prev
info: q         Info-exit
info: s         Info-search
info: t         Info-top-node
info: u         Info-up
info: DEL               Info-scroll-down
info: mouse-2           Info-follow-nearest-node
info: ESC TAB           Info-prev-reference
info: C-h C-k           Info-goto-emacs-key-command-node
info: C-h C-f           Info-goto-emacs-command-node
info: C-h i             info
info: menu-bar help info info
info: C-down-mouse-2 manuals i info
info: 
info:
info: ---------------------------- setup:::
info: 
info: Info knows what infos exist, and where they are, are via one OR
info: MORE "dir" files (files having the EXACT FILENAME "dir"), eg:
info: 
info:   This is the "dir" file that makes emacs-INFO work for THIS 
info-directory.
info:   
info:   File: dir       Node: Top
info: 
info:   * Menu: The following info topics are currently available.
info: 
info:   * diff: (diff.info).   (/opt/gnu/diffutils-2.7/info/dir)
info:   * foo: (foo.info).   (/opt/gnu/foo-2.8.1/info/dir)
info:   ...
info: 
info: Each program with .info-files needs a dir file, in the SAME dir
info: where the actual .info-files live.  If several "sets" of info-files
info: live in one dir (as with diffutils
info: 
info: Here is the MAIN dir file (/opt/gnu/emacs-19.34/info/dir)::
info:   
info: ------- (START of that info-file):  
info:   This is the file .../info/dir, which contains the topmost node of the
info:     Info hierarchy.  The first time you invoke Info you start off
info:     looking at that node, which is (dir)Top.
info:   
info:   When you (dkc) run info, the *info* buffer will show FIRST the below
info:     EXPLICITLY-LISTED info menu-items.
info:   
info:   They will be FOLLOWED by the ones EMACS finds VIA its
info:     "Info-default-directory-list", which I append to via this form
info:      IN MY ".emacs" FILE:
info:   
info:   (setq Info-default-directory-list
info:         (append   '(
info:                     "/usr/local/info/" 
info:                     "/usr/local/lib/info/"
info:                     "/var/gnu/FSFgcc/info/" 
info:                     "/var/gnu/FSFgmake/info/"
info:                     "/var/gnu/FSFtexi/info/"
info:                     
"/var/from_netcom-dir2/perl-stuff/perl-info.5.004/info/"
info:                     "/opt/gnu/diffutils-2.7/info/"
info:                     
"/var/from_netcom-dir2/sources-stuff/texinfo-3.11/doc/"
info:                     
"/home/product/from_netcom-dir1/emacs-stuff/elisp-manual-19-2.4.2/"
info:                   )
info:                 Info-default-directory-list))
info:   
info:   
info:   
info:   
info:   
info:   File: dir       Node: Top       This is the top of the INFO tree
info:     This (the Directory node) gives a menu of major topics. 
info:     Typing "d" returns here, "q" exits, "?" lists all INFO commands, "h" 
info:     gives a primer for first-timers, "mEmacs<Return>" visits the Emacs 
topic,
info:     etc.
info:     In Emacs, you can click mouse button 2 on a menu item or cross 
reference
info:     to select it.
info:     --- PLEASE ADD DOCUMENTATION TO THIS TREE. (See INFO topic first.) ---
info:   
info:   * Menu: The list of major topics begins on the next line. (THIS 
dir-file is in /opt/gnu/emacs-19.34/info/).
info:   
info:   * Info: (info).         Documentation browsing system.
info:   * Emacs: (emacs).       The extensible self-documenting text editor 
(19.34).
info:                            (/opt/gnu/emacs-19.34/info/dir)
info:   * VIP: (vip).           A VI-emulation for Emacs.
info:   * VIPER: (viper).       The new VI-emulation mode in Emacs-19.29.
info:   * Forms: (forms).       Emacs package for editing data bases
info:                             by filling in forms.
info:   * GNUS: (gnus).         The news reader GNUS.
info:   * MH-E: (mh-e).         Emacs interface to the MH mail system.
info:   * CL: (cl).             Partial Common Lisp support for Emacs Lisp.
info:   * SC: (sc).             Supercite lets you cite parts of messages 
you're 
info:                             replying to, in flexible ways.
info:   * Dired-X: (dired-x).   Dired Extra Features.
info:   * Ediff: (ediff).       A comprehensive visual interface to diff & 
patch.
info:   * CC mode: (ccmode).    The GNU Emacs mode for editing C, C++, 
Objective-C
info:                             and Java code.
info: ------ (END of that info-file).
info: 
info: 
info: How emacs FINDS the dir-files::
info: The search path for Info files EVENTUALLY gets into the var
info: `Info-directory-list' (but YOU create `Info-default-directory-list').
info: 
info: Emacs auto-builds the TOP-LEVEL Info directory by COMBINING any
info: file named `dir' found WITHIN the directories IN that path.
info: 
info: (see loaddefs.el)
info: 
info: How to get (emacs-)info to know about a program's info-stuff:
info: 
info: 1: Within that prog's "info"-directory, eg
info: /bar/foo/gnuProg-2.5/info/, create a file named "dir" (that
info: MUST be the exact name!), with contents like this:
info: 
info: 
info: NOTE ABOVE!: the (either relative or full-path) file-name of
info:  the "top" info-file IN this directory MUST be ENCLOSED in "()",
info:  and FOLLOWED by a PERIOD(!!!!!), eg "(/home/foo/bar/)."
info: 
info: (ONLY when read via EMACS, then MORE info-dirs can be included
info:   VIA (eg in .emacs) APPENDING to "Info-default-directory-list").
info: 
info: Now, you CAN read those files via the PROGRAM "info":
info: OR, you do it via EMACS:
info: 
info: 2. Reading "info" VIA the stand-alone PROGRAM "info":
info:    cd to that directory, and simply run the prog "info" (it looks
info:        for a file named "dir", barfs if not there).
info: 
info: 3. Reading "info" VIA EMACS:
info: 
info: In your .emacs, update `Info-default-directory-list' to (also) 
info:       (for dkc, is inside file:  .emacs)
info:    contain the name of the directory that "dir" file is IN, eg:
info:      (setq Info-default-directory-list
info:            (append '("~ralf/info/" "~ralf/info/Elisp/")
info:                 Info-default-directory-list))
info:    (BWR: I believe each dir-name MUST end in a "/" SLASH!)
info: 4: There is ALREADY a "dir" file in "emacs", eg within the "MAIN"
info:       /opt/gnu/emacs-19.34/info/.  When you do "C-h i"
info:    in emacs, you get a *info* filled via THAT "dir" file, 
info:    PLUS, at the bottom, OTHER stuff via Info-default-directory-list.
info: setup:
info: Meanwhile, the REAL "Info-directory-list" got BUILT via 
Info-default-directory-list
info:     + other stuff, and ENDS with that MAIN "info" directory.
info: setup:
info: FOR MORE: read ".../lisp/info.el", re env-var INFOPATH, etc, etc.
info:
reply via email to
[Prev in Thread] Current Thread [Next in Thread]