home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / FLIST201.ZIP / FILELIST.DOC < prev    next >
Encoding:
Text File  |  1996-10-13  |  5.3 KB  |  99 lines
  1. *************************     FILELIST v2.01     ******************************
  2.  
  3. A program for use with a TBBS setup for making a complete listing of .dir and 
  4. .far files. 
  5.  
  6.                      Version 1, (c) Tom Parker, 1989
  7.                      Version 2, (c) David Rance, 1996
  8.  
  9. Typing FILELIST on the command line gives you the following display:
  10.  
  11.         Usage:  Filelist <config file> [options]
  12.  
  13.         Options:
  14.             -d  Print File's Date
  15.             -o  Display File's Owner
  16.  
  17.         Note:  Bad options will not cause an abort!
  18.  
  19. An option's natural state is off unless specified.
  20.  
  21. CONFIGURATION
  22.  
  23. Included is a sample configuration file. For simplicity it is the same as a 
  24. .far file except for one thing - you are able to list other .far files in the 
  25. configuration.  A note of warning however, DO NOT make a recursive reference 
  26. within your configuration files.  Filelist has no capabilities of detecting 
  27. recursive references, and it'll likely fill up your hard disk with the same 
  28. directories over and over again. (An example of a recursive reference would be 
  29. listing a.far in b.far, and b.far in a.far.) 
  30.  
  31. DISCLAIMER
  32.  
  33. You use this program at your own risk. It has received an hour or two's testing 
  34. here at Ichthus and it is now in regular use. It works here, but I don't 
  35. guarantee that it will work for you. In fact the program comes with no 
  36. guarantees at all and you use it entirely at your own risk. However, I would be 
  37. glad to receive any feedback, good or bad. 
  38.  
  39. TBBS is a trademark of eSoft Inc.
  40.  
  41. David Rance
  42. 12th October, 1996
  43.  
  44. The revising author may be contacted at:
  45.  
  46. Fidonet:  David Rance  2:252/110
  47. Internet: david.rance@ichthus.dircon.co.uk
  48. BBS:      Ichthus (Reading), UK +44-118-946-1466 or 946-4937
  49. Address:  Middelburg House, 10b Woods Road, Caversham,
  50.           READING, RG4 6NA, England
  51.  
  52. Tom Parker, the original author of this program, seems no longer to be 
  53. contactable. If anyone is able to give me his whereabouts, I would be most 
  54. grateful.
  55.  
  56. /****************************************************************************/
  57. /*           Filelist v2.01:  Changes copyright 1996 by David Rance         */
  58. /*                                                                          */
  59. /*      13/10/96 v2.01:  If the description of a file contained an          */ 
  60. /*                       apostrophe (the same character that starts the     */
  61. /*                       owner name) and there wasn't an owner name, then   */
  62. /*                       Filelist complained that the entry was mangled.    */
  63. /*                       Fixed. (Been meaning to fix this ever since I got  */
  64. /*                       the program seven years ago!)                      */
  65. /*      27/01/96 v2.00:  Tom Parker's Turbo C code altered slightly to make */
  66. /*                       compilation under Microsoft C possible ('cos       */
  67. /*                       that's the only compiler I've got!). Code added    */
  68. /*                       to recognise "!~" comment lines in .far files.     */
  69. /*                       Coded added to ignore flags field in .far files.   */
  70. /*                       Files now display in uppercase and date in         */
  71. /*                       European standard. Code added to display a date of */
  72. /*                       compilation and a signature at the end of the file */
  73. /*                                                                          */
  74. /*  Filelist v1.04:  Copyright February 9th, 1989 by Tom Parker.            */
  75. /*                   All rights reserved.                                   */
  76. /*                                                                          */
  77. /*      02/23/89 v1.04:  Expanded the maximum length of a line to 512 bytes.*/
  78. /*      02/19/89 v1.03:  Changed the format of directory listings to allow  */
  79. /*                       the date to be included and take less space in     */
  80. /*                       terms of padding.  Also, made the directory parser */
  81. /*                       more likely to reject entries that TBBS would not  */
  82. /*                       list.                                              */
  83. /*      02/12/89 v1.02:  Allowed an absence of an owner in a directory entry*/
  84. /*                       and toughened up testing of a directory entry.     */
  85. /*      02/11/89 v1.01:  Fixed two bugs which were the result of inadequate */
  86. /*                       testing.  The first was the way it parsed a        */
  87. /*                       directory entry.  On entries where there were more */
  88. /*                       than one space between the directory entry to      */
  89. /*                       display, and the user's ID, the user's idea would  */
  90. /*                       be (a) blank(s), and the user's ID would end up in */
  91. /*                       the comment.  The solution was to parse part of the*/
  92. /*                       string one way, and the rest another.  The other   */
  93. /*                       bug was that on comment extentions, the ">"        */
  94. /*                       charactar on the first part of the comment was not */
  95. /*                       recognized.  That too is now fixed.                */
  96. /*      02/09/89 v1.00:  Started.                                           */
  97. /****************************************************************************/
  98.  
  99.