home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 14 Text
/
14-Text.zip
/
JARGON.ZIP
/
README
< prev
Wrap
Text File
|
1992-04-27
|
5KB
|
117 lines
Notes on the OS/2 .INF Rendering of the Jargon File
Neal Bridges, April 1992
Personal Notes
==============
I created this .INF rendering of the Jargon File in April, 1992 as part of an
effort to familiarize myself with GNU AWK and the OS/2 IPF compiler.
Please send any comments, etc. to:
Neal Bridges
72441.2223@compuserve.com
(416) 864-9247
Standard Disclaimer
===================
I disclaim all responsibility for damages caused by the use of these files
or the information contained therein.
About This Package
==================
The source document for these .INF files was the ASCII version of the
Jargon File version 2.9.9, massaged via GNU OS/2 AWK version 2.11, and
compiled to four interdependent .INF files with the OS/2 Information
Presentation Facility Compiler (IPFC) version 2.0. It has been tested under
OS/2 version 2.0 GA, and OS/2 1.3, and should work (according to IBM's
docs) under any version of OS/2 supporting the VIEW utility.
This package is hereby released into the public domain. Kindly don't sell
it, and be sure not to pay for it.
This is the complete list of the files you should have:
README ; this text
INT299.INF ; the Jargon File introduction
1VOL299.INF ; Lexicon entries from A to M
2VOL299.INF ; Lexicon entries from N to [^A-Za-z]
APP299.INF ; the Jargon File appendices
Caution: Feel free distribute these files, but please distribute them
together. They are interdependent, and any missing files will
result in various hypertext links not functioning.
(If you're wondering why there isn't just one big .INF file, it's because
IPFC 2.0 has certain limitations, one of which is the inability to deal with
input files having more than 16,000 unique words. To accomodate it, I
had to break the file into four parts.)
All of these files should be put in one directory (e.g. C:\OS2\BOOK (the
default .INF directory) or C:\JARGON (or another name of your own
choosing)). The Jargon File will (just) fit on a 1.2M or 1.44M floppy disk.
Hard drive installation is recommended for speed, but the giantish size of
these .INF files may well dictate floppy storage.
Hard Drives Only: If (and only if) you have chosen hard drive
installation, the directory containing the .INF files
should then be added to the SET BOOK= line in
your CONFIG.SYS, for example:
SET BOOK=C:\OS2\BOOK;C:\JARGON
The system will need to be shut down and restarted
for this change to take effect.
Viewing the Jargon File
=======================
1) To view the Jargon File, set an OS/2 environment variable (in the
CONFIG.SYS or elsewhere), like this:
Hard Drive Installation:
SET JARGON=INT299.INF+1VOL299.INF+2VOL299.INF+APP299.INF
Floppy Drive Installation:
SET JARGON=A:\INT299.INF+A:\1VOL299.INF+A:\2VOL299.INF+A:\APP299.INF
(note that the .INF extensions are required). Then (from an OS/2
Command Prompt) use the command:
VIEW JARGON
to view the complete document.
2) Alternatively, from an OS/2 Command Prompt, type:
VIEW INT299+1VOL299+2VOL299+APP299
Of the two methods, 1) is (IMHO) by far the most convenient.
Note: If you view only one of these sections (for example, 1VOL299.INF),
double-clicking on a hypertext link to an entry not contained in that
section will result in an "IPF: Link not found" popup message.
This is because all four .INF sections of the File have hypertext
links into the other three. For all the hypertext links to work, the
entire book must be viewed as per 1) or 2) above.
Finding An Jargon File Entry
============================
There are two ways to find a Jargon File entry.
Slow
----
Let's suppose you want to view the entry for "GNU". You would open the
Jargon File, expand the branch "A-M", then expand the sub-branch "G to
Gweep", and then double-click on "GNU".
Fast
----
Assuming you have installed the Jargon File according to method 1)
above, simply type (from an OS/2 Command Prompt):
VIEW JARGON GNU
Happy Jargon File browsing!