home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / FILMG041.ZIP / FILEMGR.DOC < prev    next >
Text File  |  1994-03-06  |  13KB  |  303 lines
  1. 06 March 1994
  2.  
  3. File Manager for GT Power.  Copyright 1993-1994, Paul Varner
  4. All Rights Reserved
  5.  
  6. History behind File Manager:
  7.  
  8.   File Manager is being written to fill the void that GT Power has in
  9. the area of managing files.  After trying just about every FILES.BBS
  10. program that I could find and having them either not work properly or
  11. have quirks that I didn't like, I decided to write my own.  I have
  12. decided to release File Manager into Beta testing through the GT
  13. community early in its life, so that I can get feedback on what GT
  14. Sysops would like to see in it.
  15.  
  16. How to run File Manager:
  17.  
  18.   First since this is a Beta version, BACK UP your current FILES.BBS.
  19. When run, File Manager will create a copy of the current FILES.BBS and
  20. name it FILES.BAK, but please do not count on that as your backup.
  21. While File Manager runs fine on my system, I cannot and will not be
  22. responsible for any damage that this program may cause to your system.
  23.  
  24.   Since, File Manager does not have the File Management functions
  25. implemented (yet).  It is very command line driven.  The syntax for
  26. running File Manager is:
  27.  
  28.   filemgr [##] [/A | /AU] [/D] [/1] [/F] [/R] [/I] [/CD] [/NI] [/?]
  29.           [/Md:\path] [d:\path]
  30.  
  31. What these options do:
  32.  
  33. ##  - What column to start the descriptions in.  File Manager defaults
  34.       to column 23.  The allowable values are between 2 - 40.  If you
  35.       specify, an invalid column number, File Manager will quietly
  36.       reset it to 23.
  37.  
  38. /A  - Process all the directories listed in your GTDIR.BBS file.  This
  39.       option must not be run with the /AU option.
  40.  
  41. /AU - Process all the directories listed in your GTUDIR.BBS file.
  42.       This option must not be run with the /A option.
  43.  
  44. /D  - Do not reformat the description read in from either the
  45.       FILE_ID.DIZ or DESC.SDI files.  This will preserve any special
  46.       formatting present in the FILE_ID.DIZ file.  The Default for
  47.       File Manager is to reformat the descriptions read in from the
  48.       FILE_ID.DIZ file.
  49.  
  50. /1  - Assume that the FILES.BBS only has one line descriptions.  With
  51.       this option, File Manager will not bother reading the
  52.       FILE_ID.DIZ file and will simply sort the directory and write
  53.       the new FILES.BBS and FILES.CBS out with a header.  Do not use
  54.       this option on a FILES.BBS that has multiple line descriptions.
  55.       The results are very erratic.
  56.  
  57. /F  - Assume that the first line in the description only contains a
  58.       File Name followed by a description of some sort.  The default
  59.       is to assume that the first line has a format of File Name
  60.       followed by the File Size and then the description.  Examples of
  61.       both are:
  62.  
  63.         SOMEFILE.ZIP This is a a very important test file.
  64.         SOMEFILE.ZIP    1234  01-01-80 from: New User
  65.  
  66.       In the first case, all File Manger looks for is the name of the
  67.       file.  In the second case, it looks for the name and file size.
  68.       File Manager does not care what is after the File Name or File
  69.       Size respectively.  It can be Dates, who from, the start of a
  70.       description, or whatever.
  71.  
  72. /R  - Reformat all descriptions, both new and old.  This is helpful, if
  73.       you decide to change from starting the description in one column
  74.       to another.  The default is to not reformat old descriptions.
  75.  
  76. /I  - Ignore the files database in the FILES_?.CTL files.  This causes
  77.       File Manager to assume that all files in the directory are new.
  78.  
  79. /CD - The directory being processed is om a CD-ROM drive.  This tells
  80.       File Manager to go to the GTDIR.BBS file to get the name and
  81.       path of the description file.  The entry in the your GTDIR.BBS
  82.       file should look like the following in order for File Manager to
  83.       work properly.
  84.  
  85.         z f:\002A,,C:\GT\CDROM\DIR2A.BBS,CD Software Creations
  86.                                    or
  87.         z f:\002A,,C:\GT\CDROM\DIR2A.BBS Software Creations
  88.  
  89.       The only caveat is that the description file's file name should
  90.       end .BBS and that the description file cannot be on a CD-ROM
  91.       drive.  This switch is not needed when using the /A or /AU
  92.       switches.
  93.  
  94. /NI - Do not import new files in the directory into the FILES.BBS
  95.       file.  File Manager defaults to importing new files.
  96.  
  97. /Md:\path - Move the files listed in the file FILEMGR.MOV to the
  98.       directory pointed to by d:\path.  The FILEMGR.MOV file is a list
  99.       of file names in the directory being processed with one file
  100.       name per line.  As an example: Assume you are processing your
  101.       recent uploads directory and have created the FILEMGR.MOV file
  102.       with the list of files that you are moving to your games
  103.       directory.  The syntax would be:
  104.  
  105.         filemgr /Md:\gt\files\games d:\gt\files\uploads
  106.  
  107.       Finally, note that there is not a space between the 'M' and the
  108.       path that the file is being moved to.
  109.  
  110. d:\path - The drive and path that points to the FILES.BBS file that
  111.       you would like processed.  File Manager defaults to the current
  112.       drive and directory.
  113.  
  114. /?  - Print a short summary of command line options.
  115.  
  116.   The colors for the FILES.CBS file are modifiable.  In order to
  117. change the colors, create a text file called "COLORS.DAT".  This file
  118. can be placed in any of the following directories: Current Directory
  119. (where File Manager is running from), your GTPATH directory, your
  120. BBS/CBS files directory, your LAN path directory, or any directory in
  121. your PATH statement.  The format for this file is as follows: (Note:
  122. Please type the color names only)
  123.  
  124. lightcyan    <-- Color for the double lines.
  125. lightgreen   <-- Color for the Directory description.
  126. white        <-- Color for the File Manager Title.
  127. lightmagenta <-- Color for the Totals Line.
  128. yellow       <-- Color for the File Name.
  129. lightcyan    <-- Color for the File Size.
  130. lightgreen   <-- Color for the description on the first line.
  131. white        <-- Color for the description on the second through last lines
  132.                  of the description.
  133.  
  134. The allowable values for the colors are:
  135.  
  136.   BLUE, GREEN, CYAN, RED, MAGENTA, BROWN, LIGHTGRAY, DARKGRAY,
  137.   LIGHTBLUE, LIGHTGREEN, LIGHTCYAN, LIGHTRED, LIGHTMAGENTA, YELLOW,
  138.   WHITE
  139.  
  140. Spelling of the colors is important, however case is not.
  141.  
  142.   Finally, File Manager makes extensive use of the file database
  143. created by the FILES_DB program to reduce the run time of the program.
  144. What it does is read the file names of the files listed in the
  145. database and uses that to determine if a description is old or new.
  146. If it finds the name in the database, it does not try to extract a
  147. FILE_ID.DIZ file or reformat the description.  If you would like for
  148. File Manager to process an entire directory, you need to use the /I
  149. switch when running File Manager.  This effectively tells File Manager
  150. that every file that it reads is new.  This is slow, but it ensures
  151. that all the files with a FILE_ID.DIZ have been processed.  Also,
  152. because it depends on the database, you should keep the database
  153. updated, by running FILES_DB after running File Manager.  File Manager
  154. does not modify the files database files in anyway, it just reads
  155. them.
  156.  
  157. Planned Additions to File Manager:
  158.  
  159. * Bulletin Generation for New files uploaded.
  160. * Virus Scanning and Archive Conversion.
  161. * Movement of Files between directories.
  162. * Editing of descriptions.
  163.  
  164. Movement of files:
  165.  
  166.   I realize that the current method of moving files is a kludge.  I am
  167. currently working on an interface to File Manager that will allow you
  168. to "point and shoot" to move files around the different directories.
  169. The only reason for this temporary solution is that I am becoming
  170. tired of moving my files and descriptions around completely by hand.
  171.  
  172. Technical Information:
  173.  
  174.   For those of you who are interested, File Manager is written in the
  175. Ada language using the Meridian OpenAda compiler.  Whenever File
  176. Manager crashes and gives you an exception message it means that I
  177. messed something up in the programming of File Manager.  The most
  178. likely exception messages are Constraint Error and Storage Error.  A
  179. constraint error is caused whenever the range of a variable is
  180. exceeded.  A common cause is trying to stuff a 100 character string
  181. into a variable that I have declared to be an 80 character string.
  182. The storage error occurs when you run out of memory.  I am working on
  183. this and in the future hope to have either EMS/XMS usage or swap to
  184. disk available.
  185.  
  186. Bug Reports and Comments:
  187.  
  188.   I can be reached via GT Netmail at 081/002 and FIDO Netmail at
  189. 1:109/244, also I read the GT Utilities Hotline E10/116.  When sending
  190. me a bug report, report the exact error message and send me extracts
  191. of your current FILES.BBS and GTDIR.BBS
  192.  
  193. Getting the Latest Copy of File Manager:
  194.  
  195.   File Manager is File Requestable from my board (081/002) as
  196. filemgr.zip.  It is also Freq'able via FIDO at 1:109/244 with the
  197. Magic name FILEMGR.  As I release new versions, I will upload them
  198. onto The Capital Area Network (033/000), Jack's Board (081/001), and
  199. Infostation (032/001).  File Manager is also available as a file echo
  200. from Jack's Board and The Capital Area Network.
  201.  
  202. Registration:
  203.  
  204. Registration for File Manager is $10.  However, the registration fee
  205. is waived for all people who participate in the initial Beta Test.
  206. Please send me a Netmail message using the order.frm to receive your
  207. registration key.
  208.  
  209. Revision History:
  210.  
  211. 0.41ß: 06 March 1994
  212.  
  213. * Fixed a bug in the string comparison routines.
  214. * Fixed File Manager so that it will no longer give a constraint error
  215.   when the FILES.BBS contains lines longer than 80 characters.
  216. * Added registration information to File Manager.  A valid FILEMGR.KEY
  217.   file must exist somewhere in your path for File Manager to be
  218.   registered.
  219. * Changed the algorithm used to load and search the file names listed
  220.   in the FILES_?.CTL Files.  This should speed things up for those BBS's
  221.   that have a CD-ROM online.
  222. * Changed File Manager's logic to skip CD-ROM directories where the
  223.   "FILES.BBS" file resides on the CD-ROM drive.
  224.  
  225. 0.40ß: 22 November 1993
  226.  
  227. * Added /I switch to tell File Manager to ignore the FILES*.CTL files.
  228. * File Manager will create a FILES.BBS/CBS file when the directory
  229.   being processed does not have one.
  230. * File Manager will import Files not listed in the FIlES.BBS file that
  231.   are located in the directory being processed.  File Manager will
  232.   attempt to extract a FILE_ID.DIZ from these files and if none
  233.   exists, it will import a description that states that the
  234.   Description is not available.  When importing new files, File
  235.   Manager ignores all FILES.* and FILEMGR.* files.  Added the /NI
  236.   switch to tell File Manager to not import new files.
  237. * Added the /CD switch and support for CD-ROM drives.
  238. * Improved memory management.
  239.  
  240. 0.34ß: 02 October 1993
  241.  
  242. * Fixed bug that cause File Manager to bomb when the LAN path was empty.
  243. * Fixed bug that caused File Manager not to work correctly when being run
  244.   without a specified path.
  245.  
  246. 0.33ß: 26 September 1993
  247.  
  248. * The colors.dat file can be located in the current directory, the GTPATH,
  249.   the BBS/CBS directory, or your system path.
  250. * Added the LAN path to directories searched for the system files.
  251. * Added limited movement of files between directories.
  252.  
  253. 0.32ß: 31 July 1993
  254.  
  255. * Add support to read GT system files from the current directory,
  256.   the GTPATH, the BBS/CBS directory, or your system path.  This means
  257.   that the GTDIR.BBS and GTUDIR.BBS files can be in any of those
  258.   locations.
  259.  
  260. 0.31ß: 17 July 1993
  261.  
  262. * Fixed a major bug that caused File Manager to crap out on
  263.   FILES.BBS files that had file names that were similar (i.e.  10
  264.   and 10.CBS).
  265. * Fixed a minor bug where File Manager reread the FILES.CTL file
  266.   every time it processed a new directory with the /A or /AU switch.
  267.  
  268. 0.30ß: 12 July 1993
  269.  
  270.   (This is a total rewrite from previous versions.  I simplified a
  271.    lot of the string processing algorithms and tried to make my
  272.    assumptions fit a reasonable lowest common denominator concerning
  273.    the FILES.BBS format.)
  274.  
  275. * Added options to process all directories in the GTDIR.BBS or
  276.    GTUDIR.BBS Files.
  277. * Added customization of colors used in the FILES.CBS file.
  278. * Added the ability to not reformat descriptions from
  279.   FILE_ID.DIZ's.
  280. * Added support for one-line FILES.BBS files.
  281. * Hopefully squashed a lot of minor and not so minor bugs.
  282.  
  283. 0.21ß: 31 May 1993
  284.  
  285.   (I decided to make this a quick turnaround for an added feature as
  286.    Jack Hazel seemed disappointed by the lack of support for the
  287.    FILES.CBS and Headers.)
  288.  
  289. * Added Creation of FILES.CBS and Headers for the FILES.CBS and
  290.   FILES.BBS.  The colors are hardwired, but I plan on having
  291.   customizable colors by the next release.
  292.  
  293. 0.2ß: 30 May 1993
  294.  
  295. * Added support for .LZH and .ARJ archives.
  296. * Added support for reformatting to different columns
  297. * Cleaned up the code.
  298. * First Public Beta Release.
  299.  
  300. 0.1α:
  301.  
  302. * Initial conception and coding.
  303.