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