home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / readme < prev    next >
Encoding:
Text File  |  1994-05-14  |  21.6 KB  |  468 lines
  1.  
  2.                   BBS/FTP README
  3.  
  4.                  (Updated 5/14/94)
  5.  
  6. --------
  7. OVERVIEW
  8. --------
  9.  
  10. This is the root of a directory tree containing lha archives of material
  11. included elsewhere on this CD-ROM, or from previous CD-ROM's.
  12.  
  13. See the other informational files on this CD-ROM for details about what is
  14. contained in these archives.  This file deals purely with details about how
  15. this CD-ROM might be used in a BBS or FTP environment.  Some of the details
  16. discussed here include:
  17.  
  18.    o    How do I unpack all these *.lha archives.
  19.  
  20.    o    What are all these *.pi (product info) files and why they are
  21.     important.
  22.  
  23.    o    How you can arrange to access the contents of the CD-ROM from
  24.     several different "views" using symbolic links, and what support
  25.     is provided to make this relatively easy to set up.
  26.  
  27.    o    The default alternative "view".
  28.  
  29. ------------
  30. LHA ARCHIVES
  31. ------------
  32.  
  33. Almost all the archives on this CD-ROM are in "lha format".  The shareware
  34. version of lha is included in the Useful/Sys/C directory of this CD-ROM, so
  35. all you have to do to unpack any archive is use a command of the form:
  36.  
  37.     lha -mraxe x archive.lha
  38.  
  39. Please consider registering with the lha author, Stefan Boberg, for the
  40. latest version of lha, so he can continue to support this fine program.
  41.  
  42. ------------------
  43. PRODUCT INFO FILES
  44. ------------------
  45.  
  46. If you have already peeked in some of the directories of this CD-ROM, you
  47. probably noticed that for every archive there is a corresponding file of the
  48. same name with ".pi" appended to the name.  These are "product info" files,
  49. and contain important information about the contents of the archive that
  50. they correspond to.  The current specification for the structure and
  51. contents of these files can be found in the "Product-Infos" file in the
  52. "Information" directory on this CD-ROM, and should continue to be posted
  53. periodically in the usenet news group "comp.sys.amiga.announce" as it
  54. evolves.
  55.  
  56. The product info files are a way to organize lots of information about a
  57. program in an extensible text format that is relatively simple for programs
  58. to parse.  It looks something like:
  59.  
  60.     .name
  61.     myprog
  62.     .fullname
  63.     My smart little program
  64.     .version
  65.     1.4
  66.     .short
  67.     Computes winning horse, 100% accurate.
  68.     .author
  69.     Me
  70.     .address
  71.     123 Somestreet
  72.     Anywhere, USA
  73.  
  74. Aside from the information about where to find an archive (implied by the
  75. location of the corresponding product info file), two other very important
  76. pieces of information that are included in these product info files are the
  77. version number (if known) and a 40 character or less short description of
  78. what is contained in each archive.
  79.  
  80. When used in a BBS or FTP environment the pieces of information that are
  81. usually desirable to have include:
  82.  
  83.    o    Name of the archive.
  84.    o    Location of the archive (where BBS software can find archive)
  85.    o    Version number of the material in the archive.
  86.    o    Size of the archive.
  87.    o    Date of release of the material in the archive.
  88.  
  89. A common way of making this information available to the BBS sysop, and
  90. ultimately the BBS software, is to build a "files.bbs" file in each
  91. directory where the files are found, or possibly in a separate directory,
  92. depending upon the BBS software.  These files are typically fixed field
  93. width files with one line per archive, and look something like:
  94.  
  95.    foo1.4.lha        103200 04-Jan-94 Do the dishes, watch TV
  96.    bar34.lha         33567 11-Mar-94 Take out the trash, eat dinner
  97.  
  98. One major problem is that no two BBS systems seem to agree on the exact
  99. format of this file, and from what information I've been able to obtain,
  100. generally have rigid requirements for exactly where each field must be, how
  101. big it must be, and what it's format must be.
  102.  
  103. Rather than attempt to include direct support for one or more different BBS
  104. systems, in a variety of different formats, I've elected to provide some
  105. simple tools that BBS operators can use to build their own information files
  106. in whatever format the BBS requires.  This is where the product info files
  107. come in.
  108.  
  109. The directory "Tools/PItools" contains several small tools for manipulating
  110. product info files.  The most important of these is "pitool", which can walk
  111. the entire directory tree of the CD-ROM and perform a number of different
  112. operations on the product info files that it finds.  One thing it can do is
  113. to print a one line entry to it's standard output stream for each product
  114. info file that it processes, and format this field according to a specifier
  115. string that looks a lot like a typical C "printf" style string.
  116.  
  117. The following example prints the file's "basename" in a left justified 24
  118. character wide field, followed by a space, followed by the contents of the
  119. ".short" field in a left justified 40 character wide field, and finally, a
  120. newline character:
  121.  
  122.     pitool -b -F "%-24B %-40S\n" -f - /FrozenFish-Apr94/BBS/ALib/d9xx/d950
  123.  
  124.     BBDoors.lha              rexxDoors for BBBBS, V6.5               
  125.     BusyPointers.lha         'NickPrefs' busy pointers collection.   
  126.     ClockTool.lha            Manipulate battery and/or system clocks 
  127.     Enforcer.lha             Tool to monitor illegal memory access.  
  128.     PayAdvice.lha            Pay analysis program.                   
  129.     Sushi.lha                Intercept Enforcer raw serial output.   
  130.     bbsQUICK.lha             bbsQUICK offline module for BBBBS, V6.4 
  131.     Disk950.lha              Library admin files for disk 950.       
  132.  
  133. This example prints the file "basename" in a right justified 24 character
  134. wide field, followed by a space, followed by the complete pathname to that
  135. file in a field of unlimited length, and then a newline character:
  136.  
  137.     pitool -b -F "%24B %P\n" -f - /cdrom/BBS/ALib/d9xx/d950
  138.  
  139.                  BBDoors.lha cdrom:BBS/ALib/d9xx/d950/BBDoors.lha
  140.             BusyPointers.lha cdrom:BBS/ALib/d9xx/d950/BusyPointers.lha
  141.                ClockTool.lha cdrom:BBS/ALib/d9xx/d950/ClockTool.lha
  142.                 Enforcer.lha cdrom:BBS/ALib/d9xx/d950/Enforcer.lha
  143.                PayAdvice.lha cdrom:BBS/ALib/d9xx/d950/PayAdvice.lha
  144.                    Sushi.lha cdrom:BBS/ALib/d9xx/d950/Sushi.lha
  145.                 bbsQUICK.lha cdrom:BBS/ALib/d9xx/d950/bbsQUICK.lha
  146.                  Disk950.lha cdrom:BBS/ALib/d9xx/d950/Disk950.lha
  147.  
  148. This example prints the file "basename" in a left justfied 20 character
  149. wide field, followed by a space, the version number in a right justified 6
  150. character wide field, followed by another space, the size of the archive in
  151. Kb in a 3 character wide right justified field, followed immediately by the
  152. literal string "Kb => ", followed by the directory in which the file is
  153. stored in a field of unlimited length, followed by a newline:
  154.  
  155.     pitool -b -F "%-20B %6V %3KKb => %D\n" -f - /cdrom/BBS/ALib/d9xx/d950
  156.  
  157.     BBDoors.lha             6.5 187Kb => cdrom:BBS/ALib/d9xx/d950/
  158.     BusyPointers.lha        ?.?  11Kb => cdrom:BBS/ALib/d9xx/d950/
  159.     ClockTool.lha           1.0  26Kb => cdrom:BBS/ALib/d9xx/d950/
  160.     Enforcer.lha          37.55  66Kb => cdrom:BBS/ALib/d9xx/d950/
  161.     PayAdvice.lha          3.00  52Kb => cdrom:BBS/ALib/d9xx/d950/
  162.     Sushi.lha             37.10  14Kb => cdrom:BBS/ALib/d9xx/d950/
  163.     bbsQUICK.lha            6.4  26Kb => cdrom:BBS/ALib/d9xx/d950/
  164.     Disk950.lha             ?.?  23Kb => cdrom:BBS/ALib/d9xx/d950/
  165.  
  166. The source to this utility is provided in case any further customizations
  167. are needed, however it is currently only compiled and tested with the GNU
  168. compiler.  The GNU compiler is included in ready to run form under the GNU
  169. directory, and in archived form under the BBS/GNU directory.
  170.  
  171. --------------------
  172. USING SYMBOLIC LINKS
  173. --------------------
  174.  
  175. I have included some tools and scripts that will allow the contents of the
  176. CD-ROM to be presented with any arbitrary organization, by using the
  177. "symbolic link" feature built into Kickstart 2.04 or later.  The same
  178. techniques will also work for people that want to access this CD-ROM on Unix
  179. systems that support symbolic links.
  180.  
  181.                  == DISCLAIMER ==
  182.  
  183.     Symbolic links are a new feature in AmigaDOS, and have probably
  184.     not had a lot of testing, as is evident from the fact that most of
  185.     the currently available standard Commodore utilities don't fully
  186.     support them.  If you munge your hard drive, create files that are
  187.     hard to delete, create file trees that cause your backup utility
  188.     to choke, or otherwise scramble your disks, I am NOT RESPONSIBLE.
  189.     I strongly suggest that you first experiment with these techniques
  190.     in a separate scratch partition or on a floppy disk, so that the
  191.     partition or floppy can simply be reformatted to remove all traces
  192.     of the links.
  193.  
  194. Basically, a symbolic link is a file that contains the name of another file,
  195. where the actual file contents are to be found.  For example, the notation:
  196.  
  197.     file1  ->  file2
  198.  
  199. means that "file1" is a symbolic link containing the string "file2", and the
  200. actual file contents are in "file2".  When the system opens "file1", it
  201. arranges that any attempt to read/write "file1" actually reads/writes
  202. "file2".
  203.  
  204. The useful feature of symbolic links is that "file1" can be a file on either
  205. your hard drive or a floppy disk, and "file2" can be a file on the CD-ROM.
  206. Since you are able to create a directory tree of links using any
  207. organization you like, you can effectively reorganize the contents of the
  208. CD-ROM without actually changing it in any way.  You are simply changing
  209. your effective view of it.  You can have as many effective views as you want
  210. simultaneously by simply having several different trees of symbolic links.
  211.  
  212. New alternative views can be added at any time.  Plus your view can even
  213. include multiple CD-ROM's or random files that are stored in some other part
  214. of your system.  So when an update is released to some program on the
  215. CD-ROM, it can be added right alongside the older material that is included
  216. on the CD-ROM by simply adding another link.  Nobody but the BBS sysop has
  217. to know where the actual material is stored.
  218.  
  219. ---------------------------
  220. EXAMPLE WITH SYMBOLIC LINKS
  221. ---------------------------
  222.  
  223. Don't be discouraged by the gory details of this example, since the CD-ROM
  224. comes with an archive containing a script and "files.bbs" files that can be
  225. used to set up a default view which divides the CD-ROM up into about 26
  226. different areas, based on alphabetic sorting of the archive names.  So you
  227. shouldn't have to get down to this level unless you want a more custom
  228. setup.
  229.  
  230. As a concrete example, let's assume that we want to create a directory
  231. "sys:bbs/filereaders" that will have all of the text readers that have ever
  232. appeared in the floppy library, and then make the contents of this directory
  233. accessible via the BBS.  We could of course simply copy each of the relevant
  234. archives off the Apr94 FrozenFish CD-ROM into sys:bbs/filereaders, but then
  235. this defeats most of the advantages of having a CD-ROM in the first place,
  236. other than as a distribution medium.
  237.  
  238. We will limit our example to one single text reading program, "MuchMore".
  239. By using "pitool" with the right format as shown below, we can get a list of
  240. the complete pathnames to all files on the CD-ROM for which there is a
  241. product info file, and what their version numbers are.  Then using "grep" on
  242. this list, we can select only those files we are interested in:
  243.  
  244.   cd sys:bbs/filereaders
  245.   pitool -b -f - -F "%P %V\n" >junkfile /FrozenFish-Apr94/BBS/ALib
  246.   grep "MuchMore\.lha" junkfile >muchmorefiles
  247.   cat muchmorefiles
  248.  
  249.   FrozenFish-Apr94:BBS/ALib/d2xx/d234/MuchMore.lha 1.8
  250.   FrozenFish-Apr94:BBS/ALib/d2xx/d253/MuchMore.lha 2.5
  251.   FrozenFish-Apr94:BBS/ALib/d3xx/d378/MuchMore.lha 2.7
  252.   FrozenFish-Apr94:BBS/ALib/d5xx/d560/MuchMore.lha 3.0
  253.   FrozenFish-Apr94:BBS/ALib/d8xx/d895/MuchMore.lha 3.3
  254.   FrozenFish-Apr94:BBS/ALib/d9xx/d935/MuchMore.lha 3.6
  255.   FrozenFish-Apr94:BBS/ALib/d9xx/d962/MuchMore.lha 4.2
  256.  
  257. We now know what the name of each archive is (the last component in the
  258. pathname), where it is stored, and what version number it is.  The next step
  259. is to generate symbolic links in the current directory that point to each
  260. file on the CD-ROM.  I have provided a simple program that does this, called
  261. "symlinks".
  262.  
  263. The symlinks program takes as input a file containing lines in the above
  264. format, and makes links in either the current directory or a directory that
  265. has the same name as the first character of the name of the archive ('m' in
  266. this case).  Because all the archives have the same name, the symlinks
  267. program arranges for each link to have a unique name by included either the
  268. version number or the floppy disk number in the name of the archive.  Since
  269. the version numbers are known for all the files in this example, the version
  270. numbers are given preference.  The symlinks program can either make the
  271. links directly, or emit a script that can be run, possibly after some "hand
  272. tweaking", to generate the links:
  273.  
  274.   symlinks -s <muchmorefiles >execute.me
  275.   cat execute.me
  276.   ln -s FrozenFish-Apr94:BBS/ALib/d2xx/d234/MuchMore.lha MuchMore-1.8.lha
  277.   ln -s FrozenFish-Apr94:BBS/ALib/d2xx/d234/MuchMore.lha.pi MuchMore-1.8.lha.pi
  278.   ln -s FrozenFish-Apr94:BBS/ALib/d2xx/d253/MuchMore.lha MuchMore-2.5.lha
  279.   ln -s FrozenFish-Apr94:BBS/ALib/d2xx/d253/MuchMore.lha.pi MuchMore-2.5.lha.pi
  280.   ln -s FrozenFish-Apr94:BBS/ALib/d3xx/d378/MuchMore.lha MuchMore-2.7.lha
  281.   ln -s FrozenFish-Apr94:BBS/ALib/d3xx/d378/MuchMore.lha.pi MuchMore-2.7.lha.pi
  282.   ln -s FrozenFish-Apr94:BBS/ALib/d5xx/d560/MuchMore.lha MuchMore-3.0.lha
  283.   ln -s FrozenFish-Apr94:BBS/ALib/d5xx/d560/MuchMore.lha.pi MuchMore-3.0.lha.pi
  284.   ln -s FrozenFish-Apr94:BBS/ALib/d8xx/d895/MuchMore.lha MuchMore-3.3.lha
  285.   ln -s FrozenFish-Apr94:BBS/ALib/d8xx/d895/MuchMore.lha.pi MuchMore-3.3.lha.pi
  286.   ln -s FrozenFish-Apr94:BBS/ALib/d9xx/d935/MuchMore.lha MuchMore-3.6.lha
  287.   ln -s FrozenFish-Apr94:BBS/ALib/d9xx/d935/MuchMore.lha.pi MuchMore-3.6.lha.pi
  288.   ln -s FrozenFish-Apr94:BBS/ALib/d9xx/d962/MuchMore.lha MuchMore-4.2.lha
  289.   ln -s FrozenFish-Apr94:BBS/ALib/d9xx/d962/MuchMore.lha.pi MuchMore-4.2.lha.pi
  290.  
  291. Note that this program also arranges for the product info file to be linked
  292. as well.  This is so "pitool" can be used later to automatically build
  293. appropriate description files when run on the tree of symbolic links.  After
  294. that is done, the links to the product info files can be deleted if desired.
  295. After executing the above script, doing an "ls -l" on the directory reveals
  296. the symbolic links (output edited to make it more clear and to fit on 80
  297. char line):
  298.  
  299.   ls -l
  300.   MuchMore-1.8.lha    -> FrozenFish-Apr94:BBS/ALib/d2xx/d234/MuchMore.lha
  301.   MuchMore-1.8.lha.pi -> FrozenFish-Apr94:BBS/ALib/d2xx/d234/MuchMore.lha.pi
  302.   MuchMore-2.5.lha    -> FrozenFish-Apr94:BBS/ALib/d2xx/d253/MuchMore.lha
  303.   MuchMore-2.5.lha.pi -> FrozenFish-Apr94:BBS/ALib/d2xx/d253/MuchMore.lha.pi
  304.   MuchMore-2.7.lha    -> FrozenFish-Apr94:BBS/ALib/d3xx/d378/MuchMore.lha
  305.   MuchMore-2.7.lha.pi -> FrozenFish-Apr94:BBS/ALib/d3xx/d378/MuchMore.lha.pi
  306.   MuchMore-3.0.lha    -> FrozenFish-Apr94:BBS/ALib/d5xx/d560/MuchMore.lha
  307.   MuchMore-3.0.lha.pi -> FrozenFish-Apr94:BBS/ALib/d5xx/d560/MuchMore.lha.pi
  308.   MuchMore-3.3.lha    -> FrozenFish-Apr94:BBS/ALib/d8xx/d895/MuchMore.lha
  309.   MuchMore-3.3.lha.pi -> FrozenFish-Apr94:BBS/ALib/d8xx/d895/MuchMore.lha.pi
  310.   MuchMore-3.6.lha    -> FrozenFish-Apr94:BBS/ALib/d9xx/d935/MuchMore.lha
  311.   MuchMore-3.6.lha.pi -> FrozenFish-Apr94:BBS/ALib/d9xx/d935/MuchMore.lha.pi
  312.   MuchMore-4.2.lha    -> FrozenFish-Apr94:BBS/ALib/d9xx/d962/MuchMore.lha
  313.   MuchMore-4.2.lha.pi -> FrozenFish-Apr94:BBS/ALib/d9xx/d962/MuchMore.lha.pi
  314.  
  315. Note that if you use the standard Commodore commands (dir or list), these
  316. files may appear to be directories rather than links or regular files.  This
  317. is a deficiency in the Commodore utilities that will hopefully be fixed in a
  318. future release.  For now I recommend doing maintenance on symbolic links by
  319. using the GNU utilities "ls", "rm", and "ln", that handle symbolic links
  320. exactly as their UNIX counterparts.  These can all be found in the "GNU/bin"
  321. directory on this CD-ROM, and in the archives that are included in the
  322. BBS/GNU directory, if you find you are missing something.  See the notes
  323. further down in this document about ixemul.library and needing to use a
  324. larger stack value than you might normally be used to.
  325.  
  326. If we run pitool now in this directory (or in a tree of such directories),
  327. we can generate "files.bbs" files in each directory:
  328.  
  329.   cd sys:bbs/textreaders
  330.   pitool -b -F "%-24B %3KK %S\n" .        <---- note trailing '.'
  331.   cat files.bbs
  332.  
  333.   MuchMore-1.8.lha           36K Nice text viewer, like "more" or "less".
  334.   MuchMore-2.5.lha           53K Very nice text display program.
  335.   MuchMore-2.7.lha           42K Nice text displayer, like "more"/"less".
  336.   MuchMore-3.0.lha           43K Program like "more", "less", "pg", etc.
  337.   MuchMore-3.3.lha           61K Program like "more", "less", "pg", etc.
  338.   MuchMore-3.6.lha           64K Program like "more", "less", "pg", etc.
  339.   MuchMore-4.2.lha           86K Soft scroll text viewer with xpk-support
  340.  
  341. Also note that the -f option can be used to specify the name of the
  342. "files.bbs" type file.  This is useful to support multiple different kinds
  343. of information files (generated by different -F strings), or to force the
  344. name to match what your BBS system expects.
  345.  
  346. At this point, we should simply be able to add sys:bbs/textreaders as a new
  347. file area, and have the BBS pick up the file descriptions from the files.bbs
  348. file that was built.  Accesses to the files in that area will follow the
  349. symbolic link to the actual file on the CD-ROM.
  350.  
  351. One caution though, many tools don't work properly on symbolic links.  One
  352. of those tools is lha version 1.38, the apparently last shareware freely
  353. distributable version of lha.  It is entirely possible that whatever BBS
  354. system you are using may choke on links as well.  If so, you should ask the
  355. vendor of your BBS to support links, since I think this technique is quite
  356. powerful, and will become more important as time goes on and CD-ROM's get
  357. more and more common.
  358.  
  359. ------------------------
  360. DEFAULT ALTERNATIVE VIEW
  361. ------------------------
  362.  
  363. The directory BBS/Support contains at least one default view as "view1.lha".
  364. This archive contains a script called "view1.script", and an archive of
  365. files.bbs files called "view1desc.lha".  When the script is executed, it
  366. creates a subtree of directories in the current directory, with one
  367. directory for each letter of the alphabet, and then creates symbolic links
  368. in each of those directories to files on the CD-ROM that start with that
  369. letter.  The link names incorporate the version number of the material or
  370. the disk number, as described above.  If this still isn't sufficient to make
  371. the names unique, an additional differentiator string is added to the file
  372. basename.  I.E.
  373.  
  374.     M/MuchMore-1.8.lha
  375.     M/MuchMore-1.8-a.lha
  376.     M/MuchMore-1.8-b.lha
  377.  
  378. This can happen when there are more than one copy of the same version of the
  379. material on the same CD-ROM (such as included both in the floppy library and
  380. in the "Useful" tree).
  381.  
  382. After building the directory tree and populating it with symbolic links, the
  383. view1.script file unarchives "view1desc.lha" to populate each directory with
  384. default "files.bbs" files.  Doing a "wc -l #?/files.bbs" for the May 94
  385. FreshFish CD version of these files shows the statistics of what directories
  386. are present and how many archive files are in each.  Note that the complete
  387. GNU distribution is placed in it's own private directory:
  388.  
  389.     127 GNU/files.bbs
  390.      44 a/files.bbs
  391.      32 b/files.bbs
  392.      44 c/files.bbs
  393.      51 d/files.bbs
  394.       8 e/files.bbs
  395.      24 f/files.bbs
  396.      11 g/files.bbs
  397.      19 h/files.bbs
  398.      12 i/files.bbs
  399.       5 j/files.bbs
  400.       8 k/files.bbs
  401.      13 l/files.bbs
  402.      39 m/files.bbs
  403.      10 n/files.bbs
  404.       7 o/files.bbs
  405.      25 p/files.bbs
  406.       3 q/files.bbs
  407.      16 r/files.bbs
  408.      44 s/files.bbs
  409.      35 t/files.bbs
  410.       5 u/files.bbs
  411.      12 v/files.bbs
  412.      13 w/files.bbs
  413.       2 x/files.bbs
  414.       2 y/files.bbs
  415.       2 z/files.bbs
  416.     613 total
  417.  
  418. It is hoped that additional views will become available fairly quickly,
  419. including one that is structured along more functional lines, like "games/",
  420. "pictures/", "compilers/", etc.  As more information is added to the product
  421. info files, generating these views will be an almost trivial operation.
  422.  
  423. Note that instead of running the view1.script file, you can execute the
  424. view1.links file which runs the GNU ln utility to make the links rather than
  425. using the symlink() call built into the symlinks utility.  This gives you
  426. the opportunity to modify the links if desired.  You then have to unpack the
  427. view1desc.lha archive to populate the directories with the files.bbs files.
  428.  
  429. Unix users should note that a simple edit to view1.links will make the
  430. script usable on Unix systems that support symbolic links.  Just change all
  431. occurances of strings like "FreshFish-May94:" to "/cdrom/", or whatever
  432. directory the CD-ROM is mounted on.
  433.  
  434. ----------------------------
  435. GZIP COMPRESSED TAR ARCHIVES
  436. ----------------------------
  437.  
  438. A few archives here are in what is known as "compressed tar archive" format.
  439. These are archives that are made with "tar" and then compressed with the
  440. "gzip" compressor.  Generally they are the original unchanged archives for
  441. GNU distributions, exactly as released by the Free Software Foundation.  To
  442. unpack them, you can do:
  443.  
  444.     gzip -d foo.tar.gz
  445.     tar -xvf foo.tar
  446.  
  447. or if you have a shell that supports pipes, you can avoid making the
  448. uncompressed tar archive (which might be quite large), and simply do:
  449.  
  450.     gzip -d <foo.tar.gz | tar -xvf -
  451.  
  452. Both gzip and tar are included in the "GNU/bin" directory on this CD-ROM.
  453.  
  454. --------------
  455. IXEMUL.LIBRARY
  456. --------------
  457.  
  458. All of the utilities described here are compiled with GNU gcc, and require
  459. the ixemul.library to be found in the LIBS: directory.  If you run the
  460. suggested startup scripts "Useful-Startup" and "GNU-Startup", the utilities
  461. and libraries will be added to your C: and LIBS: assigns for you, so you
  462. don't have to actually copy anything off the CD-ROM to run the tools.
  463.  
  464. Be sure to set your stack size to a fairly large value, say 50,000 or more,
  465. before running any of the tools.
  466.  
  467. -Fred ><>
  468.