home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / PBFM105.ZIP / PBFILMAN.DOC < prev    next >
Text File  |  1995-05-06  |  15KB  |  340 lines
  1.                    PBFILMAN  v1.05 (Public release)
  2.  
  3.     PEFILMAN is written by Jeff Paul, All Rights Reserved
  4.  
  5.       Jeff Paul may be reached at RoboNERDS BBS
  6.       1-615-890-4796 (v.32bis), the ProBoard Support Echo (FIDO)
  7.       or netmail to FIDO 1:116/137 or Internet mail to
  8.       Jeff.Paul@137.trapper.isdn.net
  9.  
  10. Welcome
  11. =======
  12.  
  13. Welcome to PBFILMAN.  PBFILMAN is a utility program designed and coded JUST
  14. for ProBoard.  It has been tested with ProBoard v2.00, 2.01 and should work
  15. with the yet to be released 2.02.
  16. I wrote PBFILMAN as a utility to get myself a means of moving files (along with
  17. their descriptions) from one file area to another.
  18. I also wanted a program that anyone can run the minute that it is installed
  19. without reading too much of this DOC.
  20.  
  21. What's NEW in version 1.05
  22. ==========================
  23. Under Configure is a new option for setting up how you want PBFILMAN to
  24. sort each of your hard drive file areas.  Please select this option and
  25. tell PBFILMAN how you want things sorted.  The program will default to
  26. "Natural Order" if none is selected.
  27.  
  28. File listings will now list in the sorted order.
  29.  
  30. Files beginning with "!" should now work. (Bug fix)
  31.  
  32. When moving a group of files PBFILMAN was leaving an Orphan file description.
  33. This has been fixed. (Bug Fix)
  34.  
  35. When moving files, if the last file in a listing was moved to another area
  36. then the last line of a multi-line description would be lost.
  37. This has been fixed. (Bug Fix)
  38.  
  39. New "Remove" option will remove the description from the file list but will
  40. not delete the file from the hard drive.
  41.  
  42. New command line option.
  43. /S#  Will sort file area #.
  44. For example:  PBFILMAN /S5   This will sort file area number 5 in what ever
  45. order is set up in the sort configuration file.  If you want to sort several
  46. file areas then just repeat the process in your batch file.  For Example:
  47.  
  48. PBFILMAN /S1
  49. PBFILMAN /S3
  50. PBFILMAN /S15
  51. PBFILMAN /S55
  52.  
  53. This would sort file areas 1,3,15 and 55.
  54.  
  55. The command line option /NH for "No Header" will leave an existing header if
  56. one already exists but will not add PBFILMAN's header.
  57.  
  58. The command line option /I can now be followed by a number to tell what
  59. column to start multi-line descriptions.  For example PBFILMAN /I10 would
  60. start the multi-line descriptions at the 10th column.
  61.  
  62. ALL NEW editor for editing a files description.  Full functions with word wrap,
  63. line delete, etc.
  64.  
  65.  
  66.  
  67. What's NEW in version 1.04
  68. ==========================
  69. From the main menu there is a new option called "Configuration"
  70. This will call a menu that allows you to select the file areas that are to
  71. be used for each of the four available Allfiles or Newfiles listings.
  72. Just tag the file areas that you want included in the listings.
  73.  
  74. NOTE: Unregistered users of PBFILMAN can only set up 1 set of file areas for
  75.       the ALLFILES and NEWFILES listings.  Registered users are able to set up 4
  76.       sets of file areas for the listings - giving the ability to create a total
  77.       of 4 Allfiles listings and 4 Newfiles listings.
  78.  
  79. You MUST take the Configuration option and select the areas to include in the
  80. Allfiles/Newfiles listings before any of the listings can be created.
  81. To create an Allfiles listing you run PBFILMAN with command line options.
  82.  
  83. New command line options:
  84.  
  85. /A1(Path and Filename) - Will create an allfiles list with the areas selected
  86.                          for the number 1 listing.  The allfiles listing will
  87.                          be created using the named path and filename.
  88. /A2(Path and Filename)   Same as /A1 except uses number 2 listing.
  89. /A3(Path and Filename)   Same as /A1 except uses number 3 listing.
  90. /A4(Path and Filename)   Same as /A1 except uses number 4 listing.
  91.  
  92. For Example:
  93.  
  94. PBFILMAN /A1C:\NEWFILES\ALLFILES.TXT
  95.  
  96. This command will create an allfiles listing called ALLFILES.TXT in the
  97. C:\NEWFILES directory on drive C:.  The areas in the listing are from the
  98. Allfiles 1 Configuration.
  99.  
  100. PBFILMAN /A1ALL1.TXT /A2ALL2.TXT /A3ALL3.TXT /A4ALL4.TXT
  101.  
  102. This will create all four allfiles listings in the current directory with the
  103. names ALL1.TXT, ALL2.TXT, ALL3.TXT and ALL4.TXT.
  104.  
  105. Newfiles listing.
  106. ==================
  107. New command line options:
  108.  
  109. /NF<NUMBER DAYS>  When this option is added to the command line for creating
  110.                   ALLFILES listings it will create NEWFILES listings instead.
  111.  
  112. For Example:
  113. PBFILMAN /A1NEW1.TXT /A2NEW2.TXT /NF30
  114.  
  115. This example will create two NEWFILES listings with the names NEW1.TXT and
  116. NEW2.TXT.  They will both include files that are no more than 30 days old.
  117. NEW1.TXT will include file areas selected for listings number 1 configuration.
  118. NEW2.TXT will include file areas selected for listings number 2 configuration.
  119.  
  120.  
  121. What's NEW in version 1.03
  122. ==========================
  123. New features in version 1.03 include a duplicate file finder, remove off-line
  124. files, memory status, file area displayed and number of files display at top
  125. of screen.  Moving files on the same drive now runs MUCH faster.
  126.  
  127. NEW command line options.
  128. /I  Indent
  129.     Will cause PBFILMAN to indent extended descriptions so they line up with
  130.     the first description line of a file.  Normally extended descriptions
  131.     start in column two.  This works with the DIZ, ADOPT, and EDIT functions.
  132.  
  133. /NH No Header
  134.     Normally PBFILMAN will add a header to the top of the files.bbs list
  135.     when it updates the list.  If you do not want a header created then use
  136.     this switch.
  137.  
  138. For example:  PBFILMAN /I /NH
  139. Will run PBFILMAN and will not create headers and will indent extended
  140. descriptions when a DIZ, ADOPT, or EDIT is done.
  141.  
  142.  
  143. Installation
  144. ============
  145.  
  146. Just copy the main program (PBFILMAN.EXE) into your PB directory.
  147. This is usually C:\PB.
  148. PBFILMAN "MUST" be run from the ProBoard main directory.
  149. Copy PBFILMAN.NOT to the PB directory.  This is a plain text file that
  150. contains the file names of any files that you DO NOT want the ADOPT
  151. option to add to your file listings.  For example FILES.BBS FILES.BAK etc.
  152.  
  153. !!! NOTICE !!! If you want PBFILMAN to import FILE_ID.DIZ descriptions from
  154. ZIP and ARJ archives then PKUNZIP.EXE and ARJ.EXE MUST be in the same
  155. directory as PBFILMAN. (This is usually C:\PB)
  156.  
  157. That's it.
  158. After you register your copy of PBFILMAN you will receive a file named
  159. PBFILMAN.KEY that must also be copied to the same directory as PBFILMAN.
  160.  
  161.  
  162. What will PBFILMAN do for me?
  163. =============================
  164.  
  165. PBFILMAN can do the following:
  166.  
  167. Move one file from one file area to another.
  168. Delete one file from current file area.
  169.  
  170. Tag files in current file area.
  171. Move all tagged files from current file area to another.
  172. Delete all tagged files from current file area.
  173.  
  174. Multi word description searches.
  175.  
  176. Edit file descriptions.
  177.  
  178. Sort file areas by your choice of File Name, File Date, Reverse File Date.
  179.  
  180. Import FILE_ID.DIZ descriptions from ZIP and ARJ archives.
  181.  
  182. Adopt new files (along with their FILE_ID.DIZ descriptions) into an area's
  183. FILES.BBS listing.
  184.  
  185. Remove Off-Line files from the BBS listing.
  186.  
  187. Create a display listing Duplicate file names and the file areas where the
  188. duplicates can be found.
  189.  
  190. Tag files that have a duplicate in another file area.
  191.  
  192. Memory Status display.
  193.  
  194. ALLFILES and NEWFILES listings.
  195.  
  196. If no changes are made to an area, you can now exit WITHOUT sorting or updating
  197. the Files.BBS.
  198.  
  199. Mostly, PBFILMAN is easy to set up, easy to use, and will save any ProBoard
  200. sysop allot of time.
  201.  
  202.  
  203. How to Use
  204. ==========
  205.  
  206. To start PBFILMAN just change to the PB directory and type "PBFILMAN".
  207. PBFILMAN will load and give you a list of all Hard Drive file areas on your
  208. BBS.  Full mouse support makes program use very easy, but if you don't have a
  209. mouse then buttons can be selected by pressing ALT and the highlighted letter
  210. on a button.  Scrolling bar options can be selected with a double mouse click
  211. or by pressing the Enter key.  All screens can be exited by pressing the ESC
  212. key.  The UP and DOWN arrow keys and the Page Up and Page Down keys will
  213. move up and down the current listing.
  214.  
  215. PBFILMAN only supports file areas that are stored on the Hard Drive.  The main
  216. reason for PBFILMAN is to move files around so there is no need to show CD-ROM
  217. areas.  When you select a file area, PBFILMAN will load in the file descriptions
  218. and file dates for all the files in that area.  The listing will be displayed
  219. in file name sorted order.  From this listing you can do the following:
  220.  
  221.   Tag - This option will place a check mark next to the highlighted file so
  222.         that it may be processed with a group of tagged files.  Selecting
  223.         Tag on a file that is already tagged to clear the tag.
  224.  
  225.   Untag All - This option will clear ALL tags for all "tagged" or "marked for
  226.               delete" files.
  227.  
  228.   Delete - This option will place a "D" next to the highlighted file and mark
  229.            it for Delete.  Marked files are not actually deleted until you Exit
  230.            the current file area.  Selecting Delete on a file that is already
  231.            marked for delete will clear the delete flag.
  232.  
  233.   Delete Tagged - This option will mark all Tagged files for Delete.
  234.  
  235.   Move File - This option will move the highlighted file and description to
  236.               another file area of your choice.
  237.  
  238.   Move Tagged - This option will move ALL Tagged files and their descriptions
  239.                 to another file area of your choice.
  240.  
  241.   Search - This option will prompt for up to two words to search for in the
  242.            current file area descriptions.  All files that match the search
  243.            will be Tagged.  After the search, the first file tagged from this
  244.            search will be highlighted.  Searches never clear tags.  If you
  245.            search on the word "Window" then you will have all files with
  246.            "Window" in the description Tagged.  If you then search on the word
  247.            "VGA" you will have a listing with files tagged from both searches.
  248.            If you enter both a Primary and Secondary search then both words
  249.            must exist before a file will be tagged.
  250.  
  251.   Edit - This will allow you to edit the description for the highlighted file.
  252.  
  253.   DiZ - This option will import the FILE_ID.DIZ description from a ZIP or ARJ
  254.         archive file.  NOTICE - for this option to function - PKZIP.EXE and
  255.         ARJ.EXE must be located in the main ProBoard directory.
  256.  
  257.   Adopt - This option will import any new files that are not already in the
  258.           area's FILES.BBS listing.  If any of the files are ZIP or ARJ
  259.           archives then PBFILMAN will try to import their FILE_ID.DIZ.
  260.           If no FILE_ID.DIZ is found then the description will be set to
  261.           "Description not available."
  262.  
  263.   Other - This will display a menu of some less used options.  Under the
  264.           Other menu you have the following choices.
  265.  
  266.           Remove Off-Line Files - This option will scan the displayed file area
  267.                                   and remove the files and descriptions for all
  268.                                   files that display "Off-Line" next to the
  269.                                   file name.  If you ever use the DOS delete
  270.                                   command to delete files from a file area this
  271.                                   option can save allot of time cleaning up the
  272.                                   files.bbs.
  273.  
  274.           Duplicate File Name List - This option will read the file index that
  275.                                      PBUTIL FI creates and will display a list
  276.                                      of all the files that exist in more than
  277.                                      one file area.  The displayed list will
  278.                                      show the file name, Area number, and the
  279.                                      file area description.  Depending on how
  280.                                      many files exist on the BBS this option
  281.                                      can take from a few seconds to several
  282.                                      minutes to run.  Make sure your file index
  283.                                      is up to date before taking this option.
  284.                                      It will only create this listing once.
  285.                                      If you take this option a second time it
  286.                                      will just display the current list of
  287.                                      duplicates.
  288.  
  289.           Tag Duplicate Files - NOTE: You MUST take the "Duplicate File Name
  290.                                 List" before this option can be selected.
  291.                                 This option will tag any files in the displayed
  292.                                 file area that have a duplicate in any other
  293.                                 file area.
  294.  
  295.           Memory Status - This option will display the amount of free
  296.                           Conventional, Virtual, and Largest Virtual Block.
  297.                           The main one to watch is the Virtual amount.  For
  298.                           best performance it should have at least 4 Meg.
  299.                           If it is below this amount then you need to free
  300.                           up some disk space.
  301.  
  302.           Exit - Will exit to the main file area screen.
  303.  
  304.   Exit - This option will present a screen so that you may select the order of
  305.          the file listing.  The listing may be sorted by your choice of
  306.          Filename, Date (old to new), Reverse Date (new to old), or Natural
  307.          Order (No Sorting).  After this selection the file listing is
  308.          updated and files flagged for delete are deleted.
  309.          There is now a new option.  If you have made no changes in the current
  310.          file area, then you have the option of selecting the "Exit No Update"
  311.          button.  If changes have been made then you must select a sort option.
  312.  
  313.  
  314. Notice
  315. ======
  316.  
  317. Remember to run PBUTIL FI after you make any changes.
  318. PBFILMAN should not be run while anyone is using the BBS.
  319. It's always a good idea to backup your file listings before using any new
  320. utilities.
  321.  
  322. Shareware
  323. =========
  324. This program is being distributed as Shareware.  You may use this program for a
  325. period of 30 days.  After this 30 day trial period you must either register or
  326. quit using PBFILMAN.  If you register you will be sent a KEY file that will
  327. remove the NAG screen and show that you are a registered user.  Registration is
  328. good for this and ALL future versions of PBFILMAN.  Please see the file named
  329. REGISTER.DOC for registration information.
  330.  
  331. Disclaimer
  332. ==========
  333. USE OF THIS PROGRAM IS AT YOUR OWN RISK.  Even though PBFILMAN has been very
  334. well tested, there is always the possibility of an unknown problem.  There is no
  335. warranty either expressed or implied.  The author Jeffrey C. Paul, and everyone
  336. associated with RoboNERDS BBS, can in no way be held responsible for any damage
  337. caused by the use of PBFILMAN.  The only thing PBFILMAN is guaranteed to do is
  338. take up disk space. By using PBFILMAN you are hereby held to the above terms.
  339.  
  340.