home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / mpm1_07a.zip / maxfmpm.txt < prev    next >
Text File  |  1994-02-15  |  36KB  |  874 lines
  1. MaxFile/PM - Version 1.07
  2.  
  3. A FILES.BBS Manager for Presentation Manager
  4.  
  5. Portions of the header files used in compilation are:
  6.  
  7.   Copyright (C) 1992, Scott Dudley
  8.   Copyright (C) 1993, Aki Antman
  9.   Copyright (C) 1994, Marco Maccaferri
  10.  
  11. From the Development Team of:
  12.  
  13.   Craig Morrison - MaxFile/PM Development
  14.     1:201/60@fidonet.org
  15.  
  16.   Ronald Van Iwaarden - MaxFile/2 Development
  17.     1:104/338@fidonet.org
  18.  
  19. Special Thanks go out to:
  20.  
  21.  Scott Dudley
  22.   For making Maximus the great BBS that it is!
  23.  
  24.  Marco Maccaferri
  25.   For providing the Lora structures and Lora itself
  26.  
  27.  Rick Fishman
  28.   His container code was a great source of inspiration
  29.  
  30.  Steven Crandall
  31.   Who thinks I should be barefoot and coding all the time
  32.  
  33.  Rick Ford
  34.   Keeping me up to date with the Lora-BBS information
  35.  
  36.  Eric Chew
  37.   For providing the SuperBBS information and testing
  38.  
  39.  Steve Lamb
  40.   "Generic" code tester
  41.  
  42.  J Gitzen
  43.   Maximus code tester
  44.  
  45.  David Campbell
  46.   Lora-BBS code tester
  47.  
  48.  Raymond Deroo
  49.   Maximus code tester
  50.  
  51.  David Roberts
  52.   Maximus code tester
  53.  
  54.  Jerry McBride
  55.   Maximus code tester
  56.  
  57. If I missed anyone, well...you know who you are! Thanks! 
  58.  
  59. *** OS/2 Beta Service Pack Warning
  60.  
  61.  NOTICE TO OS/2 BETA SERVICE PACK USERS 
  62.  
  63.  PLEASE NOTE that the Beta Service Pack for OS/2 2.1 GA breaks MaxFile/PM. At
  64. the present moment there is nothing I can do about this. When the Service Pack
  65. goes GA I can assure you that I will get right onto the matter of fixing
  66. MaxFile/PM so that it will work correctly. 
  67.  
  68. *** What's New
  69.  
  70. -  Fixed a minor bit of stupidity on my part in the configuration code that
  71. wouldn't bring up the Settings dialog the first time MaxFile/PM was run.
  72.  
  73. -  Added accelerators (hot-keys) for easier function access. 
  74.  
  75. -  Added ability to skip over headers in FILES.BBS. 
  76.  
  77. -  Added extended description support. 
  78.  
  79. -  Enabled Virus Scanner option. 
  80.  
  81. -  Added ability to extract an archive to a specified directory. 
  82.  
  83. -  Added support for fully qualified filenames in FILES.BBS files. 
  84.  
  85. -  Added a generic file format to support _any_ BBS package that uses the
  86. FILES.BBS format for download directories. Steve Lamb gets credit for this one.
  87.  
  88. -  Ripped out the old text configuration file code, it was causing way too much
  89. confusion with users who weren't running Maximus. 
  90.  
  91. -  Dropped the _tmalloc() code and went back to the API memory allocation
  92. functions. 
  93.  
  94. -  Added a new option to the Adopt Options dialog, DL Counters. 
  95.  
  96. -  Changed memory allocation code to use the library _tmalloc() function for
  97. compatibility with the PM's 16-bit code. Hopefully this will squash the random
  98. SYS3175 access violations that some have been experiencing. 
  99.  
  100. -  Added first run of the SuperBBS code. I don't know much about SBBS folks, so
  101. you are pretty much on your own. For what I do know, please keep reading this
  102. document. 
  103.  
  104. -  Fixed a bug where if more than 4 files were tagged for dragging an error
  105. would occur when dropping the files on a window. 
  106.  
  107. -  Previous code wasn't setting the changes flag when a FILE_ID.DIZ was
  108. imported from an archive. It is now. (Thanks Jim!) 
  109.  
  110. -  Fixed a bug where if only a filename was present in the FILES.BBS it would
  111. move the filename of the next file into its description. 
  112.  
  113. -  Added external program macros to the FILES.BBS windows. 
  114.  
  115. -  Added Lora compatibility. 
  116.  
  117. -  Fixed bug that made it so only D:\MAX\AREA.DAT could be read as a valid area
  118. file. 
  119.  
  120. *** Forward
  121.  
  122.  MaxFile/PM is a FILES.BBS manager that runs under Presentation Manager. While
  123. it was written with the Maximus-CBCS in mind, any BBS software package that
  124. uses the standard FILES.BBS format is supported.
  125.  
  126. A quick list of the features are:
  127.   
  128.     1. Drag and Drop between file areas
  129.   
  130.     2. Adopting orphan files
  131.   
  132.     3. FILE_ID.DIZ import
  133.   
  134.     4. Rearchiving files
  135.   
  136.     5. Sorting by:
  137.      
  138.       Name
  139.       Date
  140.       Size
  141.       Description
  142.   
  143.     6. In-place editing of file descriptions
  144.   
  145.     7. Renaming files
  146.  
  147.  As the program grows, support for more convenient features will be added to
  148. make MaxFile/PM the perfect tool for managing your downloadable files from your
  149. desktop.
  150.  
  151. *** Registration
  152.  
  153.  I'm going to keep this short, sweet and to the point. What you are seeing in
  154. MaxFile/PM is the result of drinking a lot of coffee and smoking way too many
  155. packs of cigarettes over the past month or so. Please take the time to print
  156. out the REGISTER.FRM file that is in the distribution archive and consider
  157. registration. MaxFile/PM is in a class by itself for managing FILES.BBS files
  158. on your desktop and $25 is a small fee for something that will make the chore
  159. of keeping your file areas neat and tidy a lot easier. To show my good faith in
  160. those of you who will use the program, the unregistered version is NOT crippled
  161. in any way, shape or form. A registration key simply stops the Product
  162. Information dialog from appearing when the program first starts and removes the
  163. "Please Consider Registration" message from that dialog. 
  164.  
  165.  'Nuff said... 
  166.  
  167.  One last comment here... Please share MaxFile/PM with other sysops in your
  168. area who are running OS/2. Your support for the program is needed if you want
  169. it to grow and get better than it already is!
  170.  
  171. *** Support
  172.  
  173.  If you need to contact me about the program I can be reached in a number of
  174. places. NetMail will get you the fastest response, but I read the OS2PRODSUP,
  175. OS2BBS and MUFFIN conferences everyday and intend on answering any questions
  176. posted there. There is also a local conference on my BBS called MFILEPMSUP that
  177. you are more than welcome to poll for. I *will* support MaxFile/PM, all you
  178. need to do is ask. 
  179.  
  180.  I will respond to you in the same manner you contact me, with certain
  181. exceptions.. If you are in Zone 1 and you crash netmail to me, I will return
  182. netmail to you in the same fashion. Routed netmail will get a routed response.
  183. To those of you in other Zones, I am sorry but the cost of international calls
  184. is very prohibitive. If one of you would like to volunteer to hub the support
  185. echo in your Zone, I would really appreciate it and it will get you a
  186. registered copy of MaxFile/PM. 
  187.  
  188.  If your BBS package is not supported by MaxFile/PM and you would like me to
  189. add it, I need a few things from you or the author of your BBS software. First
  190. I need the structure definitions or layouts for the file that holds your file
  191. area information. Second, I need a copy of the file that holds the file area
  192. information so that I can test the code before I ship it out to anyone.
  193.  
  194. *** Before You Start
  195.  
  196.  The default installation of OS/2 defines Mouse Button 1 as the left button and
  197. Mouse Button 2 as the right button. Please keep this in mind as you read
  198. through this document if you have redefined your mouse buttons.
  199.  
  200.  A word to the wise here..
  201.  
  202.  BACKUP *BEFORE* USING MAXFILE/PM !
  203.  
  204.  Here comes the standard disclaimer...I don't promise that MaxFile/PM will do
  205. anything for you except take up space on your hard drive. While I am fairly
  206. certain I have got all the nasties out of it, there is a chance that I may have
  207. missed something. So please be safe and backup prior to using the program.
  208. Suffice it to say, you have been warned.. :-> 
  209.  
  210. *** Configuring MaxFile/PM
  211.  
  212.  To configure MaxFile/PM for use, simply start MaxFile/PM by typing MAXFMPM and
  213. pressing ENTER at an OS/2 Command Prompt. The MaxFile/PM Settings dialog box
  214. will be presented for you, so that you can enter the vital information about
  215. your system and BBS setup. There are four dialog boxes in total that you will
  216. need to enter information into so that MaxFile/PM will be able to do everything
  217. it does. The Main Settings, Adopt Options, External Programs and Macro Setting
  218. dialogs. 
  219.  
  220. *** The Main Settings Dialog
  221.  
  222.  The Main Settings dialog box is the first dialog that gets presented. Here you
  223. will need to enter the basics about your BBS setup. These items are;
  224. Registration Key, BBS Package, BBS Directory, the path and filename of the file
  225. that contains your file area information, Temp Directory, File Database Utility
  226. path and filename, when to run your File Database Utility, whether or not to
  227. display the date and size of your files, and whether you want to be prompted to
  228. save the FILES.BBS window information when you close a window or to save it
  229. automatically. 
  230.  
  231. Main Settings Controls:
  232.   
  233.    o Registration Key
  234.    o BBS Package
  235.    o BBS Directory
  236.    o Temporary Directory
  237.    o File Area Data
  238.    o File Database Utility
  239.    o Run FD Utility
  240.    o Display
  241.    o AutoSave
  242.    o Header Size
  243.    o ED Marker
  244.  
  245.  The Adopt Options and External Programs buttons get you to the Adopt Options
  246. and External Programs dialog boxes. 
  247.  
  248. *** Registration Key
  249.  
  250.  If you don't have a registration key, set this field to 0, otherwise type your
  251. key number into the Registration Key Field. 
  252.  
  253. *** BBS Package
  254.  
  255.  The BBS Package field has four options, Maximus, Lora, SBBS and Generic.
  256. Select which ever is appropriate for your system. The default is Maximus.
  257.  
  258.  For 'Generic' please see the section entitled Generic File Area Definitions
  259. later in this document. 
  260.  
  261. *** BBS Directory
  262.  
  263.  The BBS Directory field should be filled in with the root path that your BBS
  264. files reside in. For example mine is D:\MAX. An entry in this field is
  265. required. 
  266.  
  267. *** Temporary Directory
  268.  
  269.  The Temporary Directory field is where you want MaxFile/PM to place its work
  270. files and any files it needs to create when rearchiving, testing or viewing
  271. archives.  NOTE: THIS DIRECTORY SHOULD NOT BE ONE THAT IS USED FOR ANYTHING
  272. ELSE!  MaxFile/PM  will delete _EVERYTHING_ in this directory, including any
  273. sub-directories during the normal course of its operations. This is a required
  274. entry and you will need to create this directory for MaxFile/PM. 
  275.  
  276. *** File Area Data
  277.  
  278.  The File Area Data field should be filled in with the full path and filename
  279. to the file that contains the information relating to your file areas. For
  280. Maximus this would be AREA.DAT by default. On my system I have this set to
  281. D:\MAX\AREA.DAT. For Lora-BBS users, this is the path and filename to
  282. SYSFILE.DAT. For SBBS users, this is the path and filename to your FLSEARCH.BBS
  283. file. This field is also a required entry. 
  284.  
  285. *** File Database Utility
  286.  
  287.  The next field is for the filename of your File Database Utility. For Maximus
  288. this will be either FB.EXE or FBP.EXE. On my system I have this set to FBP,
  289. since the utility is in my path. For Lora-BBS users, this will be FILEIDX.EXE.
  290. Please see the "Known Problems" section at the end of this document for more
  291. information about FILEIDX.EXE. For SBBS users, I don't have a clue. If someone
  292. would fill me in on this one I'd really appreciate it! This entry is only
  293. required if you want MaxFile/PM to run the utility for you. 
  294.  
  295. *** Run FD Utility
  296.  
  297.  The options for Run FD Utility determine when and if the File Database utility
  298. will get run. There are three; Always, Prompt and Never. Always will run your
  299. file database utility everytime you exit MaxFile/PM. If no changes have been
  300. made, it will prompt you before running it. Prompt will ask you if you wish to
  301. run it. Do I need to explain Never? :-} 
  302.  
  303. *** Display
  304.  
  305.  The Display options control whether or not the file size and date information
  306. gets displayed for your files in the FILES.BBS windows. Simply check or uncheck
  307. the check boxes to set your preferences. 
  308.  
  309. *** AutoSave
  310.  
  311.  AutoSave controls whether you are prompted to save FILES.BBS information or if
  312. it should be written automatically each time you close a window that has
  313. FILES.BBS information in it. When the checkbox for this item has a check in it,
  314. MaxFile/PM will automatically save, if not, you will be prompted to save the
  315. information. 
  316.  
  317. *** Header Size
  318.  
  319.  Header Size controls how many lines at the beginning of the FILES.BBS are
  320. skipped when the FILES.BBS is read to populate the FILES.BBS window. It also
  321. tells MaxFile/PM how many lines to copy from the old FILES.BBS to the new
  322. FILES.BBS when it saves changes.
  323.  
  324.  This will solve quite a few of the problems with DownSort headers while still
  325. preserving the headers in your FILES.BBS files. 
  326.  
  327. *** ED Marker
  328.  
  329.  For those BBS packages that support extended descriptions this option will
  330. come in handy. Here you tell MaxFile/PM what character is associated with
  331. extended descriptions for your BBS Package. This character can not be a space
  332. or a dash.
  333.  
  334.  Defining this character causes a few changes in the way MaxFile/PM handles
  335. your file descriptions. When this option is used, file descriptions are allowed
  336. to be up to 1024 characters in length and nothing is stripped from FILE_ID.DIZ
  337. descriptions read in from archives. MaxFile/PM does not insert this character
  338. in multiple line descriptions for you, you need to do this.
  339.  
  340.  If this character is not defined, file descriptions are limited to 255
  341. characters, also, any CR/LF pairs and high-bit ASCII characters are stripped
  342. from FILE_ID.DIZ descriptions. 
  343.  
  344. *** The Adopt Options Dialog Box
  345.  
  346.  The Adopt Options dialog box is where you enter the information that tells
  347. MaxFile/PM what files are okay to adopt. You do this by entering the extensions
  348. of the files that you want to be added to your FILES.BBS when you do an Adopt
  349. Files. You also may enter a Default Description here that gets used for adopted
  350. files that either aren't archives or are archives that don't have a FILE_ID.DIZ
  351. file in them. 
  352.  
  353. Adopt Options Controls:
  354.   
  355.    o Add/Remove Extensions To Adopt
  356.    o AutoAdopt
  357.    o Download Counters
  358.    o Default Description
  359.  
  360. *** Add/Remove Extensions To Adopt
  361.  
  362.  You may enter upto 15 extensions for MaxFile/PM to recognize. Entering them in
  363. is accomplished by typing them into the edit field just above the Add button
  364. and then clicking on the Add button. You may also remove extensions by
  365. hilighting them in the listbox and clicking on the Remove button. NOTE: what
  366. you are entering here is JUST the file extension, I.E. ZIP, not a file
  367. specification mask. 
  368.  
  369. *** AutoAdopt
  370.  
  371.  The little checkbox to the right of the adopt list listbox labeled AutoAdopt
  372. tells MaxFile/PM whether or not to automatically adopt files each time a file
  373. area is opened. Check it if you want this behaviour. I will have to admit that
  374. at this time adopting is a rather slow process, so you might not want to have
  375. AutoAdopt set to on. 
  376.  
  377. *** Download Counters
  378.  
  379.  Next comes the DL Counters checkbox, if you have this option checked, when
  380. ever an Adopt is performed a download counter will be added to the beginning of
  381. the file description. Currently this is hard coded as '[   ]'. 
  382.  
  383. *** Default Description
  384.  
  385.  The last item in this dialog box is the Default Description. You may enter
  386. upto 80 characters for a default description. This text will get used any time
  387. you Insert, Adopt or drop files from an outside source into a window in
  388. MaxFile/PM and those files meet the following criteria: 1, they are not an
  389. archive or 2, they are an archive and the archive does not contain a
  390. FILE_ID.DIZ description inside of it. 
  391.  
  392. *** The External Programs Dialog Box
  393.  
  394.  The External Programs dialog box is where you enter all the information about
  395. your archivers and viewers. There are four entries for each archiver type that
  396. MaxFile/PM supports (ZIP, ARJ, LZH and ARC.) Which are; Extract, Add, List and
  397. Test. You'll need to look up the proper switches in the documentation for each
  398. of the archivers you have. If you deal with archivers that can handle
  399. directories inside of them, make sure that you specify those switches here.
  400.  
  401. See also: MaxFile/PM and External Programs
  402.  
  403.  The final control in this dialog is a button labeled Macros, it will bring up
  404. the Macro Settings Dialog. 
  405.  
  406. *** The Macro Settings Dialog Box
  407.  
  408.  Here you can enter the definitions for 5 macros that will get called when you
  409. press one of the keys, Shift-F6 - Shift-F10. They aren't macros persay, but
  410. they behave in a very similar manner.
  411.  
  412. See also: MaxFile/PM and External Programs 
  413.  
  414. *** MaxFile/PM and External Programs
  415.  
  416.  If you have REXX installed you can use REXX command files for any of the
  417. external program options. You may also call OS/2 command files.
  418.  
  419.  Just remember to save the directory that your command file gets called from
  420. and restore it just before your command file gets done.
  421.  
  422.  During certain operations MaxFile/PM expects to find a result file in the
  423. directory it calls these programs from. The Test and View functions are those
  424. times. MaxFile/PM expects to find the file ARC.TXT in the temporary directory
  425. these programs are called from, if it doesn't find that file it will not
  426. display anything about the files that are being tested or viewed.
  427.  
  428.  I had originally stated the MaxFile/PM could directly run DOS applications,
  429. well it can but in certain circumstances it takes a little work. For the
  430. Archiver Test and Viewer functions, if you use a DOS based archiver you will
  431. need to write a small batch file that runs the archiver and directs the output
  432. from the archiver to a file called ARC.TXT. As stated above this is the file
  433. that MaxFile/PM displays to you for those functions.
  434.  
  435.  Please note that what directory the programs start out in WILL vary over the
  436. course of a MaxFile/PM session, so don't hard code any references into your
  437. command files. 
  438.  
  439. *** Generic File Area Definitions
  440.  
  441.  To provide support for any BBS system that uses the standard FILES.BBS format
  442. for their file listings I have come up with a very simple text file format that
  443. will allow you to tell MaxFile/PM how your file areas are defined.
  444.  
  445.  The file is made up of a verb that tells MaxFile/PM how many areas it can
  446. expect to find in the text file. Each successive line after that verb defines
  447. the file areas themselves. A sample file is shown below: 
  448.  
  449. ----------------------------- AREAS.CFG sample --------------------------------
  450. AreaCount 5
  451. 0 d:\max\file\uncheck    d:\max\file\uncheck\files.bbs    Unchecked Uploads
  452. 1 d:\max\file\max        d:\max\file\max\files.bbs        BBS Stuff
  453. 2 d:\max\file\dos\games  d:\max\file\dos\games\files.bbs  Dos Games
  454. 3 d:\max\file\os2\util   d:\max\file\os2\util\files.bbs   OS/2 Utilities
  455. 4 d:\max\file\os2\apps   d:\max\file\os2\apps\files.bbs   OS/2 Applications
  456. -------------------------------------------------------------------------------
  457.  
  458.  The 'AreaCount' keyword tells MaxFile/PM how many area definitions it can
  459. expect to find in the file. The AreaCount keyword must come BEFORE the area
  460. definition lines.
  461.  
  462. The format for each area definition line is:
  463.  
  464.   <area tag> <file path> <list name> <area description>
  465.  
  466. ────────────────────────────────────────────────────────────────────
  467.  <area tag>           Is a short name to identify the file area.
  468.  
  469.  <file path>          Is the path to the files.
  470.  
  471.  <list name>          Is the full drive:\path and filename of the
  472.                       FILES.BBS for the area.
  473.  
  474.  <area description>   Is a short description of the area.
  475. ────────────────────────────────────────────────────────────────────
  476.  
  477.  You can name this file what ever you wish, just make sure you specify the name
  478. of this file for the File Area Data option in the Main Settings Dialog and make
  479. sure the BBS Package is set to 'Generic'. 
  480.  
  481. *** Using MaxFile/PM
  482.  
  483.  When MaxFile/PM first comes up a window will be displayed that contains all of
  484. your file areas. I will be referring to this window by the term 'File Area
  485. Window' throughout the rest of this document.
  486.  
  487.  When you open up a file area, a window that is very similar in appearance to
  488. the File Area window will appear. This window will contain all the files listed
  489. in the FILES.BBS for that area. These windows will be referred to as 'FILES.BBS
  490. Windows' from here on out. 
  491.  
  492. *** File Area Window
  493.  
  494.  The File Area window serves two basic purposes. First, it allows you to open
  495. FILES.BBS Windows and second, it also serves as a dropping point for files so
  496. that you can quickly move files to another file area without having to open the
  497. file area.
  498.  
  499. The File Area Window Context Menu:
  500.  
  501. ────────────────────────────────────────────────────────────────────
  502.  Open                      Opens the highlighted file area.
  503.  
  504.  View                      Change the way items are displayed.
  505.  
  506.  Area Sort                 Change sort order of file area display.
  507.  
  508.  Settings...               Configure MaxFile/PM for use.
  509.  
  510.  Product Information...    Displays some information about
  511.                            MaxFile/PM.
  512. ────────────────────────────────────────────────────────────────────
  513.  
  514.  To bring up the context menu for the File Area window, press mouse button 2
  515. anywhere inside the confines of the window. 
  516.  
  517. *** File Area Menu/Open
  518.  
  519.  This menu item allows you to open the highlighted file area.
  520.  
  521.  The other ways of opening a file area are: Highlighting the area you want to
  522. open and pressing enter or double-clicking mouse button 1 on a file area.
  523.  
  524.  If the file area is already open it will be brought into view, even if it is
  525. minimized to the Minimized Window Viewer folder. 
  526.  
  527. *** File Area Menu/View
  528.  
  529.  Here you can change the way that the window displays your file areas. There
  530. are three different options:
  531.  
  532. ────────────────────────────────────────────────────────────────────
  533.  Detail          Sets the display to the "detail" view.
  534.  
  535.  Icon            Sets the display to the "Icon" view.
  536.  
  537.  Text            Sets the display to the "Text" view.
  538. ────────────────────────────────────────────────────────────────────
  539.  
  540. *** File Area Menu/Area Sort
  541.  
  542.  The default order for your file areas is the order they are defined in. Here
  543. you may change the order in which they are displayed. You can sort your file
  544. areas in the following ways:
  545.  
  546. ────────────────────────────────────────────────────────────────────
  547.  Tag             Sorts file area display by Area Tags.
  548.  
  549.  Description     Sorts file area display by Area Description.
  550.  
  551.  Files Dir       Sorts file area display by Area Download Path.
  552. ────────────────────────────────────────────────────────────────────
  553.  
  554. *** File Area Menu/Settings
  555.  
  556.  This option brings up the Main Settings configuration dialog.
  557.  
  558.  See Also: Main Settings Dialog 
  559.  
  560. *** File Area Menu/Product Information
  561.  
  562.  This menu item displays the Product Information dialog box for MaxFile/PM. 
  563.  
  564. *** FILES.BBS Window
  565.  
  566.  FILES.BBS windows are the heart and soul of MaxFile/PM, these windows are
  567. where you will be spending most of your time. A FILES.BBS window is very
  568. similar to the File Area window in appearance. What you will see when you open
  569. one of these windows is the contents of the FILES.BBS that is associated with
  570. the file area this window belongs to. 
  571.  
  572. The FILES.BBS Window Context Menu:
  573.  
  574. ────────────────────────────────────────────────────────────────────
  575.  Sort                      Sort Options
  576.  
  577.  View                      Displays file(s) based on their type.
  578.  
  579.  Test Archive              Run archive tests on selected arhcives.
  580.  
  581.  Virus Scanner             Run virus scannner utility on selected
  582.                            files.
  583.  
  584.  ReArchive                 ReArchive Options
  585.  
  586.  Extract to Directory      Extract files to a specified directory.
  587.  
  588.  Adopt Files               Adopt orphan files.
  589.  
  590.  Touch Files               Updates Time and Date stamp of selected
  591.                            files.
  592.  
  593.  Edit Description          Edit description of FIRST selected item.
  594.  
  595.  Get FILE_ID.DIZ           Extract FILE_ID.DIZ from selected
  596.                            Archives.
  597.  
  598.  Insert                    Insert Files or Comments
  599.  
  600.  Remove Items              Removes highlighted items (doesn't
  601.                            delete files.)
  602.  
  603.  Select All                Selects all items in FILES.BBS window.
  604.  
  605.  Deselect All              Deselects all items.
  606.  
  607.  Area Statistics           Display number of files, space used,
  608.                            etc...
  609. ────────────────────────────────────────────────────────────────────
  610.  
  611. *** Sort
  612.  
  613.  With this option you can sort the entries in this FILES.BBS window in one of
  614. four ways; Name, Date, Size or Description. Pay attention here, this is the
  615. part that confuses some people. If there are any items selected ONLY those
  616. items get sorted. To sort the entire window, make sure NONE of the items in
  617. that window are selected. We'll talk about this a bit later. 
  618.  
  619. *** View
  620.  
  621.  The View option works in conjunction with the external program options. For
  622. archives it will fire up the proper archiver to create a list of files
  623. contained in the archive and display a dialog containing that list. For
  624. pictures and text files the appropriate viewer will be started. View is also
  625. the action that is associated with double-clicking mouse button 1 on an entry
  626. in the window. 
  627.  
  628. *** Test Archive
  629.  
  630.  This option only works with archives. It simply invokes the appropriate
  631. archiver for each selected item in the window. The output from the archiver
  632. will be displayed in a dialog box after the testing is completed is completed
  633. for each archive. 
  634.  
  635. *** Virus Scanner
  636.  
  637.  This option runs the virus scanner you have set up on each file selected in
  638. the current FILES.BBS window. The window that the virus scanner is run in is
  639. not closed when the scan is complete so that you may view the results. 
  640.  
  641. *** ReArchive
  642.  
  643.  This option allows you to convert archives to your preferred archive format.
  644. Should one of your archivers not have an Add option defined for it, its menu
  645. option will be grayed out. 
  646.  
  647. *** Extract to Directory
  648.  
  649.  Here you can extract a selected archive to a directory that you specify. Note
  650. that the directory you specify must exist.
  651.  
  652.  Once you select this option a dialog box will appear asking you to specify the
  653. directory you want to extract the files to, it also displays the current
  654. directory. Type in the directory name and select Ok, or select Cancel to abort
  655. the operation. 
  656.  
  657. *** Adopt Files
  658.  
  659.  Adopt Files allows you to add any orphan files in a particular file area to
  660. the FILES.BBS for that area. Adopting is performed in a seperate thread so that
  661. you may continue to work in the window for the file area while the adopt is
  662. going on. The window will be locked open while the Adopt is being performed. 
  663.  
  664. *** Touch Files
  665.  
  666.  "Touching" is the process of updating the Time and Date stamps of files to the
  667. current time and date. This option allows you to do that for the selected files
  668. in the current window. 
  669.  
  670. *** Edit Description
  671.  
  672.  Many of you asked for this one. Edit Description allows you to edit the
  673. description of a selected item by first selecting it, then choosing this option
  674. from the context menu. It works the same way as ALT+clicking mouse button 1 on
  675. an item's description. 
  676.  
  677. *** Get FILE_ID.DIZ
  678.  
  679.  This option goes through the selected items in the window and attempts to
  680. extract the FILE_ID.DIZ from them. Comments and files that aren't archives are
  681. skipped over by this function. If a FILE_ID.DIZ is present in the archives
  682. selected, the first 255 characters will be read from it and placed in the
  683. description field. CR/LF pairs and high-bit ASCII characters are stripped from
  684. the text read in from the FILE_ID.DIZ. 
  685.  
  686. *** Insert
  687.  
  688.  To Insert a comment into the current FILES.BBS window, first select the item
  689. in the window that you want the comment to go in FRONT of. Then bring up the
  690. context menu and select Insert->Comment. A blank comment will then be inserted
  691. in the FILES.BBS window.
  692.  
  693.  To allow you to adopt a single file from either the current directory or
  694. another drive/directory, you can use Insert/File. It works much the same way as
  695. Insert/Comment, first select the item in the window that you want the file to
  696. go in front of, then select Insert->File from the context menu. A file dialog
  697. will be displayed so that you can find the file you want to insert. Once you
  698. have found the file, select the Insert button in the dialog box. The file will
  699. then be inserted into the current window. Selecting the Cancel button inside
  700. the file dialog box aborts the insert operation. 
  701.  
  702. *** Remove Items
  703.  
  704.  This item removes or deletes items from the FILES.BBS window. When you select
  705. it from the context menu, a dialog box will appear allowing you two options.
  706. 'Entries' just removes the entry from the FILES.BBS window, 'Entries and Files'
  707. causes the entries to be removed and the associated with the entries to be
  708. deleted. Click Ok to remove the items, or Cancel to abort the operation. 
  709.  
  710. *** Select/Deselect All
  711.  
  712.  These two options do exactly what they say. Select All, selects every item in
  713. the window and Deselect All, deselects all items in the window. 
  714.  
  715. *** Area Statistics
  716.  
  717.  This option displays an information message box containing how many files are
  718. in the current area, how much space they take up and how much free space
  719. remains on the volume. 
  720.  
  721. *** Selecting Items
  722.  
  723.  Perhaps the most confusing part of working in a FILES.BBS window is selecting
  724. or deselecting items. I wrote the program and I still have to think about it.
  725. Basically it works like this; Clicking mouse button 1 on an item selects it and
  726. clears the selection from any other items in the window. To select multiple
  727. items in the window, press mouse button 1 on the first item you want selected
  728. and hold it down while you drag the mouse cursor. This allows you to select a
  729. contiguous range of items. If you want to select multiple items and they aren't
  730. adjacent to each other, hold down the CTRL key while you click mouse button 1
  731. on each item. If the item is not selected it will become selected, if the item
  732. is already selected the selection is cleared for that item.
  733.  
  734.  If you need to select or deselect all the items in a window, your best bet is
  735. to use the Select All/Deselect All options from the context menu. 
  736.  
  737. *** Drag and Drop
  738.  
  739.  A drag operation is started by pressing mouse button 2 down and dragging the
  740. mouse cursor. The operation is considered complete when you release mouse
  741. button 2. Should you wish to abort the drag, press the ESC key on your
  742. keyboard.
  743.  
  744.  You can drag files from anywhere on your system and drop them either on a
  745. FILES.BBS window or onto the File Area window. When dropping on an open
  746. FILES.BBS window, the files are inserted into the FILES.BBS at the point at
  747. which they were dropped. When dropping on the File Area window, the files are
  748. inserted at the end of the FILES.BBS for the area they are dropped on.
  749.  
  750.  You can also rearrange the items in a window by selecting them, then dragging
  751. them and dropping them where you want them to be.
  752.  
  753.  Many of you have asked about this one...To delete one or more items from a
  754. FILES.BBS window; highlight the items you want deleted, then drag them to the
  755. shredder object and delete them. 
  756.  
  757. *** Renaming Files
  758.  
  759.  To rename a file, press and hold the ALT key and click mouse button 1 on the
  760. file that you want to rename. Then enter the new filename and click button 1
  761. anywhere outside the edit box or press the ESC key to end the edit. 
  762.  
  763. *** Editing File Descriptions
  764.  
  765.  Editing descriptions works in the much the same manner as renaming files,
  766. ALT+click mouse button 1 on the description you want to edit. To save the
  767. description, click outside the edit box or press the ESC key. 
  768.  
  769. *** Program Macros
  770.  
  771.  FILES.BBS windows are the only place that the Shift-F(x) macros will operate.
  772. When pressing one of these key combinations MaxFile/PM will search through the
  773. container in the window and pass the fully qualified filename of the FIRST (and
  774. ONLY the first) selected item in the container to your macro. If a comment is
  775. selected, or no items are selected, your macro will get called with no
  776. arguments passed to it. Don't make any assumptions about what directory the
  777. macro will start out in, that will be determined by the default OS/2 shell. 
  778.  
  779. *** FILE_ID.DIZ Notes
  780.  
  781.  MaxFile/PM will attempt to extract FILE_ID.DIZ from archives and use the
  782. description inside the file any time you adopt orphans, drop files from an
  783. external source on the File Area or FILES.BBS windows or 'Insert' files. 
  784.  
  785. *** Known Problems
  786.  
  787.  In a system as configurable as OS/2 there are always going to be problems,
  788. this section is devoted to those problems and in some cases work-arounds. If
  789. you are having trouble with MaxFile/PM this is the first place to look to see
  790. if you can find some help. 
  791.  
  792. Problem List:
  793.   
  794.    o CONFIGURATION
  795.    o SYS3175 - Access Violations
  796.    o DOWNSORT
  797.    o FEELX
  798.    o FILEIDX.EXE
  799.    o RENAMING FILES
  800.    o SPLAT DIRECTORIES
  801.  
  802. *** CONFIGURATION
  803.  
  804.  I changed the BBS package I use, why do I have to restart MaxFile/PM?
  805.  
  806.  Sometime in the near future this is likely to change, but for now anytime you
  807. change the 'BBS Package' and 'File Area Data' options in the Main Settings
  808. Dialog you will have to shut MaxFile/PM down and restart it for the changes to
  809. take effect. It has to do with the way the configuration is read in, which I am
  810. not going to go into here. 
  811.  
  812. *** SYS3175 - Access Violations
  813.  
  814.  On ocassion when dragging file(s) outside of MaxFile/PM's windows an access
  815. violation will occur and shut MaxFile/PM down. I have not been able to reliably
  816. duplicate this (its only happened to me once), thus I haven't been able to
  817. track down its cause. 
  818.  
  819. *** DOWNSORT
  820.  
  821.  Single Carriage Returns in Comment Lines
  822.  
  823.  DownSort headers have been a major source of anguish.. ;-} Some versions of
  824. DownSort will insert ASCII 0x0D carriage returns in comment lines in order to
  825. cover up the dash that tells Maximus to use white text instead of the default
  826. cyan. In an effort to keep the PM Container control and DownSort users both
  827. happy I had to resort to a kludge. When the FILES.BBS is read in, MaxFile/PM
  828. will replace any single occurances of CR's with a sentinel (ASCII 0x01). This
  829. tells MaxFile/PM when it writes the FILES.BBS back out to insert a single CR at
  830. that position. This sentinel character shows up as a little smiley '' in the
  831. comment text on the right side of the container control. If you delete this
  832. little guy, the CR will NOT get replaced. So make sure you actually do want to
  833. get rid of it.   Another alternative is to use the Header Size configuration
  834. option to force MaxFile/PM to skip the headers in your FILES.BBS files. 
  835.  
  836. *** FEELX
  837.  
  838.  Video corruption when fast scrolling in the Archive Statistics Dialog.
  839.  
  840.  It has been brought to my attention that some video corruption has occured
  841. when FEELX is being used. MaxFile/PM is not causing the problems here. I am
  842. using standard controls with none of their behaviour modified. I'm sorry if
  843. this causes some inconvenience to FEELX users, but I can't fix something in my
  844. program that isn't broken. 
  845.  
  846. *** FILEIDX.EXE
  847.  
  848.  Lora-BBS File index maintenance utility
  849.  
  850.  Make sure that you specify the files IDX file that you want rebuilt in the
  851. Main Settings dialog box. For example:
  852.  
  853.                            ┌────────────────────────────────────┐
  854.    File Database Utility   │ E:\LORA\FILEIDX E:\LORA\FILES.IDX  │
  855.                            └────────────────────────────────────┘
  856.  
  857.  MaxFile/PM will take care of the rest. (The "AREA .. .. .." part.) 
  858.  
  859. *** RENAMING FILES
  860.  
  861.  I haven't fully tested all the different ramifications of renaming files now
  862. that full path specs are supported, please be careful when renaming files in a
  863. FILES.BBS window. And report anything out of the ordinary. 
  864.  
  865. *** SPLAT DIRECTORIES
  866.  
  867.  Left over directories in the Temp Directory
  868.  
  869.  If MaxFile/PM suffers from an Abnormal Termination, it is quite possible that
  870. the proper cleanup of the Temporary Directory did not get performed. It is safe
  871. to remove the files from these temporary directories and remove the extra
  872. directories. Please do this when MaxFile/PM is NOT running. 
  873.  
  874.