home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / PBFM103.ZIP / PBFILMAN.DOC < prev    next >
Text File  |  1995-01-14  |  11KB  |  236 lines
  1.                    PBFILMAN  v1.03 (Public release)
  2.  
  3.     PEFILMAN is written by Jeffrey C. Paul, All Rights Reserved
  4.  
  5.       Jeff Paul may be reached at the RoboNERDS BBS
  6.       1-615-890-4796 (v.32bis), the ProBoard Support Echo (FIDO)
  7.       or netmail to FIDO 1:116/137.
  8.  
  9. Welcome
  10. =======
  11.  
  12. Welcome to PBFILMAN.  PBFILMAN is a utility program designed and coded JUST
  13. for ProBoard.  It has been tested with ProBoard v2.00, 2.01.
  14. I wrote PBFILMAN as a utility to get myself a means of moving files (along with
  15. their descriptions) from one file area to another.  I programed PBFILMAN to
  16. complement the AMU utility program.  I also wanted a program that anyone can
  17. run the minute that it is installed without reading too much of this DOC.
  18.  
  19. What's NEW
  20. ==========
  21. New features in version 1.03 include a duplicate file finder, remove off-line
  22. files, memory status, file area displayed and number of files display at top
  23. of screen.  Moving files on the same drive now runs MUCH faster.
  24.  
  25. NEW command line options.
  26. /I  Indent
  27.     Will cause PBFILMAN to indent extended descriptions so they line up with
  28.     the first description line of a file.  Normally extended descriptions
  29.     start in column two.  This works with the DIZ, ADOPT, and EDIT functions.
  30.  
  31. /NH No Header
  32.     Normally PBFILMAN will add a header to the top of the files.bbs list
  33.     when it updates the list.  If you do not want a header created then use
  34.     this switch.
  35.  
  36. For example:  PBFILMAN /I /NH
  37. Will run PBFILMAN and will not create headers and will indent extended
  38. descriptions when a DIZ, ADOPT, or EDIT is done.
  39.  
  40.  
  41. Installation
  42. ============
  43.  
  44. Just copy the main program (PBFILMAN.EXE) into your PB directory.
  45. This is usually C:\PB.
  46. PBFILMAN "MUST" be run from the ProBoard main directory.
  47. Copy PBFILMAN.NOT to the PB directory.  This is a plain text file that
  48. contains the file names of any files that you DO NOT want the ADOPT
  49. option to add to your file listings.  For example FILES.BBS FILES.BAK etc.
  50.  
  51. !!! NOTICE !!! If you want PBFILMAN to import FILE_ID.DIZ descriptions from
  52. ZIP and ARJ archives then PKUNZIP.EXE and ARJ.EXE MUST be in the same
  53. directory as PBFILMAN. (This is usually C:\PB)
  54.  
  55. That's it.
  56. After you register your copy of PBFILMAN you will receive a file named
  57. PBFILMAN.KEY that must also be copied to the same directory as PBFILMAN.
  58.  
  59.  
  60. What will PBFILMAN do for me?
  61. =============================
  62.  
  63. PBFILMAN can do the following:
  64.  
  65. Move one file from one file area to another.
  66. Delete one file from current file area.
  67.  
  68. Tag files in current file area.
  69. Move all tagged files from current file area to another.
  70. Delete all tagged files from current file area.
  71.  
  72. Multi word description searches.
  73.  
  74. Edit file descriptions.
  75.  
  76. Sort file areas by your choice of File Name, File Date, Reverse File Date.
  77.  
  78. Import FILE_ID.DIZ descriptions from ZIP and ARJ archives.
  79.  
  80. Adopt new files (along with their FILE_ID.DIZ descriptions) into an area's
  81. FILES.BBS listing.
  82.  
  83. Remove Off-Line files from the BBS listing.
  84.  
  85. Create a display listing Duplicate file names and the file areas where the
  86. duplicates can be found.
  87.  
  88. Tag files that have a duplicate in another file area.
  89.  
  90. Memory Status display.
  91.  
  92. If no changes are made to an area, you can now exit WITHOUT sorting or updating
  93. the Files.BBS.
  94.  
  95. Mostly, PBFILMAN is easy to set up, easy to use, and will save any ProBoard
  96. sysop alot of time.
  97.  
  98.  
  99. How to Use
  100. ==========
  101.  
  102. To start PBFILMAN just change to the PB directory and type "PBFILMAN".
  103. PBFILMAN will load and give you a list of all Hard Drive file areas on your
  104. BBS.  Full mouse support makes program use very easy, but if you don't have a
  105. mouse then buttons can be selected by pressing ALT and the highlighted letter
  106. on a button.  Scrolling bar options can be selected with a double mouse click
  107. or by pressing the Enter key.  All screens can be exited by pressing the ESC
  108. key.  The UP and DOWN arrow keys and the Page Up and Page Down keys will
  109. move up and down the current listing.
  110.  
  111. PBFILMAN only supports file areas that are stored on the Hard Drive.  The main
  112. reason for PBFILMAN is to move files around so there is no need to show CD-ROM
  113. areas.  When you select a file area, PBFILMAN will load in the file descriptions
  114. and file dates for all the files in that area.  The listing will be displayed
  115. in file name sorted order.  From this listing you can do the following:
  116.  
  117.   Tag - This option will place a check mark next to the highlighted file so
  118.         that it may be processed with a group of tagged files.  Selecting
  119.         Tag on a file that is already tagged to clear the tag.
  120.  
  121.   Untag All - This option will clear ALL tags for all "tagged" or "marked for
  122.               delete" files.
  123.  
  124.   Delete - This option will place a "D" next to the highlighted file and mark
  125.            it for Delete.  Marked files are not actually deleted until you Exit
  126.            the current file area.  Selecting Delete on a file that is already
  127.            marked for delete will clear the delete flag.
  128.  
  129.   Delete Tagged - This option will mark all Tagged files for Delete.
  130.  
  131.   Move File - This option will move the highlighted file and description to
  132.               another file area of your choice.
  133.  
  134.   Move Tagged - This option will move ALL Tagged files and their descriptions
  135.                 to another file area of your choice.
  136.  
  137.   Search - This option will prompt for up to two words to search for in the
  138.            current file area descriptions.  All files that match the search
  139.            will be Tagged.  After the search, the first file tagged from this
  140.            search will be highlighted.  Searches never clear tags.  If you
  141.            search on the word "Window" then you will have all files with
  142.            "Window" in the description Tagged.  If you then search on the word
  143.            "VGA" you will have a listing with files tagged from both searches.
  144.            If you enter both a Primary and Secondary search then both words
  145.            must exist before a file will be tagged.
  146.  
  147.   Edit - This will allow you to edit the description for the highlighted file.
  148.  
  149.   DiZ - This option will import the FILE_ID.DIZ description from a ZIP or ARJ
  150.         archive file.  NOTICE - for this option to function - PKZIP.EXE and
  151.         ARJ.EXE must be located in the main ProBoard directory.
  152.  
  153.   Adopt - This option will import any new files that are not already in the
  154.           area's FILES.BBS listing.  If any of the files are ZIP or ARJ
  155.           archives then PBFILMAN will try to import their FILE_ID.DIZ.
  156.           If no FILE_ID.DIZ is found then the description will be set to
  157.           "Description not available."
  158.  
  159.   Other - This will display a menu of some less used options.  Under the
  160.           Other menu you have the following choices.
  161.  
  162.           Remove Off-Line Files - This option will scan the displayed file area
  163.                                   and remove the files and descriptions for all
  164.                                   files that display "Off-Line" next to the
  165.                                   file name.  If you ever use the DOS delete
  166.                                   command to delete files from a file area this
  167.                                   option can save alot of time cleaning up the
  168.                                   files.bbs.
  169.  
  170.           Duplicate File Name List - This option will read the file index that
  171.                                      PBUTIL FI creates and will display a list
  172.                                      of all the files that exist in more than
  173.                                      one file area.  The displayed list will
  174.                                      show the file name, Area number, and the
  175.                                      file area description.  Depending on how
  176.                                      many files exist on the BBS this option
  177.                                      can take from a few seconds to several
  178.                                      minutes to run.  Make sure your file index
  179.                                      is up to date before taking this option.
  180.                                      It will only create this listing once.
  181.                                      If you take this option a second time it
  182.                                      will just display the current list of
  183.                                      duplicates.
  184.  
  185.           Tag Duplicate Files - NOTE: You MUST take the "Duplicate File Name
  186.                                 List" before this option can be selected.
  187.                                 This option will tag any files in the displayed
  188.                                 file area that have a duplicate in any other
  189.                                 file area.
  190.  
  191.           Memory Status - This option will display the amount of free
  192.                           Conventional, Virtual, and Largest Virtual Block.
  193.                           The main one to watch is the Virtual amount.  For
  194.                           best performance it should have at least 4 Meg.
  195.                           If it is below this amount then you need to free
  196.                           up some disk space.
  197.  
  198.           Exit - Will exit to the main file area screen.
  199.  
  200.   Exit - This option will present a screen so that you may select the order of
  201.          the file listing.  The listing may be sorted by your choice of
  202.          Filename, Date (old to new), Reverse Date (new to old), or Natural
  203.          Order (No Sorting).  After this selection the file listing is
  204.          updated and files flagged for delete are deleted.
  205.          There is now a new option.  If you have made no changes in the current
  206.          file area, then you have the option of selecting the "Exit No Update"
  207.          button.  If changes have been made then you must select a sort option.
  208.  
  209.  
  210. Notice
  211. ======
  212.  
  213. Remember to run PBUTIL FI after you make any changes.
  214. PBFILMAN should not be run while anyone is using the BBS.
  215. It's always a good idea to backup your file listings before using any new
  216. utilities.
  217.  
  218. Shareware
  219. =========
  220. This program is being distributed as Shareware.  You may use this program for a
  221. period of 30 days.  After this 30 day trial period you must either register or
  222. quit using PBFILMAN.  If you register you will be sent a KEY file that will
  223. remove the NAG screen and show that you are a registered user.  Registration is
  224. good for this and ALL future versions of PBFILMAN.  Please see the file named
  225. REGISTER.DOC for registration information.
  226.  
  227. Disclaimer
  228. ==========
  229. USE OF THIS PROGRAM IS AT YOUR OWN RISK.  Even though PBFILMAN has been very
  230. well tested, there is always the possibility of an unknown problem.  There is no
  231. warranty either expressed or implied.  The author Jeffrey C. Paul, and everyone
  232. associated with RoboNERDS BBS, can in no way be held responsible for any damage
  233. caused by the use of PBFILMAN.  The only thing PBFILMAN is guaranteed to do is
  234. take up disk space. By using PBFILMAN you are hereby held to the above terms.
  235.  
  236.