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