blob: 22e403928dd466a0dc25ad1ddc08fa5c6ba87072 [file] [log] [blame]
Guido van Rossum5dd52d31995-04-10 11:47:11 +00001This directory contains a browser written in Python for "Info files"
2as used by the Emacs documentation system. The browser requires that
3Python is built with the "stdwin" option and runs under X11 or the
4Mac window system.
5
6Now you can read Info files even if you can't spare the memory, time or
7disk space to run Emacs. (I have used this extensively on a Macintosh
8with 1 Megabyte main memory and a 20 Meg harddisk.)
9
10You can give this to someone with great fear of complex computer
11systems, as long as they can use a mouse.
12
13Another reason to use this is to encourage the use of Info for on-line
14documentation of software that is not related to Emacs or GNU.
15(In particular, I plan to redo the Python and STDWIN documentation
16in texinfo.)
17
18The main program is in file "ib.py"; this accepts a file name and a
19node name as optional command line arguments, i.e., its usage is
20
21 python ib.py [file [node]]
22
23
24Configuration:
25
26- The pathname of the directory (or directories) containing
27the standard Info files should be set by editing the
28value assigned to INFOPATH in module ifile.py.
29
30- The default font should be set by editing the value of FONT
31in this module (ibrowse.py).
32
33- For fastest I/O, you may look at BLOCKSIZE and a few other
34constants in ifile.py.