home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 035 / mpm1_22a.zip / maxfmpm.txt < prev    next >
Text File  |  1994-10-17  |  79KB  |  1,918 lines
  1.  
  2.  
  3.                         MaxFile/PM - VERSION 1.22
  4.  
  5.           COPYRIGHT 1993,1994 by Craig Morrison. All Rights Reserved.
  6.  
  7.                 A FILES.BBS Manager for Presentation Manager
  8.  
  9.  
  10.  
  11.         Portions of the header files used in compilation are:
  12.  
  13.           Copyright (C) 1992 by Scott Dudley
  14.           Copyright (C) 1993 by Aki Antman
  15.           Copyright (C) 1994 by Marco Maccaferri
  16.  
  17.         MSGAPI portions of the Announce Files option are:
  18.  
  19.           Copyright 1991,94 by Scott J. Dudley.  All rights reserved.
  20.           "Squish" and "Maximus" are trademarks of SCI Communications.
  21.  
  22.         From the Development Team of:
  23.  
  24.           Craig Morrison - MaxFile/PM Development
  25.             1:201/60@fidonet.org
  26.  
  27.           Ronald Van Iwaarden - MaxFile/2 Development
  28.             1:104/338@fidonet.org
  29.  
  30.  
  31.  
  32. Special Thanks go out to:
  33.  
  34.  Mark Kimes
  35.  
  36.   For putting up with my never ending questions and general bull-headedness
  37.   when it comes to programming under OS/2. (Very handy guy to talk to when it
  38.   comes to programming in general!)
  39.  
  40.  Elliott Goodman
  41.  
  42.   Beta Tester (Thanks a BUNCH! Notice the name TWO t's! ;-)
  43.   ANNOUNCE.CMD author
  44.  
  45.  Philip Perlman
  46.  
  47.   Beta Tester (You to Phil! Couldn't have done it without ya's!)
  48.  
  49.  Ronald Van Iwaarden
  50.  
  51.   Cohort in crime and Beta Tester
  52.  
  53.  
  54. ------------------------------------------------------------------------------
  55. --- OS/2 Service Pack and Beta Version Information ---------------------------
  56. ------------------------------------------------------------------------------
  57.  
  58.         !!!! NOTICE TO OS/2 SERVICE PACK USERS ¡¡¡¡
  59.  
  60.         The incompatibility problems experienced with the service pack
  61.         have been addressed. MaxFile/PM should now run on stock 2.1 GA
  62.         code and 2.11 whether it be 2.10 with the XR06200 level CSDs
  63.         or the 2.11 SE.
  64.  
  65.         I make *NO* guarantee that MaxFile/PM will run reliably under
  66.         OS/2 version 2.11. IBM broke OS/2 for many, many people when
  67.         the CSDs were released for the XR06200 level.
  68.  
  69.         I have been testing MaxFile/PM with 2.11 installed, so far it
  70.         works as advertised. As with everything else, your mileage may
  71.         vary.
  72.  
  73.  
  74. ------------------------------------------------------------------------------
  75. --- Foreword -----------------------------------------------------------------
  76. ------------------------------------------------------------------------------
  77.  
  78.         MaxFile/PM is a FILES.BBS manager that runs under Presentation
  79.         Manager. While it was written with the Maximus-CBCS in mind,
  80.         any BBS software package that uses the standard FILES.BBS
  81.         format is supported.
  82.  
  83.         A quick but less than comprehensive list of the features are:
  84.  
  85.             1. Drag and Drop between file areas
  86.  
  87.             2. Adopting orphan files
  88.  
  89.             3. FILE_ID.DIZ import
  90.  
  91.             4. Rearchiving files
  92.  
  93.             5. Sorting by:
  94.  
  95.               Name
  96.               Date
  97.               Size
  98.               Description
  99.  
  100.             6. In-place editing of file descriptions
  101.  
  102.             7. Renaming files
  103.  
  104.             8. Full REXX Macro Integration
  105.  
  106.  
  107. ------------------------------------------------------------------------------
  108. --- Registration -------------------------------------------------------------
  109. ------------------------------------------------------------------------------
  110.  
  111.         I'm going to keep this short, sweet and to the point. It is
  112.         $25 to register the program. You may use this version of
  113.         MaxFile/PM for 45 days from the day you first run it. After the
  114.         45 day evaluation period it will no longer operate.
  115.  
  116.         MaxFile/PM is not free ware, its share ware, you are expected to
  117.         register the program if you continue using it.
  118.  
  119.         Please print out and read the REGISTER.FRM file that is included
  120.         in the archive for more information on registering the program.
  121.  
  122.         Registration provides me with the incentive to keep working on
  123.         the program, it's all up to you folks that use the program. I
  124.         treat registered users VERY well.
  125.  
  126.         'Nuff said...
  127.  
  128.  
  129. ------------------------------------------------------------------------------
  130. --- Support ------------------------------------------------------------------
  131. ------------------------------------------------------------------------------
  132.  
  133.         If you need to contact me about the program I can be reached
  134.         in a number of places. NetMail will get you the fastest
  135.         response, but I read the OS2PRODSUP, OS2BBS and MUFFIN
  136.         conferences everyday and intend on answering any questions
  137.         posted there. There is also a local conference on my BBS
  138.         called MFILEPMSUP that you are more than welcome to poll for.
  139.         Contact either myself, Elliott Goodman at 1:102/1319 or Pete
  140.         Norloff at 1:109/347 for more information about getting hooked
  141.         up.
  142.  
  143.         Due to the large cost in crashing netmail all over the world I
  144.         will only be sending replies out crash to registered users who
  145.         report a problem. Sorry folks, but most of my income is
  146.         generated by these projects. If they don't get registered I
  147.         can't provide free support. I will respond to everyone who sends
  148.         netmail, but it will be routed netmail in most cases.
  149.  
  150.         While I will answer questions from those of you who have not
  151.         registered the program, you will get a much quicker response
  152.         from me if you have.
  153.  
  154.         I *will* support MaxFile/PM, all you need to do is ask.
  155.  
  156.  
  157. ------------------------------------------------------------------------------
  158. --- Before You Start - READ THIS!! -------------------------------------------
  159. ------------------------------------------------------------------------------
  160.  
  161.         The default installation of OS/2 defines Mouse Button 1 as the
  162.         left button and Mouse Button 2 as the right button. Please
  163.         keep this in mind as you read through this document if you
  164.         have redefined your mouse buttons.
  165.  
  166.         A word to the wise here..
  167.  
  168.                      BACKUP *BEFORE* USING MAXFILE/PM !
  169.  
  170.         Here comes the standard disclaimer...I don't promise that
  171.         MaxFile/PM will do anything for you except take up space on
  172.         your hard drive. While I am fairly certain I have got all the
  173.         nasties out of it, there is a chance that I may have missed
  174.         something. So please be safe and backup prior to using the
  175.         program. Suffice it to say, you have been warned..
  176.  
  177.  
  178. ------------------------------------------------------------------------------
  179. --- Configuring MaxFile/PM ---------------------------------------------------
  180. ------------------------------------------------------------------------------
  181.  
  182.         To configure MaxFile/PM for use, simply start MaxFile/PM by
  183.         typing MAXFMPM and pressing ENTER at an OS/2 Command Prompt.
  184.         The MaxFile/PM Settings notebook will be presented for you, so
  185.         that you can enter the vital information about your system and
  186.         BBS setup.
  187.  
  188.         The Settings Notebook is where you configure MaxFile/PM so
  189.         that it fits your particular system. There are a lot of
  190.         options here, some required, some not, all depending on
  191.         whether you want to be able to use that particular feature or
  192.         not. There are 4 major categories of information here; Main,
  193.         Archivers, Viewers and Other. Some of the categories have more
  194.         than one page devoted to them. A detailed discussion of the
  195.         categories follows.
  196.  
  197. Main - Basic information
  198.  
  199.         The Main section of the notebook consists of three pages that
  200.         contain the information that tells MaxFile/PM the basics about
  201.         your BBS configuration and how to handle certain options.
  202.  
  203. Main - Page 1
  204.  
  205.     Registration Key
  206.  
  207.         Your registration key, if you have one. If not leave it blank.
  208.         Make sure if you have registered an earlier version of
  209.         MaxFile/PM that you contact me to obtain a new key.
  210.  
  211.         Enter the registration key exactly the same as it is given to you.
  212.  
  213.     Registration Name
  214.  
  215.         Your name, this works in conjunction with the Registration Key
  216.         field. MaxFile/PM hashes your name against your Key to see if
  217.         you really are a registered user.
  218.  
  219.         The Registration XXXX fields when filled out properly, stop
  220.         the usage timer.
  221.  
  222.     BBS Package
  223.  
  224.         Four choices here:
  225.  
  226.             Maximus
  227.             Lora
  228.             SuperBBS
  229.             Generic
  230.  
  231.         Simply select one from the drop down list box. Or type in one
  232.         of the names in the list above.
  233.  
  234.     BBS Directory
  235.  
  236.         This is the directory that your BBS software resides in. Enter
  237.         the FULL path specification.
  238.  
  239.     Temp Directory
  240.  
  241.         This is the FULL path to an EXISTING directory that MaxFile/PM
  242.         can use to store temporary files in and use for rearchiving
  243.         files. Don't use this directory for ANYTHING else while
  244.         MaxFile/PM is running. EVERYTHING, INCLUDING ANY
  245.         SUB-DIRECTORIES WILL BE REMOVED BEFORE Maxfile/PM TERMINATES!
  246.  
  247.     File Area Data
  248.  
  249.         This is the FULL path and filename of the file that contains
  250.         your file area definitions. For Maximus 2.xx users this will
  251.         be AREA.DAT, for Lora users this will SYSFILE.DAT, for
  252.         SuperBBS users this will be FLSEARCH.BBS, for those using the
  253.         Generic setup this should be the name of the text file you
  254.         created according the guidelines in the "Generic File Area
  255.         Definitions" section.
  256.  
  257. Main - Page 2
  258.  
  259.     AutoSave
  260.  
  261.         This tells MaxFile/PM whether or not you want your FILES.BBS
  262.         files automatically saved when you close a file area. If you
  263.         check this option MaxFile/PM will save the FILES.BBS for you
  264.         as soon as you close the window associated with a FILES.BBS,
  265.         if not, it will prompt you and ask if you want the information
  266.         saved.
  267.  
  268.     Button Bar
  269.  
  270.         This check box tells MaxFile/PM whether or not you want the
  271.         button bar turned on in your FILES.BBS windows.
  272.  
  273.     Header Size
  274.  
  275.         For those of you using programs such as DownSort, this option
  276.         will allow you to tell MaxFile/PM how many lines at the
  277.         beginning of your FILES.BBS to skip when reading them in. The
  278.         headers ARE preserved when MaxFile/PM writes out a new
  279.         FILES.BBS.
  280.  
  281.     Dupe Length
  282.  
  283.         Tells MaxFile/PM how many characters to look at in a filename
  284.         when performing a search for duplicates.
  285.  
  286.     ED Marker
  287.  
  288.         For those BBS packages that support extended descriptions this
  289.         option will come in handy. Here you tell MaxFile/PM what
  290.         character is associated with extended descriptions for your
  291.         BBS Package. This character can not be a space or a dash.
  292.  
  293.         Defining this character causes a few changes in the way
  294.         MaxFile/PM handles your file descriptions. When this option is
  295.         used, file descriptions are allowed to be up to 1024
  296.         characters in length and nothing is stripped from FILE_ID.DIZ
  297.         descriptions read in from archives. MaxFile/PM does not insert
  298.         this character in multiple line descriptions for you, you need
  299.         to do this. However, when you use the 'Format Description'
  300.         MaxFile/PM will take care of putting this character where it
  301.         belongs.
  302.  
  303.         If this character is not defined, file descriptions are
  304.         limited to 255 characters, any non-printable ASCII characters
  305.         (0-31) and high-bit ASCII characters are stripped from the
  306.         file description.
  307.  
  308.     Default Description
  309.  
  310.         You may enter up to 80 characters for a default description.
  311.         This text will get used any time you Insert, Adopt or drop
  312.         files from an outside source into a window in MaxFile/PM and
  313.         those files meet the following criteria: 1, they are not an
  314.         archive or 2, they are an archive and the archive does not
  315.         contain a FILE_ID.DIZ description inside of it.
  316.  
  317.     File Database Utility
  318.  
  319.         The next field is for the filename of your File Database
  320.         Utility. For Maximus this will be either FB.EXE or FBP.EXE. On
  321.         my system I have this set to FBP, since the utility is in my
  322.         path. For Lora-BBS users, this will be FILEIDX.EXE. Please see
  323.         the "Known Problems" section at the end of this document for
  324.         more information about FILEIDX.EXE. For SuperBBS users, I
  325.         don't have a clue. If someone would fill me in on this one I'd
  326.         really appreciate it! This entry is only required if you want
  327.         MaxFile/PM to run the utility for you.
  328.  
  329.     Run FD Utility
  330.  
  331.         The options for Run FD Utility determine when and if the File
  332.         Database utility will get run. There are three; Always, Prompt
  333.         and Never. Always will run your file database utility
  334.         every time you exit MaxFile/PM. If no changes have been made,
  335.         it will prompt you before running it. Prompt will ask you if
  336.         you wish to run it. Do I need to explain Never? :-}
  337.  
  338.     Display
  339.  
  340.         The Display options control whether or not the file size and
  341.         date information gets displayed for your files in the
  342.         FILES.BBS windows. Simply check or un check the check boxes to
  343.         set your preferences.
  344.  
  345. Main - Page 3
  346.  
  347.     Extensions edit control
  348.  
  349.         This is a simple edit control that you use to enter in the
  350.         extensions that you want add to the list box to the right. You
  351.         may enter up to 3 characters for each extension, wild cards are
  352.         allowed. These extensions are used while adopting files,
  353.         anything not defined here will be ignored. These extensions are
  354.         use when you perform an Adopt from the FILES.BBS window context
  355.         menu or you have Auto Adopt turned on.
  356.  
  357.     Add button
  358.  
  359.         After entering an extension in the edit control click this
  360.         button to add it to the list of extensions in the list box.
  361.  
  362.     Remove button
  363.  
  364.         This button allows you to remove an entry from the list box.
  365.         Simply highlight the entry you want to remove from the list
  366.         box and click here.
  367.  
  368.     Auto Adopt
  369.  
  370.         This check box tells MaxFile/PM if you want it to automatically
  371.         perform an Adopt when a file area is first opened. This only
  372.         works if you have actually added at least one extension for
  373.         MaxFile/PM to scan for.
  374.  
  375.     Download counters
  376.  
  377.         If you want download counters added to the description of
  378.         files that get adopted, check this box.
  379.  
  380.     Add (x/xx) counter on description copy
  381.  
  382.         This option allows you to tell MaxFile/PM whether or not you
  383.         want the (xx of xx) counters appended onto the end of
  384.         descriptions when you perform a "Description->Copy" in a
  385.         FILES.BBS window. Check it if you want them, unchecked if you
  386.         don't. The default is for them to be added.
  387.  
  388.     Remove Items
  389.  
  390.         Three choices here:
  391.  
  392.             Prompt
  393.             Entries
  394.             Entries and Files
  395.  
  396.         This configuration option affects the default action of "Remove
  397.         Items" inside a FILES.BBS window. "Prompt" asks you each time.
  398.         "Entries" removes just the entries. "Entries and Files" removes
  399.         the entries and deletes the files associated with those entries.
  400.  
  401. Archivers - Archiver Information
  402.  
  403.     This section causes the most confusion when configuring
  404.     MaxFile/PM. The best I can do to help is to tell you what I use
  405.     here on my system to give you a few hints.
  406.  
  407.     There are eight pages, one each for; Zip, Arj, Lzh, Arc, HA, RAR,
  408.     UC2 and ZOO. I don't use HA, RAR or UC2 so you are on your own with
  409.     these archivers.
  410.  
  411.     You will need to enter the executable name and the appropriate
  412.     switches for each of the actions for each archiver. You should
  413.     include any switches necessary for recursing sub-directories and
  414.     if you want to make MaxFile/PM's job a little easier, any switches
  415.     to tell the archivers to 'move' files into archives when adding to
  416.     or creating a new archive. Below I will give a short description
  417.     of each entry and the settings for the archivers I use. You will
  418.     have MUCH better success with OS/2 based archivers.
  419.  
  420.     NOTE: Each of the archivers you use must be able to accept
  421.     filenames on the command line other than just the archive name.
  422.     Some versions of UNARJ do not allow you to do this. F'REQ
  423.     GNUNARJ.* from me if you need an updated version that allows
  424.     filenames.
  425.  
  426.     I also believe I have gotten the DOS kludge worked around in the
  427.     code. So you *should* be able to just define your DOS archivers just
  428.     like OS/2 based archivers, I.E, PKUNZIP -v, for listing an archive.
  429.     The settings for the DOS archivers below worked for me for what
  430.     little time I spent with them.
  431.  
  432.         Extract
  433.  
  434.             This entry should contain the command and switches
  435.             necessary to extract a file from an archive.
  436.  
  437.                 ZIP     unzip -xo -U
  438.                 ARJ     unarj e
  439.                 ARJ     x -y
  440.                 LZH     lh x
  441.                 ARC     arc x
  442.                 RAR     rar -o+ -y
  443.                 HA      ha ey
  444.                 UC2     uc2 ESF
  445.                 ZOO     zoo xO
  446.  
  447.         Add
  448.  
  449.             This entry should contain the command and switches
  450.             necessary to add files to an archive.
  451.  
  452.                 ZIP     zip -9 -r
  453.                 ARJ     a -r -y
  454.                 LZH     lh a
  455.                 ARC     arc a
  456.                 RAR     a -r -y -ep1
  457.                 HA      ha a12rd
  458.                 UC2     uc ASF
  459.                 ZOO     zoo ah
  460.  
  461.         List
  462.  
  463.             This entry should contain the command and switches
  464.             necessary to list the files in an archive to standard
  465.             output.
  466.  
  467.                 ZIP     unzip -v
  468.                 ARJ     unarj l
  469.                 ARJ     arj v -y
  470.                 LZH     lh l
  471.                 ARC     arc l
  472.                 RAR     v -y
  473.                 HA      l
  474.                 UC2     VS
  475.                 ZOO     zoo L
  476.  
  477.         Test
  478.  
  479.             This entry should contain the command and switches
  480.             necessary to test the integrity of an archive with the
  481.             output going to standard output.
  482.  
  483.                 ZIP     unzip -t
  484.                 ARJ     unarj t
  485.                 ARJ     arj t -y
  486.                 LZH     lh t
  487.                 ARC     arc v
  488.                 RAR     t -std -y
  489.                 HA      t
  490.                 UC2     TF
  491.                 ZOO     zoo xN
  492.  
  493. Viewers - File Viewers
  494.  
  495.     Here you can define viewers for use with the View function in a
  496.     FILES.BBS window. Enter the filename and any necessary switches
  497.     for each of the programs. There are entries for the following file
  498.     types:
  499.  
  500.         GIF
  501.         PCX
  502.         JPG
  503.         TIF
  504.         BMP
  505.         Other
  506.  
  507.     The 'Other' entry catches anything that is not an archive, GIF,
  508.     PCX, JPG, TIF or BMP file. I.E, text files.
  509.  
  510. Other - Things I couldn't figure out where else to put. :-)
  511.  
  512.     Virus Scanner
  513.  
  514.         This should be the name of the program to scan files for
  515.         viruses, make sure to include any necessary switches. I use
  516.         McAfee's scanner for OS/2 like so:
  517.  
  518.             OS2SCAN /A /NOEXPIRE
  519.  
  520.     Editor
  521.  
  522.         Here you can define a text editor for editing text based files.
  523.         Currently this is only used for editing REXX macro scripts.
  524.  
  525.     Shift F6
  526.     Shift F7
  527.     Shift F8
  528.     Shift F9
  529.     Shift F10
  530.  
  531.         These five entries are for things I may have overlooked or for
  532.         some special processing that you would like to do to a file.
  533.         Enter the program name and any switches they need. When in a
  534.         FILES.BBS window and you press one of the above keystrokes,
  535.         the appropriate entry will get started with one of the
  536.         selected files as a parameter on its command line, this will
  537.         continue one file at a time until all selected files have been
  538.         processed.
  539.  
  540.  
  541. ------------------------------------------------------------------------------
  542. --- Generic File Area Definitions --------------------------------------------
  543. ------------------------------------------------------------------------------
  544.  
  545.         To provide support for any BBS system that uses the standard
  546.         FILES.BBS format for their file listings I have come up with a
  547.         very simple text file format that will allow you to tell
  548.         MaxFile/PM how your file areas are defined.
  549.  
  550.         The file is made up of a verb that tells MaxFile/PM how many
  551.         areas it can expect to find in the text file. Each successive
  552.         line after that verb defines the file areas themselves. A
  553.         sample file is shown below:
  554.  
  555. ----------------------------- AREAS.CFG sample --------------------------------
  556. AreaCount 5
  557. 0 d:\max\file\un check    d:\max\file\un check\files.bbs    Unchecked Uploads
  558. 1 d:\max\file\max        d:\max\file\max\files.bbs        BBS Stuff
  559. 2 d:\max\file\dos\games  d:\max\file\dos\games\files.bbs  Dos Games
  560. 3 d:\max\file\os2\util   d:\max\file\os2\util\files.bbs   OS/2 Utilities
  561. 4 d:\max\file\os2\apps   d:\max\file\os2\apps\files.bbs   OS/2 Applications
  562. -------------------------------------------------------------------------------
  563.  
  564.         The 'AreaCount' keyword tells MaxFile/PM how many area
  565.         definitions it can expect to find in the file. The AreaCount
  566.         keyword must come BEFORE the area definition lines.
  567.  
  568.         The format for each area definition line is:
  569.  
  570.             <area tag> <file path> <list name> <area description>
  571.  
  572.      ────────────────────────────────────────────────────────────────────
  573.       <area tag>           Is a short name to identify the file area.
  574.  
  575.       <file path>          Is the download path of the file area.
  576.  
  577.       <list name>          Is the full drive:\path and filename of the
  578.                            FILES.BBS for the area.
  579.  
  580.       <area description>   Is a short description of the area.
  581.      ────────────────────────────────────────────────────────────────────
  582.  
  583.         You can name this file what ever you wish, just make sure you
  584.         specify the name of this file for the File Area Data option in
  585.         the Main Settings Dialog and make sure the BBS Package is set
  586.         to 'Generic'.
  587.  
  588. ------------------------------------------------------------------------------
  589. --- Using MaxFile/PM ---------------------------------------------------------
  590. ------------------------------------------------------------------------------
  591.  
  592.         When MaxFile/PM first comes up a window will be displayed that
  593.         contains all of your file areas. I will be referring to this
  594.         window by the term 'File Area Window' throughout the rest of
  595.         this document.
  596.  
  597.         When you open up a file area, a window that is very similar in
  598.         appearance to the File Area window will appear. This window
  599.         will contain all the files listed in the FILES.BBS for that
  600.         area. These windows will be referred to as 'FILES.BBS Windows'
  601.         from here on out.
  602.  
  603. --- File Area Window ---------------------------------------------------------
  604. ------------------------------------------------------------------------------
  605.  
  606.         The File Area window serves two basic purposes. First, it
  607.         allows you to open FILES.BBS Windows and second, it also
  608.         serves as a dropping point for files so that you can quickly
  609.         move files to another file area without having to open the
  610.         file area.
  611.  
  612.     File Area Window Context Menu
  613.  
  614.     The File Area Window Context Menu is where you control the overall
  615.     operations of MaxFile/PM. A somewhat detailed explanation of each
  616.     menu item follows.
  617.  
  618.     Open...
  619.  
  620.         This menu item allows you to open the highlighted file area(s).
  621.  
  622.         The various ways of opening a file area are: Highlighting the
  623.         area you want to open and pressing enter or double-clicking
  624.         mouse button 1 on a file area.
  625.  
  626.         If the file area is already open it will be brought into view,
  627.         even if it is minimized to the Minimized Window Viewer folder.
  628.  
  629.  
  630.     Area Sort
  631.  
  632.         Tag
  633.         Description
  634.         Files Dir
  635.  
  636.         These options sort the File Area Window listing by the
  637.         appropriate field in ascending order.
  638.  
  639.  
  640.     Check for Duplicates
  641.  
  642.         To check your file areas for duplicate files choose this menu
  643.         item after selecting the area(s) you want MaxFile/PM to check
  644.         against all of your file areas. Please note that the scan
  645.         performed when checking for duplicates does not involve the
  646.         FILES.BBS files for the areas scanned, it looks at the contents
  647.         of the download directory for each area. So all duplicates will
  648.         be found regardless of whether there is a FILES.BBS entry for
  649.         them or not. However, the files searched for come directly from
  650.         the FILES.BBS files of the areas selected in the File Area
  651.         window. So make sure if you have a FILES.BBS window open for one
  652.         of the areas you will be checking for duplicates from, that you
  653.         have saved any changes made in that window.
  654.  
  655.         The File Area window will be locked open until you close the
  656.         DupeCheck Results dialog box. This dialog will appear as soon as
  657.         the file scanning is complete. Inside this dialog you will see a
  658.         listing of all the files found. To open the file area associated
  659.         with a file, simply double-click on its entry. If you decide
  660.         that you want to delete the file from this dialog, highlight the
  661.         entry and click the delete button.
  662.  
  663.  
  664.     Search...
  665.  
  666.         This function is very similar to the Dupe Checker option, with
  667.         the exception that instead of checking for duplicate files you
  668.         can enter a string of text that MaxFile/PM will search for in
  669.         each of the FILES.BBS files for each of the selected areas.
  670.  
  671.         First select the areas that you want to search, then bring up
  672.         the context menu and select 'Search...' A dialog box will come
  673.         up asking you what to search for. You may enter up to 80
  674.         characters. Click ok to begin the search.
  675.  
  676.         The search is not case nor position sensitive. Both the filename
  677.         and description are searched for the text, if the text appears
  678.         in of these two places a 'hit' will occur. The dialog box that
  679.         comes up after the search is complete works exactly the same as
  680.         the dialog box showing the results of the Dupe Checker option.
  681.  
  682.  
  683.     All Files List
  684.  
  685.         Probably the most requested feature had to be the ability to
  686.         generate a list of available files from the FILES.BBS listings.
  687.         MaxFile/PM will generate an all files list for you. It's highly
  688.         customizable and can be run automagically from a batch file once
  689.         configured correctly.
  690.  
  691.         To use the all files generator interactively, simply start
  692.         MaxFile/PM and then select the areas from the File Area window
  693.         that you want included in the listing. Then bring up the context
  694.         menu and select "All Files List". MaxFile/PM will then process
  695.         each FILES.BBS and produce a listing under the filename
  696.         ALLFILES.LST in the directory that MaxFile/PM resides in.
  697.  
  698.         Each time you run the all files generator from the context menu,
  699.         a file called ALLFILES.CFG will be written that contains a list
  700.         of the area tags for each of the areas in the listing. Do NOT
  701.         modify this file. The purpose behind this file is to tell
  702.         MaxFile/PM what areas to include when you run the all files
  703.         generator in batch mode. If you add or delete file areas, you
  704.         MUST run the all files generator from the context menu in
  705.         interactive mode at least once to keep the ALLFILES.CFG in sync
  706.         with your file areas. I'll put it this way... IF YOU WANT TO RUN
  707.         IN BATCH MODE YOU MUST KEEP allfiles.cfg IN SYNC WITH YOUR FILE
  708.         AREAS.
  709.  
  710.         To customize the all files generator to suit your tastes, you
  711.         can create three text files which will be written to your file
  712.         listing at the appropriate times.
  713.  
  714.         The names for the files are:
  715.  
  716.             ALLFILES.HDR
  717.             ALLFILES.FTR
  718.             ALLFILES.CUS
  719.  
  720.         ALLFILES.HDR and ALLFILES.FTR are written verbatim to the file
  721.         listing at the beginning and ending of the listing,
  722.         respectively. ALLFILES.CUS is a little more complex. It allows
  723.         you to insert text into the headers that are written to the
  724.         listing for each file area. The format of the file is:
  725.  
  726.             <AreaTag> <Header text......>
  727.  
  728.         <AreaTag> is the area tag of the file area header the text that
  729.         follows it should be inserted into. You may place as many lines
  730.         as you need to for each area as long as they all follow this
  731.         format. <AreaTag> is checked against the area tag for each area
  732.         in such a manner that if the tag for the area begins with the
  733.         tag specified in this file the text will get inserted. An
  734.         example might be of some help here..
  735.  
  736.         You have the following areas:
  737.  
  738.             CICA001
  739.             CICA002
  740.             CICB001
  741.             001
  742.             002
  743.  
  744.         In your ALLFILES.CUS file you have:
  745.  
  746.             CICA Files in this area are NOT freq'able.
  747.             CIC These files are on my CD-ROM.
  748.             00 These files are freq'able anytime but ZMH.
  749.  
  750.         CICA would match CICA001 and CICA002. CIC would match CICA001,
  751.         CICA002 and CICB002. 00 would match 001 and 002. Get the idea?
  752.         Its rather simple once you get used it.
  753.  
  754.         To run the all files generator in batch mode from the command
  755.         line, specify the -A switch on MaxFile/PM's command line.
  756.         MaxFile/PM will do its thing and then return to the command
  757.         prompt when it is done. -a, -A, /a and /A are all recognized as
  758.         valid switches for this mode of operation.
  759.  
  760.  
  761.     Outdated Files...
  762.  
  763.         This option will allow you to either remove or move to a file
  764.         area those files that are older than a certain number of days.
  765.  
  766.         The process of taking care of your outdated files begins by
  767.         selecting the areas that you wish to scan from the File Area
  768.         window. Now, bring up the context menu and select 'OutDated
  769.         Files...', you will be presented with a dialog box, this is
  770.         where you tell MaxFile/PM how to manage the old files.
  771.  
  772.         To remove files, select the Kill radio button. To move files to
  773.         a selected file area, select the Move radio button and then
  774.         enter the Area Tag of the file area you want the files to go
  775.         into. The Area Tag you type in MUST exactly match one of the
  776.         area tags listed in the first column of the File Area window,
  777.         upper and lower case letters are important here.
  778.  
  779.         Now you need to tell MaxFile/PM the number of days old a file
  780.         has to be before it will be moved or deleted. Either type in the
  781.         number of days or use the spin button to adjust the number of
  782.         days to your liking. To give you some indication of the date
  783.         range you will be working with, the date below the spin button
  784.         will tell you what the date on the oldest file can be.
  785.  
  786.         After entering the above, click OK and sit back and let
  787.         MaxFile/PM do its thing. If a file area you have selected is
  788.         open, it will be skipped. Also, if you are moving files, the
  789.         file area that will receive the dated files will be skipped.
  790.  
  791.  
  792.     Create FREQ List...
  793.  
  794.         Here you can tell MaxFile/PM to create an OKFILE listing for
  795.         your mailer based on the selected items in the File Area window.
  796.  
  797.         After selecting this option, you will be presented with a
  798.         standard File Save As dialog to choose a filename from. You can
  799.         either type in the name of an existing file, or the name you
  800.         want the listing to have. If it doesn't exist MaxFile/PM will
  801.         create it for you.
  802.  
  803.         If the file "MAGIC.TXT" exists in the directory you start
  804.         MaxFile/PM from, the entries in it will be copied to the output
  805.         file. The directory listing will then be appended to the output
  806.         file.
  807.  
  808.  
  809.     REXX Macro...
  810.  
  811.         Don't like the way MaxFile/PM does something? Well, now YOU can
  812.         change it! REXX scripts are now supported. In addition to all
  813.         the commands available from REXX, there are 21 REXX extensions
  814.         added by MaxFile/PM so that you can manipulate your files from a
  815.         REXX command script.
  816.  
  817.         A discussion of REXX is well beyond the scope of this document,
  818.         instead what you will read about here are the extensions that
  819.         MaxFile/PM adds to REXX to allow you to work with your files.
  820.         The supplied TESTREXX.CMD file is a sample that shows the syntax
  821.         and usage of each of the added functions. PLEASE use this file
  822.         as a guide when you are constructing your macros.
  823.  
  824.         REXX commands and programs that communicate with the user via
  825.         Standard input and Standard output are fully supported by
  826.         MaxFile/PM's REXX interface. When the REXX interface first
  827.         starts up a window entitled "MaxFile/PM REXX Output" will appear
  828.         on your desktop, this window is your means of communication with
  829.         REXX.
  830.  
  831.         The top line of the REXX output window contains a single line
  832.         edit control that can accept up to 80 characters. When you wish
  833.         to actually send the typed text to standard input, click on the
  834.         Send button. Clicking on the Send button when the control is
  835.         empty sends a CR/LF pair to standard input.
  836.  
  837.         The remainder of the output window is reserved for the output
  838.         coming from your REXX commands and/or application programs.
  839.         REXX's PULL and SAY commands are fully supported. There are some
  840.         limitations to what the output window can do though. It doesn't
  841.         support; reverse tabs, vertical tabs, backspace or cursor
  842.         movements. For applications that use this type of output or
  843.         expect to be able to write to the screen using other methods
  844.         than standard output you are going to need to use the START
  845.         command or some other similar utility to run them in another
  846.         session.
  847.  
  848.         To stop a REXX script that is running, bring the Main File Area
  849.         window to the front and pull up the context menu, then select
  850.         'Stop REXX' this will halt the script after the current
  851.         instruction is complete.
  852.  
  853.         Starting MaxFile/PM with the -r switch will cause MaxFile/PM to
  854.         open its main window, immediately run the REXX script specified
  855.         and then exit. An example:
  856.  
  857.             MAXFMPM -rTESTREXX.CMD
  858.  
  859.         Would start MaxFile/PM, run TESTREXX.CMD to completion and then
  860.         exit. -r -R /r and /R are all valid forms of the "REXX"
  861.         switch.
  862.  
  863.         Listed below you will see the REXX extensions for use with
  864.         MaxFile/PM, they will be listed by name with a short explanation
  865.         of each. All the functions return 'ERROR' if something goes
  866.         wrong. Those functions that aren't meant to return some type of
  867.         information return 'OK' for success. If a syntax error occurs,
  868.         processing of the script stops and the error cause can be found
  869.         in the file REXX.ERR in the directory MaxFile/PM resides in.
  870.  
  871.                   *******************************************
  872.                   *   PAY ATTENTION TO THE NEXT PARAGRAPH   *
  873.                   * IT WILL MAKE OR BREAK YOUR REXX SCRIPTS *
  874.                   *******************************************
  875.  
  876.         You *MUST* be in the directory that MaxFile/PM resides in when
  877.         you call one of the extensions added by MaxFile/PM. You can
  878.         change directories throughout the lifetime of your script, but
  879.         MaxFile/PM needs to be able to find its files and it expects
  880.         them to be in the directory that your script gets called from.
  881.         So if things start acting strangely when you are testing a
  882.         script, make sure the current directory is your MaxFile/PM
  883.         directory before you call one of the extensions listed here. The
  884.         standard REXX function DIRECTORY() will return the current
  885.         directory for you, use it to save the directory your script
  886.         starts out in. Then just before your script ends, use it to
  887.         restore the current directory.
  888.  
  889.  
  890.                          MaxFile/PM REXX Extensions
  891.                          --------------------------
  892.  
  893.         MPM_GetVersion()
  894.  
  895.             Returns MaxFile/PM's revision or version number.
  896.  
  897.  
  898.         MPM_ClearWindow()
  899.  
  900.             Clears the REXX output window.
  901.  
  902.  
  903.         MPM_MsgBox(message, title)
  904.  
  905.             Displays a simple message box using 'message' as the text
  906.             displayed in the message box and 'title' as the title for
  907.             the message box.
  908.  
  909.  
  910.         MPM_QueryArea([area tag])
  911.  
  912.             Works in two different ways. Called with no arguments it
  913.             returns the area tag of the first file area listed in the
  914.             Main File Area window listing. When called with a single
  915.             argument containing the area tag of an existing file area,
  916.             it will return the area tag of the NEXT file area in the
  917.             list. In either case, if an area can't be found it returns
  918.             'ERROR'.
  919.  
  920.  
  921.         MPM_QueryAreaList('stemvar')
  922.  
  923.             Creates a compound stem variable containing the area tag,
  924.             description, download path and the full path/filename of the
  925.             FILES.BBS for each area.
  926.  
  927.             The stem variable name is passed to the function as a
  928.             string. stemvar.0 contains the total number of areas that
  929.             information has been returned for.
  930.  
  931.             An example of how to use this function follows:
  932.  
  933.                 /* MPM_QueryAreaList() example */
  934.                 rc = MPM_QueryAreaList('arealist')
  935.  
  936.                 Say arealist.0' items in Area List.'
  937.                 Say arealist.1.area' is the first area.'
  938.                 Say arealist.1.desc' is the first area description.'
  939.                 Say arealist.1.path' is the first area download path.'
  940.                 Say arealist.1.fbbs' is the first area FILES.BBS location.'
  941.  
  942.  
  943.         MPM_QueryAreaInfo(area tag, '0' | '1' | '2')
  944.  
  945.             Queries and returns the specified information for 'area
  946.             tag.' The level info is as follows:
  947.  
  948.                 0 - Area description
  949.                 1 - Download Path
  950.                 2 - FILES.BBS Location
  951.  
  952.  
  953.         MPM_DeselectArea(area tag)
  954.  
  955.             Detags a file area in the Main File Area window.
  956.  
  957.  
  958.         MPM_SelectArea(area tag)
  959.  
  960.             Tags a file area in the Main File Area Window.
  961.  
  962.  
  963.         MPM_OpenArea(area tag)
  964.  
  965.             Opens the FILES.BBS Window associated with 'area tag'.
  966.  
  967.  
  968.         MPM_CloseArea(area tag)
  969.  
  970.             Closes the FILES.BBS window associated with 'area tag.'
  971.  
  972.  
  973.         MPM_IsAreaOpen(area tag)
  974.  
  975.             Returns "1" if the FILES.BBS window associated with 'area
  976.             tag' is open, "0" otherwise.
  977.  
  978.  
  979.         MPM_SetFDUFlag(area tag)
  980.  
  981.             Sets the File Database Utility flag for the FILES.BBS that
  982.             is associated with 'area tag.' Use this to tell MaxFile/PM
  983.             that the File Database Utility needs to be run to update
  984.             your file database after making changes that MaxFile/PM
  985.             doesn't know about.
  986.  
  987.  
  988.         MPM_QueryFile(area tag[, filename])
  989.  
  990.             Returns the base filename of a file from a FILES.BBS window.
  991.             When called with just the area tag of an open window it
  992.             returns the first file in the window. When called with both
  993.             the area tag and an existing filename it will return the
  994.             NEXT filename in the window. If something goes wrong it
  995.             returns ERROR.
  996.  
  997.  
  998.         MPM_QueryFileList(area tag, 'stemvar')
  999.  
  1000.             Creates a compound stem variable containing a list of all
  1001.             the files in the FILES.BBS associated with 'area tag'. The
  1002.             stem variable name is passed as a string to the function.
  1003.             stemvar.0 contains how many items are in the list.
  1004.  
  1005.             An example follows:
  1006.  
  1007.                 /* MPM_QueryFileList() example */
  1008.                 Call RxFuncAdd 'SysSleep', 'RexxUtil', 'SysSleep'
  1009.                 mpmarea = 'TEST'
  1010.  
  1011.                 /* Open up the file area */
  1012.                 retval = MPM_OpenArea(mpmarea)
  1013.                 /* Give the open call a chance to work */
  1014.                 Call SysSleep 3
  1015.  
  1016.                 If MPM_IsAreaOpen(mpmarea) = '0' then Exit
  1017.  
  1018.                 rc = MPM_QueryFileList(mpmarea, 'files')
  1019.  
  1020.                 rc = MPM_CloseArea(mpmarea)
  1021.  
  1022.                 Say 'There are 'files.0' files in the list.'
  1023.                 Say
  1024.                 Say files.1.file' is the first file.'
  1025.                 Say files.1.path' is the path of the first file.'
  1026.                 Say files.1.desc' is the description of the first file.'
  1027.  
  1028.  
  1029.         MPM_QueryFileInfo(area tag, filename, '0' | '1' | '2' | '3')
  1030.  
  1031.             Queries and returns the specified information about
  1032.             'filename.' The level information is as follows:
  1033.  
  1034.                 0 - File Path
  1035.                 1 - File Date in DD MMM YYYY format
  1036.                 3 - File Size
  1037.                 4 - File Description
  1038.  
  1039.  
  1040.         MPM_SelectFile(area tag, filename)
  1041.         MPM_DeselectFile(area tag, filename)
  1042.  
  1043.             Select and deselect 'filename', respectively, in the area
  1044.             identified by 'area tag'.
  1045.  
  1046.  
  1047.         MPM_SetFileInfo(area tag, filename, '0' | '1' | '2')
  1048.  
  1049.             Set the displayed information for a file in a FILES.BBS
  1050.             window. The level information is as follows:
  1051.  
  1052.                 0 - Set File Date
  1053.                 1 - Set File Size
  1054.                 2 - Set Description
  1055.  
  1056.             Please note that options 0 and 1 are only for display
  1057.             purposes, if you want to set the file's date ("touch" it)
  1058.             you need to perform this yourself, MaxFile/PM does not do
  1059.             this for you, the same goes for the file's size. This REXX
  1060.             extension is merely to update the display in the FILES.BBS
  1061.             window. Option 2, for setting descriptions, does actually
  1062.             alter the description that will get saved for the file.
  1063.  
  1064.             Dates should be in the FTSC format DD MMM YYYY, 01 Dec 1993.
  1065.             Sizes should be unformatted with no thousands separators.
  1066.  
  1067.  
  1068.         MPM_RemoveFile(area tag, filename)
  1069.  
  1070.             Removes the file 'filename' from the FILES.BBS window
  1071.             associated with 'area tag'.
  1072.  
  1073.  
  1074.         MPM_AddFile(area tag, filename, description)
  1075.  
  1076.             Adds 'filename' with description to the FILES.BBS window
  1077.             associated with 'area tag'. 'filename' MUST be a FULL file
  1078.             specification in the form of D:\PATH\FILENAME.EXE! The
  1079.             function returns 'ERROR' if something goes wrong.
  1080.  
  1081.  
  1082.         MPM_AnnounceFiles('stemvar')
  1083.  
  1084.             Creates a file announcement message and writes it to a
  1085.             Squish or *.MSG message base. The message is built from the
  1086.             information stored in the compound stem variable 'stemvar'.
  1087.  
  1088.             Please see TANN.CMD (included in the distribution archive)
  1089.             for an example of how to use this extension.
  1090.  
  1091.             The elements of the message that need to be placed in
  1092.             'stemvar' are as follows:
  1093.  
  1094.                 stemvar.msgpath  - is the root path of the message area
  1095.                                    to place the message in.
  1096.  
  1097.                 stemvar.msgproc  - is the executable name and switches
  1098.                                    needed to run your mail
  1099.                                    tosser/packer, this one is optional,
  1100.                                    if it isn't defined it is ignored.
  1101.  
  1102.                 stemvar.msgtype  - this defines the type of message base
  1103.                                    and must be one of:
  1104.  
  1105.                                        SQUISH
  1106.                                        MSG
  1107.                                        MSGECHO
  1108.  
  1109.                 stemvar.msgflag  - is the message flag you want to use
  1110.                                    for this message, it must be one of:
  1111.  
  1112.                                        HOLD
  1113.                                        NORMAL
  1114.                                        CRASH
  1115.  
  1116.                 stemvar.to       - is the name to address the message
  1117.                                    to, if it isn't defined it defaults
  1118.                                    to 'All'.
  1119.  
  1120.                 stemvar.toaddr   - this the Fidonet style address of the
  1121.                                    recipient of the message. It must be
  1122.                                    in the format Zone:Net/Node.Point,
  1123.                                    I.E, 1:201/60.0, if not defined it
  1124.                                    defaults to stemvar.fromaddr.
  1125.  
  1126.                 stemvar.from     - is the name the message is from, this
  1127.                                    one is required.
  1128.  
  1129.                 stemvar.fromaddr - is the address of who the message is
  1130.                                    from, in other words, the originating
  1131.                                    Fidonet address. This one is also
  1132.                                    required.
  1133.  
  1134.                 stemvar.subject  - this gets put in the subject field of
  1135.                                    the message. If not defined it
  1136.                                    defaults to 'File Announcement'.
  1137.  
  1138.                 stemvar.header   - is the header of the message, it gets
  1139.                                    placed just before the file list in
  1140.                                    the message. This one is optional.
  1141.                                    1024 character limit.
  1142.  
  1143.                 stemvar.footer   - this is similar to the header, except
  1144.                                    it comes after the file list in the
  1145.                                    message. It is also optional. 1024
  1146.                                    character limit.
  1147.  
  1148.                 stemvar.origin   - this is the text that will get put in
  1149.                                    the origin line of the message. The
  1150.                                    " * Origin: " and from fidonet
  1151.                                    address are taken care for you. All
  1152.                                    you need to enter here is what text
  1153.                                    you want added in between the two.
  1154.                                    This is optional, if it is not
  1155.                                    defined no origin line is generated.
  1156.  
  1157.                 stemvar.0        - contains the number files being
  1158.                                    announced.
  1159.  
  1160.                 stemvar.x.file   - this is the base filename of a file
  1161.                                    to announce.
  1162.  
  1163.                 stemvar.x.path   - is the drive and path to the above
  1164.                                    base filename. Do NOT include the
  1165.                                    filename here.
  1166.  
  1167.                 stemvar.x.desc   - this is the description you want to
  1168.                                    use for this file in the message.
  1169.                                    1024 character limit.
  1170.  
  1171.                 'x' in the above three is a place holder for each of the
  1172.                 files that you want announced, up to stemvar.0 files.
  1173.  
  1174.  
  1175.         MPM_Crc32('filename')
  1176.  
  1177.             Examines 'filename' and returns a CRC32 value calculated
  1178.             according to FIPS PUB 71 and FED-STD-1003. This should prove
  1179.             useful for rolling your own TIC processor.
  1180.  
  1181.  
  1182.     Stop REXX
  1183.  
  1184.         Stops the currently running REXX macro. The current instruction
  1185.         in the macro will finish executing before the macro stops.
  1186.  
  1187.  
  1188.     Edit REXX Macro...
  1189.  
  1190.         Here you can find and edit a REXX macro script, provided you
  1191.         have an editor defined in your configuration.
  1192.  
  1193.         After selecting this option you will be presented with a
  1194.         standard file dialog to select from the files on your system.
  1195.         After selecting a file, the editor you have configured will be
  1196.         started with the selected file as its one and only argument.
  1197.  
  1198.  
  1199.     Settings...
  1200.  
  1201.         Brings up the Settings Notebook for MaxFile/PM. Please see
  1202.         'Configuring MaxFile/PM' for more information.
  1203.  
  1204.  
  1205.     Product Information
  1206.  
  1207.         Displays MaxFile/PM's Product Information Dialog.
  1208.  
  1209.  
  1210. --- FILES.BBS Window ---------------------------------------------------------
  1211. ------------------------------------------------------------------------------
  1212.  
  1213.         FILES.BBS windows are the heart and soul of MaxFile/PM, these
  1214.         windows are where you will be spending most of your time. A
  1215.         FILES.BBS window is very similar to the File Area window in
  1216.         appearance. What you will see when you open one of these
  1217.         windows is the contents of the FILES.BBS that is associated
  1218.         with the file area this window belongs to.
  1219.  
  1220.     FILES.BBS Window Context Menu
  1221.  
  1222.     Save FILES.BBS
  1223.  
  1224.         Performs an unconditional save of the FILES.BBS for the
  1225.         current FILES.BBS Window. At the same time it also sets the
  1226.         flag for this area to tell MaxFile/PM that the File Database
  1227.         Utility (if you have one configured) needs to be run on it.
  1228.  
  1229.  
  1230.     Sort Ascending
  1231.  
  1232.         Name
  1233.         Date
  1234.         Size
  1235.         Description
  1236.  
  1237.         Sorts the FILES.BBS entries for the current FILES.BBS Window
  1238.         in ascending order.
  1239.  
  1240.  
  1241.     Sort Descending
  1242.  
  1243.         Name
  1244.         Date
  1245.         Size
  1246.         Description
  1247.  
  1248.         Sorts the FILES.BBS entries for the current FILES.BBS Window
  1249.         in descending order.
  1250.  
  1251.         Please note the following; If you want the entire FILES.BBS
  1252.         sorted make sure that none of the items in the window are
  1253.         selected. If any items are selected ONLY those items get
  1254.         sorted. Deselect All or CTRL+\ will remove the selection
  1255.         emphasis on all items in the window. This applies to both
  1256.         ascending and descending sorts.
  1257.  
  1258.  
  1259.     Descriptions
  1260.  
  1261.         Copy
  1262.  
  1263.             This selection takes the first description from a group of
  1264.             selected items and copies it to the rest of the files in
  1265.             the group. The copied description will have '(xx of xx)'
  1266.             appended to the end of it. This is convenient to use with
  1267.             a group of files that are all part of one program or file
  1268.             collection.
  1269.  
  1270.  
  1271.         Cleanse
  1272.  
  1273.             This option goes through each of the selected items in a
  1274.             FILES.BBS window and removes all the extra whitespace,
  1275.             non-printable ASCII and high-ASCII characters from the
  1276.             descriptions or comments.
  1277.  
  1278.  
  1279.         Edit
  1280.  
  1281.             Many of you asked for this one. Edit Description allows
  1282.             you to edit the description of a selected item by first
  1283.             selecting it, then choosing this option from the context
  1284.             menu. It works the same way as ALT+clicking mouse button 1
  1285.             on an item's description.
  1286.  
  1287.  
  1288.         Format...
  1289.  
  1290.             This option is only usable when you have an Extended
  1291.             Description Marker (ED Marker) defined in the Settings
  1292.             Notebook. In a nutshell what it does is take a file
  1293.             description and break it up into smaller parts and insert
  1294.             the defined ED Marker at the beginning of the excess lines
  1295.             so that your BBS package will understand the excess lines
  1296.             are part of the description for a file.
  1297.  
  1298.             After selecting this option from the context menu a dialog
  1299.             box will be presented asking you for a left margin and a
  1300.             line length. The left margin is where you want the ED
  1301.             Marker placed on the line and the line length is how many
  1302.             characters past the ED Marker the description is allowed
  1303.             to go on each line.
  1304.  
  1305.         Get FILE_ID.DIZ
  1306.  
  1307.             This option goes through the selected items in the window
  1308.             and attempts to extract the FILE_ID.DIZ from them.
  1309.             Comments and files that aren't archives are skipped over
  1310.             by this function. If a FILE_ID.DIZ is present in the
  1311.             archives selected, it will be read from it and placed in
  1312.             the description field. You will need to edit this text to
  1313.             suit your needs.
  1314.  
  1315.  
  1316.         Set FILE_ID.DIZ
  1317.  
  1318.             Here you can insert the file description for selected
  1319.             archives into the archives as a FILE_ID.DIZ. You will need
  1320.             to edit the description to conform to the 45/10 standard.
  1321.  
  1322.  
  1323.     Files
  1324.  
  1325.         Adopt
  1326.  
  1327.             Adopt Files allows you to add any orphan files in a
  1328.             particular file area to the FILES.BBS for that area.
  1329.             Adopting is performed in a separate thread so that you may
  1330.             continue to work in the window for the file area while the
  1331.             adopt is going on. The window will be locked open while
  1332.             the Adopt is being performed.
  1333.  
  1334.  
  1335.         Remove Missing
  1336.  
  1337.             This option automates the process of removing entries in a
  1338.             FILES.BBS window that have no file associated with them.
  1339.  
  1340.             No special setup is required, just bring up the context menu
  1341.             and select this option. MaxFile/PM will then search through
  1342.             the FILES.BBS window and remove all entries that meet the
  1343.             following criteria; The entry is a file, is 0 bytes in size
  1344.             and has a date/time stamp of 00/00/00 00:00:00.
  1345.  
  1346.  
  1347.         Purge Dupes
  1348.  
  1349.             Purge Dupes scans the FILES.BBS window looking for duplicate
  1350.             file entries. Only the last entry for each file that has a
  1351.             duplicate entry is kept.
  1352.  
  1353.             This option is useful for removing extra entries added after
  1354.             a TIC processor has added new files to a FILES.BBS file.
  1355.  
  1356.  
  1357.         Announce...
  1358.  
  1359.             This option will allow you to write a customized message
  1360.             announcing selected files directly to any Squish, *.MSG or
  1361.             *.MSG ECHO message base. You may also specify a mail
  1362.             processor so that you can scan for the message to send it
  1363.             out of your system.
  1364.  
  1365.             The whole process gets started by selecting the files you
  1366.             wish to announce from a FILES.BBS window. Next you bring up
  1367.             the context menu and select 'Announce Files...' You will
  1368.             be presented with a configuration dialog you must fill out
  1369.             to tell MaxFile/PM the particulars about the message you
  1370.             want to send. As it stands right now, you have to fill out
  1371.             the dialog for each different window. The configuration
  1372.             for each window will be saved separately and will be used
  1373.             each subsequent time you announce files from each
  1374.             particular window.
  1375.  
  1376.             There are a few things MaxFile/PM needs to know to be able
  1377.             to send the message correctly and they are as follows:
  1378.  
  1379.                 Message Base Path   -The full path and base filename
  1380.                 of the message area put the message in. For *.MSG
  1381.                 areas this will be the full path to the directory that
  1382.                 contains the *.MSG files. For Squish areas this will
  1383.                 be the path and base filename of the Squish files
  1384.                 related to the message area. This is a required entry.
  1385.  
  1386.                 Mail Processor      -This is an optional entry to
  1387.                 allow you to scan for the message that was just
  1388.                 written by a mail tosser/scanner. Please see the
  1389.                 documentation for your tosser/scanner for more
  1390.                 information.
  1391.  
  1392.                 Message Type        -This is the message base type,
  1393.                 *.MSG and Squish are fairly self-explanatory. *.MSG
  1394.                 Echo, refers to a Fidonet style *.MSG echo mail area
  1395.                 that stores the high-water mark in 1.MSG.
  1396.  
  1397.                 Message Flags       -These are the attribute flags for
  1398.                 the message you will be creating. They are mutually
  1399.                 exclusive. I will be adding Direct to the available
  1400.                 flags when I get the time to research the flags more.
  1401.  
  1402.                 To:                 -This is the name of the recipient
  1403.                 of the message. If you leave it blank, MaxFile/PM will
  1404.                 automatically default to 'All.'
  1405.  
  1406.                 To Addr:            -This is the address of the
  1407.                 recipient of the message. If left blank, the From
  1408.                 Address will be used. (Please see the From Address
  1409.                 discussion for more information on entering Fidonet
  1410.                 addresses.)
  1411.  
  1412.                 From:               -This is a required entry. This is
  1413.                 the name of the sender of the message.
  1414.  
  1415.                 From Addr:          -This is a required entry. This is
  1416.                 the address of the sender of the message. Most likely
  1417.                 this will be your fidonet address if you have one. If
  1418.                 not it doesn't matter what you enter here, as it won't
  1419.                 get used by your message bases.
  1420.  
  1421.                 The format for entering Fidonet addresses into
  1422.                 MaxFile/PM is:
  1423.  
  1424.                     zone:net/node.point
  1425.  
  1426.                 All four elements are required. To use my address as
  1427.                 an example, the field would have 1:201/60.0 entered
  1428.                 into it.
  1429.  
  1430.                 Header              -This is an optional entry that
  1431.                 you can use to place a customer banner at the top of
  1432.                 the message just before the files that are being
  1433.                 announced in the message. It is pretty much free-form,
  1434.                 but you will be much better off if you leave the
  1435.                 formatting up to MaxFile/PM. You may enter up to 1024
  1436.                 characters in this field.
  1437.  
  1438.                 Footer              -This entry is basically the same
  1439.                 as the Header field, except it comes after the
  1440.                 announced files. You may enter up to 1024 characters
  1441.                 in this field.
  1442.  
  1443.                 The 'Subject' line of the message is 'File
  1444.                 Announcement' it is currently hard coded. If I get
  1445.                 enough requests, I will add it as an option but as you
  1446.                 can see, the message dialog is quite full as it is.
  1447.                 The same holds true with the Tear and Origin lines,
  1448.                 they are not configurable. The Tear line will always
  1449.                 read '--- MaxFile/PM......' and the Origin line will
  1450.                 always just be a standard origin line with your
  1451.                 Fidonet address in it. These two I will probably be
  1452.                 adding macros for so that you can place them into
  1453.                 either the header or footer of the message. It all
  1454.                 depends on user feedback.
  1455.  
  1456.  
  1457.         Touch
  1458.  
  1459.             "Touching" is the process of updating the Time and Date
  1460.             stamps of files to the current time and date. This option
  1461.             allows you to do that for the selected files in the
  1462.             current window.
  1463.  
  1464.  
  1465.         View
  1466.  
  1467.             The View option works in conjunction with the external
  1468.             program options. For archives it will fire up the proper
  1469.             archiver to create a list of files contained in the
  1470.             archive and display a dialog containing that list. For
  1471.             pictures and text files the appropriate viewer will be
  1472.             started. View is also the action that is associated with
  1473.             double-clicking mouse button 1 on an entry in the window.
  1474.  
  1475.  
  1476.         Virus Scanner
  1477.  
  1478.             This option runs the virus scanner you have set up on each
  1479.             file selected in the current FILES.BBS window. The window
  1480.             that the virus scanner is run in is not closed when the
  1481.             scan is complete so that you may view the results.
  1482.  
  1483.             Nothing is extracted from the archives. The files are
  1484.             passed to the 'Other->Virus Scanner' entry from the
  1485.             Settings Notebook one at a time until all the selected
  1486.             files have been scanned. At this writing it is up to you to
  1487.             perform any additional processing.
  1488.  
  1489.  
  1490.     Archives
  1491.  
  1492.         Test Archive
  1493.  
  1494.             This option only works with archives. It simply invokes
  1495.             the appropriate archiver for each selected item in the
  1496.             window. The output from the archiver will be displayed in
  1497.             a dialog box after the testing is completed is completed
  1498.             for each archive.
  1499.  
  1500.  
  1501.         Extract To...
  1502.  
  1503.             Here you can extract a selected archive to a directory
  1504.             that you specify. Note that the directory you specify must
  1505.             exist.
  1506.  
  1507.             After you have used this option at least once, the directory
  1508.             will be remembered the next time the dialog box comes up
  1509.             asking you for a directory. You can just press ENTER to
  1510.             accept it.
  1511.  
  1512.  
  1513.         ReArchive
  1514.  
  1515.             to ZIP
  1516.             to ARJ
  1517.             to LZH
  1518.             to ARC
  1519.             to HA
  1520.             to RAR
  1521.             to UC2
  1522.  
  1523.             Each of these options takes an existing archive or group
  1524.             of archives and converts them to the appropriate archive
  1525.             type.
  1526.  
  1527.             If one the ADD entry for an archive is not defined its
  1528.             entry on this sub-menu will be disabled.
  1529.  
  1530.  
  1531.     Insert
  1532.  
  1533.         Comment
  1534.  
  1535.             To Insert a comment into the current FILES.BBS window,
  1536.             first select the item in the window that you want the
  1537.             comment to go in FRONT of. Then bring up the context menu
  1538.             and select Insert->Comment. A blank comment will then be
  1539.             inserted in the FILES.BBS window.
  1540.  
  1541.  
  1542.         File...
  1543.  
  1544.             Insert/File works much the same way as Insert/Comment, first
  1545.             select the item in the window that you want the file to go
  1546.             in FRONT of, then select Insert->File from the context menu.
  1547.             A file dialog will be displayed so that you can find the
  1548.             file you want to insert. Once you have found the file,
  1549.             select the Insert button in the dialog box. The file will
  1550.             then be inserted into the current window. Selecting the
  1551.             Cancel button inside the file dialog box aborts the insert
  1552.             operation.
  1553.  
  1554.             The file will be inserted into the FILES.BBS with a FULL
  1555.             PATH specification. It does NOT get copied or moved to the
  1556.             download directory. This allows you to point to a single
  1557.             file from multiple FILES.BBS files.
  1558.  
  1559.  
  1560.     Remove Items
  1561.  
  1562.             This item removes or deletes items from the FILES.BBS
  1563.             window. When you select it from the context menu, a dialog
  1564.             box will appear allowing you two options. 'Entries' just
  1565.             removes the entry from the FILES.BBS window, 'Entries and
  1566.             Files' causes the entries to be removed and the associated
  1567.             with the entries to be deleted. Click Ok to remove the
  1568.             items, or Cancel to abort the operation.
  1569.  
  1570.  
  1571.     Select All
  1572.  
  1573.             Selects all items in the current FILES.BBS Window.
  1574.  
  1575.  
  1576.     Select All Files
  1577.  
  1578.             Selects all files in the current FILES.BBS window, excluding
  1579.             orphans.
  1580.  
  1581.  
  1582.     Deselect All
  1583.  
  1584.             Deselects all items in the current FILES.BBS Window.
  1585.  
  1586.  
  1587.     Display Date
  1588.  
  1589.             Toggles the display of the File Date column in the current
  1590.             FILES.BBS Window. This setting is temporary, FILES.BBS
  1591.             Windows will always open according to the settings defined
  1592.             in the Settings Notebook.
  1593.  
  1594.     Display Size
  1595.  
  1596.             Toggles the display of the File Size column in the current
  1597.             FILES.BBS Window. This setting is temporary, FILES.BBS
  1598.             Windows will always open according to the settings defined
  1599.             in the Settings Notebook.
  1600.  
  1601.     Area Statistics
  1602.  
  1603.             This option displays an information message box containing
  1604.             how many files are in the current area, how much space
  1605.             they take up and how much free space remains on the
  1606.             volume.
  1607.  
  1608.  
  1609. ------------------------------------------------------------------------------
  1610. --- The Button Bar -----------------------------------------------------------
  1611. ------------------------------------------------------------------------------
  1612.  
  1613.         If you have the Button Bar option in the Settings
  1614.         Notebook/Main/Page 2 turned on then just below the title bar
  1615.         of each FILES.BBS window there will be a button bar that
  1616.         contains buttons for the most commonly used items on the
  1617.         context menu. Moving from the left side of the window towards
  1618.         the right, here's what they do:
  1619.  
  1620.     Sort
  1621.  
  1622.         Uses the *last* sort type selected from the context menu in a
  1623.         FILES.BBS Window. If no sort has been selected it defaults to
  1624.         Name/Ascending.
  1625.  
  1626.  
  1627.     Edit Description
  1628.  
  1629.         This is the same as ^E and Edit Description on the context
  1630.         menu. Allows you to edit the description for the highlighted
  1631.         file, if more than one file is highlighted the file with the
  1632.         dotted cursor focus is the one that will have the edit box
  1633.         opened for it.
  1634.  
  1635.  
  1636.     Get FILE_ID.DIZ
  1637.  
  1638.         Attempts to extract the FILE_ID.DIZ from the selected files.
  1639.  
  1640.  
  1641.     Touch Files
  1642.  
  1643.         Touches all the selected files.
  1644.  
  1645.  
  1646.     Virus Scan
  1647.  
  1648.         Runs the defined Virus Scanner on all highlighted files.
  1649.  
  1650.  
  1651.     Test Archive
  1652.  
  1653.         Runs the archiver tests on the highlighted archives.
  1654.  
  1655.  
  1656.     Remove Items
  1657.  
  1658.         Just like 'Remove Items...' from the context menu.
  1659.  
  1660.     Format Description...
  1661.  
  1662.         Same as Description->Format... from the context menu.
  1663.  
  1664.  
  1665.         Should you forget what a particular button does you can find
  1666.         out by pressing mouse button 1 down while the mouse pointer is
  1667.         over the button and holding it down. A short description will
  1668.         appear in the status bar at the bottom of the FILES.BBS
  1669.         window. If you don't want to perform the operation at that
  1670.         time, drag the mouse pointer down into the list of files and
  1671.         release mouse button 1.
  1672.  
  1673.  
  1674. ------------------------------------------------------------------------------
  1675. --- Selecting Items ----------------------------------------------------------
  1676. ------------------------------------------------------------------------------
  1677.  
  1678.         Perhaps the most confusing part of working in a FILES.BBS
  1679.         window is selecting or deselecting items. I wrote the program
  1680.         and I still have to think about it. Basically it works like
  1681.         this; Clicking mouse button 1 on an item selects it and clears
  1682.         the selection from any other items in the window. To select
  1683.         multiple items in the window, press mouse button 1 on the
  1684.         first item you want selected and hold it down while you drag
  1685.         the mouse cursor. This allows you to select a contiguous range
  1686.         of items. If you want to select multiple items and they aren't
  1687.         adjacent to each other, hold down the CTRL key while you click
  1688.         mouse button 1 on each item. If the item is not selected it
  1689.         will become selected, if the item is already selected the
  1690.         selection is cleared for that item.
  1691.  
  1692.         Another technique to select items uses a combination of the
  1693.         CTRL and SHIFT keys along with mouse button one. The SHIFT key
  1694.         when used in conjunction with mouse button 1 will
  1695.         select/deselect all items between the first marked item and the
  1696.         item SHIFT-clicked on. An example might help:
  1697.  
  1698.             COMMENT
  1699.             FILE1       <-- click mouse button one here
  1700.             FILE2
  1701.             FILE3
  1702.             FILE4
  1703.             FILE5       <-- SHIFT-click mouse button one here
  1704.             COMMENT
  1705.             FILE6       <-- CTRL-click mouse button one here
  1706.             FILE7
  1707.             FILE8
  1708.             FILE9
  1709.             FILE10
  1710.             FILE11
  1711.             FILE12      <-- CTRL-SHIFT-click mouse button one here
  1712.  
  1713.         With no items selected, the above actions would select two
  1714.         non-contiguous blocks of files; FILE1-FILE5 and FILE6-FILE12.
  1715.  
  1716.         If you need to select or deselect all the items in a window,
  1717.         your best bet is to use the Select All/Deselect All options
  1718.         from the context menu.
  1719.  
  1720.  
  1721. ------------------------------------------------------------------------------
  1722. --- Hotkeys ------------------------------------------------------------------
  1723. ------------------------------------------------------------------------------
  1724.  
  1725.         The following accelerator keys may be used when you are
  1726.         working in FILES.BBS window:
  1727.  
  1728.                           ^ = CTRL, ! = SHIFT
  1729.  
  1730.                           Sort Ascending
  1731.                               Name        ^1
  1732.                               Date        ^2
  1733.                               Size        ^3
  1734.                               Description ^4
  1735.                           Sort Descending
  1736.                               Name        ^5
  1737.                               Date        ^6
  1738.                               Size        ^7
  1739.                               Description ^8
  1740.                           Description
  1741.                               Edit        ^E
  1742.                               Format      ^F
  1743.                               Get DIZ     ^G
  1744.                               Set DIZ     ^S
  1745.                           Files
  1746.                               Adopt       ^A
  1747.                               Announce    ^N
  1748.                               Touch       ^O
  1749.                               View        ENTER
  1750.                               Virus Scan  ^C
  1751.                           Archives
  1752.                               Test        ^T
  1753.                               Extract to  ^X
  1754.                               ReArchive
  1755.                                   to ZIP  !F2
  1756.                                   to ARJ  !F3
  1757.                                   to LZH  !F4
  1758.                                   to ARC  !F5
  1759.                           Remove Items    ^D
  1760.  
  1761.  
  1762. ------------------------------------------------------------------------------
  1763. --- Renaming Files -----------------------------------------------------------
  1764. ------------------------------------------------------------------------------
  1765.  
  1766.         To rename a file, press and hold the ALT key and click mouse
  1767.         button 1 on the file that you want to rename. Then enter the
  1768.         new filename and click button 1 anywhere outside the edit box
  1769.         or press the keypad Enter key. Pressing ESC will discard any
  1770.         changes you have made to the filename.
  1771.  
  1772.  
  1773. ------------------------------------------------------------------------------
  1774. --- Editing File Descriptions ------------------------------------------------
  1775. ------------------------------------------------------------------------------
  1776.  
  1777.         Editing descriptions works in the much the same manner as
  1778.         renaming files, ALT+click mouse button 1 on the description
  1779.         you want to edit. To save the description, click outside the
  1780.         edit box or press the keypad Enter key. Pressing ESC will
  1781.         discard any changes made to the description or comment.
  1782.  
  1783.         The standard CUA conventions for cutting and pasting text work
  1784.         while the editing window is open for you to edit descriptions.
  1785.         They are as follows:
  1786.  
  1787.             Ctrl+INS    Copy to the Clipboard
  1788.             Shift+Del   Cut to the Clipboard
  1789.             Del         Cut (to the black hole of bits)
  1790.             Shift+INS   Paste from the Clipboard
  1791.  
  1792.         These aren't well documented, but they are standard items that
  1793.         you can expect *most* applications to use when working with
  1794.         text, including MaxFile/PM.
  1795.  
  1796.  
  1797. ------------------------------------------------------------------------------
  1798. --- Program Macros -----------------------------------------------------------
  1799. ------------------------------------------------------------------------------
  1800.  
  1801.         FILES.BBS windows are the only place that the Shift-F(x)
  1802.         macros will operate. When pressing one of these key
  1803.         combinations MaxFile/PM will search through the container in
  1804.         the window and pass the fully qualified filename of the
  1805.         selected files to your macro one at a time. Comments are
  1806.         ignored. Don't make any assumptions about what directory the
  1807.         macro will start out in, that will be determined by the
  1808.         default OS/2 shell.
  1809.  
  1810.  
  1811. ------------------------------------------------------------------------------
  1812. --- Drag and Drop ------------------------------------------------------------
  1813. ------------------------------------------------------------------------------
  1814.  
  1815.               *************************************************
  1816.               * THIS IS HOW YOU MOVE FILES BETWEEN FILE AREAS *
  1817.               *************************************************
  1818.  
  1819.         Remember, MaxFile/PM is a Workplace Shell and Presentation
  1820.         Manager friendly program. The basic operations of changing,
  1821.         editing and moving objects work the same way.
  1822.  
  1823.         A drag operation is started by pressing mouse button 2 down
  1824.         and dragging the mouse cursor. The operation is considered
  1825.         complete when you release mouse button 2. Should you wish to
  1826.         abort the drag, press the ESC key on your keyboard.
  1827.  
  1828.         When dragging files between windows in MaxFile/PM, holding down
  1829.         the CTRL key will cause the objects to be copied instead of
  1830.         moved. This works for both files and comments.
  1831.  
  1832.         You will need to make sure that both the source and
  1833.         destination windows are visible on your display.
  1834.  
  1835.         You can drag files from anywhere on your system and drop them
  1836.         either on a FILES.BBS window or onto the File Area window.
  1837.         When dropping on an open FILES.BBS window, the files are
  1838.         inserted into the FILES.BBS at the point at which they were
  1839.         dropped. When dropping on the File Area window, the files are
  1840.         inserted at the end of the FILES.BBS for the area they are
  1841.         dropped on.
  1842.  
  1843.         You can also rearrange the items in a window by selecting
  1844.         them, then dragging them and dropping them where you want them
  1845.         to be.
  1846.  
  1847.         Many of you have asked about this one...To delete one or more
  1848.         items from a FILES.BBS window; highlight the items you want
  1849.         deleted, then drag them to the shredder object and delete
  1850.         them. Or, alternatively you can use the 'Remove Items' option
  1851.         on the context menu.
  1852.  
  1853.  
  1854. ------------------------------------------------------------------------------
  1855. --- Known Problems -----------------------------------------------------------
  1856. ------------------------------------------------------------------------------
  1857.  
  1858.         In a system as configurable as OS/2 there are always going to
  1859.         be problems, this section is devoted to those problems and in
  1860.         some cases work-arounds. If you are having trouble with
  1861.         MaxFile/PM this is the first place to look to see if you can
  1862.         find some help.
  1863.  
  1864. --- FILEIDX.EXE --------------------------------------------------------------
  1865.  
  1866.         Lora-BBS File index maintenance utility
  1867.  
  1868.             Make sure that you specify the files IDX file that you
  1869.             want rebuilt in the Main Settings dialog box. For example:
  1870.  
  1871.                                 ┌────────────────────────────────────┐
  1872.         File Database Utility   │ E:\LORA\FILEIDX E:\LORA\FILES.IDX  │
  1873.                                 └────────────────────────────────────┘
  1874.  
  1875.         MaxFile/PM will take care of the rest. (The "AREA .. .. .."
  1876.         part.)
  1877.  
  1878.  
  1879. --- CONTAINER DISPLAY CORRUPTION ---------------------------------------------
  1880.  
  1881.         Moving vertical separator bar messes up highlighting
  1882.  
  1883.             The Service Pack for OS/2 2.1 screwed up the way the
  1884.             highlighting is handled when the vertical separator bar is
  1885.             moved. I didn't it break folks, IBM did.
  1886.  
  1887.  
  1888. --- VIEW AND TEST DIALOG LOCKUPS ---------------------------------------------
  1889.  
  1890.         Archive Statistics Dialog comes up as a grey window
  1891.  
  1892.             When run under 2.11 the View and Test functions lock up
  1893.             after opening more than one window. I have NOT been able
  1894.             to reproduce this under 2.10, so I don't even know where
  1895.             to begin to look. I have made several modifications to the
  1896.             code, hopefully one of them fixed the problem. :-( [06 Jun
  1897.             1994] This *HAS* been fixed!!
  1898.  
  1899. --- MAXFMPM.INI CORRUPTION ---------------------------------------------------
  1900.  
  1901.         MAXFMPM.INI gets trashed if a REXX script bombs out and won't
  1902.         quit.
  1903.  
  1904.             Always keep a backup of your MAXFMPM.INI file someplace
  1905.             safe. I need specific examples of scripts that I can use to
  1906.             recreate the problem. I'm not sure what is causing it, but I
  1907.             am looking.
  1908.  
  1909.             The key to safety is to BACKUP before you start a new script
  1910.             and try to debug it to get it to work.
  1911.  
  1912.  --- LAUNCH PAD SHREDDER WON'T SHRED MY FILES --------------------------------
  1913.  
  1914.         Create a shadow of your shredder object on the desktop and drag
  1915.         the items you want deleted to it or use Remove Items from the
  1916.         context menu in a FILES.BBS window.
  1917.  
  1918.