[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:
- Re: lynx-dev info pages, (continued)
- Re: lynx-dev info pages, Philip Webb, 1999/01/26
- Re: lynx-dev info pages, Collin Forbes, 1999/01/27
- Re: lynx-dev info pages, C.J.LAWSON, 1999/01/27
- Re: lynx-dev info pages, brian j. pardy, 1999/01/27
- Re: lynx-dev info pages, Klaus Weide, 1999/01/27
- Re: lynx-dev info pages, brian j. pardy, 1999/01/27
- Re: lynx-dev info pages, Klaus Weide, 1999/01/27
- Re: lynx-dev info pages, brian j. pardy, 1999/01/27
- lynx-dev stuff like converters, filters (was Re: info pages), Klaus Weide, 1999/01/27
- Re: lynx-dev stuff like converters, filters (was Re: info pages), brian j. pardy, 1999/01/28
Re: lynx-dev info pages,
David Combs <=
Re: lynx-dev info pages, Henry Nelson, 1999/01/27