home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / info / document / jargon / readme < prev    next >
Encoding:
Text File  |  1992-04-27  |  4.5 KB  |  117 lines
  1.  Notes on the OS/2 .INF Rendering of the Jargon File 
  2.  Neal Bridges, April 1992 
  3.  
  4.  Personal Notes 
  5.  ==============
  6.  I created this .INF rendering of the Jargon File in April, 1992 as part of an 
  7.  effort to familiarize myself with GNU AWK and the OS/2 IPF compiler. 
  8.  
  9.  Please send any comments, etc. to:
  10.  
  11.          Neal Bridges 
  12.          72441.2223@compuserve.com
  13.          (416) 864-9247
  14.  
  15.  Standard Disclaimer 
  16.  ===================
  17.  I disclaim all responsibility for damages caused by the use of these files 
  18.  or the information contained therein. 
  19.  
  20.  About This Package 
  21.  ==================
  22.  The source document for these .INF files was the ASCII version of the 
  23.  Jargon File version 2.9.9, massaged via GNU OS/2 AWK version 2.11, and 
  24.  compiled to four interdependent .INF files with the OS/2 Information 
  25.  Presentation Facility Compiler (IPFC) version 2.0.  It has been tested under 
  26.  OS/2 version 2.0 GA, and OS/2 1.3, and should work (according to IBM's 
  27.  docs) under any version of OS/2 supporting the VIEW utility. 
  28.  
  29.  This package is hereby released into the public domain.  Kindly don't sell 
  30.  it, and be sure not to pay for it. 
  31.  
  32.  This is the complete list of the files you should have: 
  33.  
  34.          README          ; this text
  35.          INT299.INF      ; the Jargon File introduction
  36.          1VOL299.INF     ; Lexicon entries from A to M
  37.          2VOL299.INF     ; Lexicon entries from N to [^A-Za-z]
  38.          APP299.INF      ; the Jargon File appendices
  39.  
  40.  Caution:   Feel free distribute these files, but please distribute them 
  41.             together. They are interdependent, and any missing files will 
  42.             result in various hypertext links not functioning. 
  43.  
  44.   (If you're wondering why there isn't just one big .INF file, it's because 
  45.   IPFC 2.0 has certain limitations, one of which is the inability to deal with 
  46.   input files having more than 16,000 unique words.  To accomodate it, I 
  47.   had to break the file into four parts.) 
  48.  
  49.   All of these files should be put in one directory (e.g. C:\OS2\BOOK (the 
  50.   default .INF directory) or C:\JARGON (or another name of your own 
  51.   choosing)). The Jargon File will (just) fit on a 1.2M or 1.44M floppy disk.  
  52.   Hard drive installation is recommended for speed, but the giantish size of 
  53.   these .INF files may well dictate floppy storage. 
  54.  
  55.   Hard Drives Only:  If (and only if) you have chosen hard drive 
  56.                      installation, the directory containing the .INF files 
  57.                      should then be added to the SET BOOK= line  in 
  58.                      your CONFIG.SYS, for example: 
  59.  
  60.                              SET BOOK=C:\OS2\BOOK;C:\JARGON
  61.                      
  62.                      The system will need to be shut down and restarted 
  63.                      for this change to take effect.
  64.  
  65.   Viewing the Jargon File 
  66.   =======================
  67.   1)  To view the Jargon File, set an OS/2 environment variable (in the 
  68.   CONFIG.SYS or elsewhere), like this:
  69.  
  70.            Hard Drive Installation: 
  71.  
  72.   SET JARGON=INT299.INF+1VOL299.INF+2VOL299.INF+APP299.INF
  73.  
  74.            Floppy Drive Installation: 
  75.  
  76.   SET JARGON=A:\INT299.INF+A:\1VOL299.INF+A:\2VOL299.INF+A:\APP299.INF
  77.  
  78.   (note that the .INF extensions are required).  Then (from an OS/2 
  79.   Command Prompt) use the command: 
  80.  
  81.           VIEW JARGON
  82.   
  83.   to view the complete document. 
  84.  
  85.   2)  Alternatively, from an OS/2 Command Prompt, type: 
  86.  
  87.           VIEW INT299+1VOL299+2VOL299+APP299
  88.   
  89.   Of the two methods, 1) is (IMHO) by far the most convenient. 
  90.  
  91.   Note:  If you view only one of these sections (for example, 1VOL299.INF), 
  92.          double-clicking on a hypertext link to an entry not contained in that 
  93.          section will result in an "IPF: Link not found" popup message.  
  94.          This is because all four .INF sections of the File have hypertext 
  95.          links into the other three.  For all the hypertext links to work, the 
  96.          entire book must be viewed as per 1) or 2) above.
  97.  
  98.   Finding An Jargon File Entry 
  99.   ============================
  100.   There are two ways to find a Jargon File entry. 
  101.   
  102.   Slow
  103.   ----  
  104.   Let's suppose you want to view the entry for "GNU".  You would open the 
  105.   Jargon File, expand the branch "A-M", then expand the sub-branch "G to 
  106.   Gweep", and then double-click on "GNU". 
  107.   
  108.   Fast
  109.   ----
  110.   Assuming you have installed the Jargon File according to method 1) 
  111.   above, simply type (from an OS/2 Command Prompt): 
  112.  
  113.           VIEW JARGON GNU
  114.   
  115.   Happy Jargon File browsing! 
  116.  
  117.