| 1 | ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ | 
|---|
| 2 | ³  F(ile) M(anager)/2 is free software from Mark Kimes ³ | 
|---|
| 3 | ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄŽ | 
|---|
| 4 | ³       See end of document for contact info           ³ | 
|---|
| 5 | ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ | 
|---|
| 6 |  | 
|---|
| 7 | FM/2 3.17: This release provides for loading FM/2 partially in high memory | 
|---|
| 8 | since this won't work on older systems (pre fixpack 13?) or you might have | 
|---|
| 9 | other reasons not to use it we provide a low memory version also. Some high | 
|---|
| 10 | loaded programs hang in the exit handler (ie don't close). We didn't | 
|---|
| 11 | experience this problem but if you do install the low memory version (3.17.0). | 
|---|
| 12 | The high memory version is 3.17.1. | 
|---|
| 13 |  | 
|---|
| 14 | This release makes changes that should speed the scanning and | 
|---|
| 15 | container filling in FM/2. We have added some visual clues to let you know | 
|---|
| 16 | FM/2 is still working. The LED in the lower right hand corner now blinks | 
|---|
| 17 | while long operations are in progress or you can open the thread note | 
|---|
| 18 | window (click on the LED) for even more detailed information about an | 
|---|
| 19 | operation in progress. We also added a better "scanning" message. | 
|---|
| 20 |  | 
|---|
| 21 | We have updated the look and functionality of the drivebar. It now has the | 
|---|
| 22 | drive letters superimposed over the drive icons allowing for larger icons. | 
|---|
| 23 | We have add a refresh removable media and rescan button to the beginning | 
|---|
| 24 | of the bar to make it a more complete replacement for the tree container | 
|---|
| 25 | in FM/2 lite. You can also show the file system type or drive label next | 
|---|
| 26 | to the drive letter in the tree container. See the Tree settings notebook | 
|---|
| 27 | page to try this option. | 
|---|
| 28 |  | 
|---|
| 29 | The INI viewer option on the utilities menu now lets you choose to open | 
|---|
| 30 | the user INI, system INI or FM2's INI. We now allow LONGNAMES to be | 
|---|
| 31 | displayed for FAT & LAN drives and we  delete .LONGNAME EA if it becomes | 
|---|
| 32 | the filename on a copy or move. In addition to these we fixed 2 rare crashes | 
|---|
| 33 | and a hang associated with SMP. We also fixed a handful of interface problems. | 
|---|
| 34 | See the history file for more information. | 
|---|
| 35 |  | 
|---|
| 36 | FM/2 3.16: This release makes changes that should allow FM/2 to be | 
|---|
| 37 | translated into different languages. It also adds date and number | 
|---|
| 38 | formatting based on the system locale settings. We now need to find | 
|---|
| 39 | some individuals who are interested in doing the translations. | 
|---|
| 40 | Currently, double bit character sets are not supported in FM/2. | 
|---|
| 41 |  | 
|---|
| 42 | We have also fixed multiple minor annoyances such as improving | 
|---|
| 43 | detection of text verses binary files when opening viewers and | 
|---|
| 44 | filtering/(de)select mask now works for archives with pathnames. | 
|---|
| 45 | We added the ability to turn error/alert beeps on and off in the | 
|---|
| 46 | settings notebook (General page) and changes to the details switches | 
|---|
| 47 | in compare directories are now saved. See the history for more details. | 
|---|
| 48 |  | 
|---|
| 49 | FM/2 3.15: This release turns on some new features by default | 
|---|
| 50 | don't panic they can all be turned off if you don't like them. | 
|---|
| 51 | The first is recursive scanning on start up. This slows the initial | 
|---|
| 52 | scan a bit but speeds expansion of the tree later. It is on for | 
|---|
| 53 | local hard drives and can be turned on for other drive types. The | 
|---|
| 54 | second new feature is an automatic rescan of the drive tree on | 
|---|
| 55 | eject of removable media keeping the tree container more current. | 
|---|
| 56 | Both of these features can be turn on or off on the scanning page | 
|---|
| 57 | of the notebook. The third new feature actually turns write verify | 
|---|
| 58 | off on a per drive basis. This is to address the fact that many | 
|---|
| 59 | USB removables fail or worse (hangs/traps) when write verify is on. | 
|---|
| 60 | We turn it off by default for removables other than standard floppies. | 
|---|
| 61 | If you want it on/off for a given drive edit that drive's drive flags | 
|---|
| 62 | accordingly. The global write verify selector is unchanged and the | 
|---|
| 63 | drive flags have no effect if it is off. | 
|---|
| 64 |  | 
|---|
| 65 | We have some additional new items we hope you will find useful. We | 
|---|
| 66 | have added the ability to have the extract commands create a | 
|---|
| 67 | subdirectory based on the archive file name for the extraction target. | 
|---|
| 68 | Seek and Scan has been added to the drives and directories context | 
|---|
| 69 | menu and when selected from there will add the drive or directory as | 
|---|
| 70 | the root for the search. We also added refresh removable media so | 
|---|
| 71 | you can scan for newly inserted drives from the tree container | 
|---|
| 72 | We did some additional work on the main menus like adding Databar | 
|---|
| 73 | to the utilities menu and we now gray out items that are unavailable | 
|---|
| 74 | or inappropriate and un-grayed some items that were inappropriately | 
|---|
| 75 | turned off. We reorganized the internal editor menus as well. | 
|---|
| 76 |  | 
|---|
| 77 | We made changes to the archiver code so that archivers that don't | 
|---|
| 78 | have specific start/end list strings will work (ie TAR.EXE). We | 
|---|
| 79 | have included the commands for .tar .tar.gz and .tar.bz in archiver.tmp | 
|---|
| 80 | (gzip.exe and/or bzip.exe must be in the path) These only work with tar 1.15 | 
|---|
| 81 | or higher. We included a separate entry for TAR 1.10 but versions of TAR prior | 
|---|
| 82 | to 1.15 don't work for tar.gz/bz2 files. You can either replace archiver.bb2 | 
|---|
| 83 | with the archiver.tmp or if you have made changes to archiver.bb2 you can cut | 
|---|
| 84 | and paste the new archiver definitions into an appropriate position in your | 
|---|
| 85 | existing archiver.bb2 | 
|---|
| 86 |  | 
|---|
| 87 | Numerous fixes to minor interface appearance and behavior issues are also include. | 
|---|
| 88 | We have added exceptq support to make it easier to track down defects. We | 
|---|
| 89 | also eliminated the cause of three rare traps including one associated with | 
|---|
| 90 | deleting directories. See the history file for more details. | 
|---|
| 91 |  | 
|---|
| 92 | FM/2 3.14: This release updates many of the icons and bitmaps | 
|---|
| 93 | used in FM/2. In addition, more updates have been made to the | 
|---|
| 94 | toolbars to activate the new toolbars follow the instruction for | 
|---|
| 95 | using CFGMGR in the section about version 3.13. One other change | 
|---|
| 96 | may require some user intervention. Inadvertently the expected | 
|---|
| 97 | name of the filters data file was change in version 3.12 from | 
|---|
| 98 | filters.dat to filter.dat. We have corrected this, however, this | 
|---|
| 99 | means your filters may be spread across 2 different files or may | 
|---|
| 100 | seem to have disappeared. If they have disappeared go to the FM/2 | 
|---|
| 101 | directory and rename the file filter.dat to filters.dat. This should | 
|---|
| 102 | restore your saved filters. If you find you have both filter.dat and | 
|---|
| 103 | filters.dat use a text editor to add the contents of filter.dat | 
|---|
| 104 | to filters.dat. | 
|---|
| 105 |  | 
|---|
| 106 | This release also contains some menu changes with unformatted drives | 
|---|
| 107 | using the "drives" context menu, the elimination of more than one | 
|---|
| 108 | default on some submenus and menu items such as "format" being | 
|---|
| 109 | disabled for network drives and enabled for removables. Some of the | 
|---|
| 110 | changes should make FM/2 more responsive (Let us know if you notice | 
|---|
| 111 | a difference). We have also included some bug fixes. | 
|---|
| 112 |  | 
|---|
| 113 | FM/2 3.13: Many of the changes in this release are related to | 
|---|
| 114 | the toolbars. A new feature is that the current toolbar, along | 
|---|
| 115 | with the current Target directory, are now saved and restored | 
|---|
| 116 | with states. Toolbar code and documentation has been improved, new | 
|---|
| 117 | toolbar button bitmaps have been added and bugs have been fixed. | 
|---|
| 118 |  | 
|---|
| 119 | The installation of FM/2 will not replace existing user | 
|---|
| 120 | customization files like the toolbar files. So, if this is not | 
|---|
| 121 | your first installation of FM/2, some of these improvements will | 
|---|
| 122 | not be available because of the old, pre v3.13 toolbar files. It | 
|---|
| 123 | is therefore recommended that you run the following: | 
|---|
| 124 |  | 
|---|
| 125 | CFGMGR /INSTALL /DEFAULTS /TOOLBARSONLY /UNATTENDED | 
|---|
| 126 |  | 
|---|
| 127 | CFGMGR is a REXX program located in the FM/2 installation directory. | 
|---|
| 128 | If run as given above it will copy your existing toolbar files into | 
|---|
| 129 | a "User_config_backup" subdirectory and then install FM/2 default | 
|---|
| 130 | toolbar files. If you have done some customizations of FM/2 toolbars | 
|---|
| 131 | you can use a text editor and/or file comparison utility like GFC | 
|---|
| 132 | to "merge" your changes, now found in the backup subdirectory, | 
|---|
| 133 | with the default files now found in the FM/2 directory. If you want | 
|---|
| 134 | more control over the operation of CFGMGR, then leave off the | 
|---|
| 135 | /UNATTENDED parameter. Without the /UNATTENDED parameter CFGMGR | 
|---|
| 136 | will ask your permission before replacing each file. | 
|---|
| 137 |  | 
|---|
| 138 | The delete = move to trash can is off by default (turn it on on the | 
|---|
| 139 | General settings notebook page). FM/2 now checks for adequate disk | 
|---|
| 140 | space to avoid data loss. | 
|---|
| 141 |  | 
|---|
| 142 | We also fixed some additional bugs and provide some performance | 
|---|
| 143 | enhancements. If you have had trouble with "broken pipe" errors | 
|---|
| 144 | copying to a netdrive samba drive let me know if it now works | 
|---|
| 145 | better. I have built in some retries for this error but can't test | 
|---|
| 146 | it since I don't see the problem. Also please report back to us anytime | 
|---|
| 147 | you see the Debug error report to author box with as much detail about | 
|---|
| 148 | what you were doing as possible. Thanks | 
|---|
| 149 |  | 
|---|
| 150 | FM/2 3.12 Fixes a bug introduced in 3.11 (trap when viewing | 
|---|
| 151 | multiple files from an archive at the same time). It also adds | 
|---|
| 152 | Open Default, Open Settings and via an accel key ctrl + l Open | 
|---|
| 153 | Multimedia (using FM2play.exe) to the archive viewer. FM/2 now | 
|---|
| 154 | uses the system TMP/TEMP directory for it temporary files and | 
|---|
| 155 | cleans up after a crash on the next restart. FM/2 creates a | 
|---|
| 156 | subdirectory of the pattern $FM2*.*. The settings notebook can | 
|---|
| 157 | now be closed using esc, F3 or enter; the last 2 save any | 
|---|
| 158 | changes that have been made. You can now select which environment | 
|---|
| 159 | variables to show when using show the environment in the drive | 
|---|
| 160 | tree. Just add or remove from the list on the "Tree" page of | 
|---|
| 161 | the notebook. It defaults initially to the current list. You can | 
|---|
| 162 | now save/append either a full pathname or just a filename or a | 
|---|
| 163 | list of either to the clipboard. We have changed the wording | 
|---|
| 164 | in the menus to make this easier to find. We fixed a few other | 
|---|
| 165 | minor issues see the history for more details. | 
|---|
| 166 |  | 
|---|
| 167 | FM/2 3.11 adds the option of having delete move the objects | 
|---|
| 168 | to the Xworkplace trashcan. Undelete will open the trashcan | 
|---|
| 169 | so you can restore deleted files. The only short coming is you | 
|---|
| 170 | will need to rescan in order to see the restored file. | 
|---|
| 171 | We also added a reserved state which allows you to return | 
|---|
| 172 | FM/2 to the state it was in on start up (the shut down state). | 
|---|
| 173 | We have improved the filtering of file names that contain | 
|---|
| 174 | multiple periods and fixed FM/2's failure to always follow | 
|---|
| 175 | the details settings from the setup notebook. The primary | 
|---|
| 176 | task achieved for this release was the addition of fortify | 
|---|
| 177 | support which allowed us to fix a handful of memory usage | 
|---|
| 178 | related bugs. We fixed a few other minor issues see the | 
|---|
| 179 | history for more details. | 
|---|
| 180 |  | 
|---|
| 181 | Fm/2 3.10 adds the ability to set the command line length | 
|---|
| 182 | to correspond to the command shell you are using. We have | 
|---|
| 183 | moved some menu items to submenus to reduce menu clutter | 
|---|
| 184 | while adding "unhide" to reveal previously hidden items and | 
|---|
| 185 | adding a settings notebook submenu to allow selection of the | 
|---|
| 186 | page you wish to visit. We have updated the look of several | 
|---|
| 187 | dialogs and containers including adding the ability to remember | 
|---|
| 188 | size location and presentation parameters. We have reworked | 
|---|
| 189 | the save state on close so it will save the different states | 
|---|
| 190 | of multiple directory containers and in greater detail. This | 
|---|
| 191 | state can also be restored at anytime during a session by | 
|---|
| 192 | selecting it from the "States" drop down. We have provided better | 
|---|
| 193 | progress indicators to update the progress of long operations. | 
|---|
| 194 | We now provide both the SYM & MAP files in a separate warpin | 
|---|
| 195 | package. This will allow interested individuals the tools needed | 
|---|
| 196 | to assist with analyzing any problem that may occur. This | 
|---|
| 197 | package is not needed to run FM/2. As always this update | 
|---|
| 198 | provides some performance enhancements and defect fixes. | 
|---|
| 199 |  | 
|---|
| 200 | FM/2 3.09 adds "mailto:" so you can configure the ability to | 
|---|
| 201 | double click an email address in the new viewer and have it | 
|---|
| 202 | open a new email using that address. The viewer page in the | 
|---|
| 203 | settings notebook was split into 2 pages to facilitate the | 
|---|
| 204 | change. Additionally, We fixed some defects and enhanced | 
|---|
| 205 | performance in some areas such as commandline quoting. | 
|---|
| 206 |  | 
|---|
| 207 | FM/2 3.08 has had changes to its file filtering logic. | 
|---|
| 208 | It now searches for the last extension if a mask like *.zip | 
|---|
| 209 | is used. This change was made to over come the problem with | 
|---|
| 210 | associations failing on files with multiple ".". You can | 
|---|
| 211 | also search for a complete string within the file names by | 
|---|
| 212 | using the pattern *stuff* (stuff can't contain an * or ?). | 
|---|
| 213 | If "stuff" contains an * or ? the old method of searching | 
|---|
| 214 | (character by character)is used.Large (>4GiB) file support | 
|---|
| 215 | has been added. | 
|---|
| 216 |  | 
|---|
| 217 | FM/2 3.07 had changes made to its ini file structure. | 
|---|
| 218 | These changes mean that the ini file is not backward | 
|---|
| 219 | compatible. Please backup you FM3.INI file before installing | 
|---|
| 220 | so you can revert to an earlier version without losing some | 
|---|
| 221 | of your customizations. Please note you need to leave a copy | 
|---|
| 222 | of the fm3.ini file in the install directory in order to keep your | 
|---|
| 223 | customizations in 3.07. The temp file fm3.!!! will not update | 
|---|
| 224 | the new ini as it is only used when fm2 is running. | 
|---|
| 225 |  | 
|---|
| 226 | File Manager/2 (FM/2) starting with version 3.6 is being | 
|---|
| 227 | built with OpenWatcom. Changing compilers can introduce | 
|---|
| 228 | unexpected problem so you may want to backup your current | 
|---|
| 229 | install, or at minimum have a working copy of the FM/2 | 
|---|
| 230 | version 3.5.9 warpin available for reinstall if problems arise. | 
|---|
| 231 | To backup your current install simple zip up your install | 
|---|
| 232 | directory with its subdirectories or copy them to a different | 
|---|
| 233 | location.To restore simply copy the old FM/2 back to the | 
|---|
| 234 | its original location. Remember you can't use the new FM/2 | 
|---|
| 235 | to do this since if it is running some files will be locked | 
|---|
| 236 | and won't be replaced. If you didn't backup and need to go | 
|---|
| 237 | back just install the 3.5.9 warpin package over the new | 
|---|
| 238 | install. It will warn you that the install is newer but just | 
|---|
| 239 | tell it to install anyway. The warpin install process is | 
|---|
| 240 | designed to save all your customizations. Don't delete the | 
|---|
| 241 | new install if you don't have a backup since this will result | 
|---|
| 242 | in the loss of any custom changes you have made. If you need | 
|---|
| 243 | to delete it to get the reinstall to work. Backup up the new | 
|---|
| 244 | install and then copy the *.bmp, *.tls, *.dat, *.cmd & *.ini | 
|---|
| 245 | files back to the install directory after the reinstall. | 
|---|
| 246 | Don't copy the *.str files as they are version specific. | 
|---|
| 247 | If you have problems be sure to report it (See Support | 
|---|
| 248 | at the end of this file). | 
|---|
| 249 |  | 
|---|
| 250 | File Manager/2 (FM/2) is a free OS/2(Warp)/eCS Presentation | 
|---|
| 251 | Manager 32-bit file/directory/archive maintenance utility | 
|---|
| 252 | (a sort of super-Drives object, something midway between the | 
|---|
| 253 | Drives objects and a more traditional file manager) with plenty | 
|---|
| 254 | of bells, whistles and utilities, drag and drop, context menus, | 
|---|
| 255 | toolbars, bubble help and accelerator keys. If you know how | 
|---|
| 256 | to use OS/2, you already know how to use most of FM/2. You | 
|---|
| 257 | can easily glean the rest from the extensive online help, | 
|---|
| 258 | including tutorials. | 
|---|
| 259 |  | 
|---|
| 260 | This document explains how to install FM/2, including | 
|---|
| 261 | upgrading from previous versions. It explains command line | 
|---|
| 262 | syntaxes (parameters in a program object) and how to get the | 
|---|
| 263 | program(s) running. The online help tells you how to | 
|---|
| 264 | actually use FM/2. I'll try to keep this brief. | 
|---|
| 265 |  | 
|---|
| 266 | This program is free software; you can redistribute it | 
|---|
| 267 | and/or modify it under the terms of the GNU General Public | 
|---|
| 268 | License as published by the Free Software Foundation; either | 
|---|
| 269 | version 2 of the License, or (at your option) any later | 
|---|
| 270 | version. | 
|---|
| 271 |  | 
|---|
| 272 | This program is distributed in the hope that it will be | 
|---|
| 273 | useful, but WITHOUT ANY WARRANTY; without even the implied | 
|---|
| 274 | warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR | 
|---|
| 275 | PURPOSE. See the GNU General Public License for more | 
|---|
| 276 | details. | 
|---|
| 277 |  | 
|---|
| 278 | You should have received a copy of the GNU General Public | 
|---|
| 279 | License along with this program; if not, write to the Free | 
|---|
| 280 | Software Foundation, Inc., 59 Temple Place, Suite 330, | 
|---|
| 281 | Boston, MA 02111-1307 USA | 
|---|
| 282 |  | 
|---|
| 283 |  | 
|---|
| 284 | FM/2 3.x installation instructions: | 
|---|
| 285 | ================================== | 
|---|
| 286 |  | 
|---|
| 287 | Pre-requisite: | 
|---|
| 288 | WarpIN 0.9.20 or higher must be installed. | 
|---|
| 289 |  | 
|---|
| 290 | Install (or re-install) from a FM/2 ZIP file distribution | 
|---|
| 291 | --------------------------------------------------------- | 
|---|
| 292 |  | 
|---|
| 293 | 1. Unpack the FM2*.ZIP archive in a private directory (for | 
|---|
| 294 | example, C:\TMP). (UNZIP.EXE works nicely to unpack the | 
|---|
| 295 | file.) Two WPI files, FM2.WPI and FM2UTILS.WPI will be | 
|---|
| 296 | unzipped. | 
|---|
| 297 |  | 
|---|
| 298 | 2. Follow the instructions for installing from WPI file(s) | 
|---|
| 299 | below. | 
|---|
| 300 |  | 
|---|
| 301 |  | 
|---|
| 302 | Install (or re-install) from a FM/2 WPI file distribution | 
|---|
| 303 | --------------------------------------------------------- | 
|---|
| 304 |  | 
|---|
| 305 | 1. Open the WPS folder containing the WPI file(s). | 
|---|
| 306 |  | 
|---|
| 307 | 2. Double click on FM2.WPI. Since WarpIN associates itself | 
|---|
| 308 | with WPI files this will start WarpIN with FM2.WPI as the | 
|---|
| 309 | parameter. | 
|---|
| 310 |  | 
|---|
| 311 | 3, You may then install FM/2 to a directory of your choice | 
|---|
| 312 | and, if FM2UTILS.WPI is present, install FM/2 Utilities to | 
|---|
| 313 | a directory of your choice. | 
|---|
| 314 |  | 
|---|
| 315 | NOTE: If you double click on FM2UTILS.WPI instead of | 
|---|
| 316 | FM2.WPI, you will only be able to install the FM/2 | 
|---|
| 317 | Utilities. It is recommended that, even if you only want to | 
|---|
| 318 | install FM/2 Utilities, that you do so using FM2.WPI. | 
|---|
| 319 |  | 
|---|
| 320 |  | 
|---|
| 321 | Moving FM/2 and/or FM/2 Utilities: | 
|---|
| 322 | ---------------------------------- | 
|---|
| 323 |  | 
|---|
| 324 | 1. Copy your existing installation directory to the new | 
|---|
| 325 | location. | 
|---|
| 326 |  | 
|---|
| 327 | 2. If you have added your own icons to any of the FM/2 | 
|---|
| 328 | folders, then you should move them elsewhere temporarily. | 
|---|
| 329 |  | 
|---|
| 330 | 3. Follow the instructions for de-installing below. | 
|---|
| 331 |  | 
|---|
| 332 | 4. Re-install the package using the installation | 
|---|
| 333 | instructions above. This will update the WarpIN database and | 
|---|
| 334 | reset your icons to the new locations. | 
|---|
| 335 |  | 
|---|
| 336 | 5. Move the icons you saved in step #2, back into the FM/2 | 
|---|
| 337 | folders if you wish. | 
|---|
| 338 |  | 
|---|
| 339 |  | 
|---|
| 340 | De-installing FM/2 and/or FM/2 Utilities: | 
|---|
| 341 | ----------------------------------------- | 
|---|
| 342 |  | 
|---|
| 343 | 1. Run Warpin without parameters. | 
|---|
| 344 |  | 
|---|
| 345 | 2. Right click on a package you want to de-install and | 
|---|
| 346 | select "de-install all packages". | 
|---|
| 347 |  | 
|---|
| 348 | 3. Click on OK in the "De-install Packages" window that | 
|---|
| 349 | appears. | 
|---|
| 350 |  | 
|---|
| 351 |  | 
|---|
| 352 |  | 
|---|
| 353 | ================= | 
|---|
| 354 | First-time notes: | 
|---|
| 355 | ================= | 
|---|
| 356 |  | 
|---|
| 357 | Starting FM/2 -- how it works, customizing parameters: | 
|---|
| 358 |  | 
|---|
| 359 | If you start File Manager/2 (filename FM3.EXE) with no | 
|---|
| 360 | parameters, it opens the Drive Tree window but no directory | 
|---|
| 361 | windows (unless the "Save state of dir windows" toggle is | 
|---|
| 362 | checked -- see online help). | 
|---|
| 363 |  | 
|---|
| 364 | File Manager/2 optionally accepts names of directories in | 
|---|
| 365 | the parameters field of its program object; it'll open a | 
|---|
| 366 | directory window for each one. Hint: If you often do | 
|---|
| 367 | different specific things with FM/2, you might set up a WPS | 
|---|
| 368 | object customized to start up ideally for each activity. For | 
|---|
| 369 | example, if you wanted to maintain your BBS areas, you might | 
|---|
| 370 | have one object with parameters like: "D:\BBSDIR | 
|---|
| 371 | D:\BBSDIR\MAILIN D:\BBSDIR\MAILOUT", and if you also like to | 
|---|
| 372 | use FM/2 to set icons on files, you might have another | 
|---|
| 373 | object with parameters like: "E:\MYICONS D:\NEWFILES". The | 
|---|
| 374 | State quicklist can also be used for this within FM/2 itself | 
|---|
| 375 | -- see online help. | 
|---|
| 376 |  | 
|---|
| 377 | You can exclude drives in the parameters by prefacing the | 
|---|
| 378 | drive letter with "/", and there can be more than one drive | 
|---|
| 379 | letter behind the "/" (i.e. "/BH" to exclude both drives B: | 
|---|
| 380 | and H:). Hint: Many people like to use /B to exclude | 
|---|
| 381 | "phantom" drive B: if they have a single-floppy system. | 
|---|
| 382 | Similarly, you can cause drives NOT to be prescanned by the | 
|---|
| 383 | Drive Tree by prefacing the drive letter with ";", drives | 
|---|
| 384 | NOT to load icons for objects by prefacing the drive letter | 
|---|
| 385 | with ",", drives NOT to load subjects for objects by | 
|---|
| 386 | prefacing the drive letter with "`" and drives NOT to load | 
|---|
| 387 | longnames for objects by prefacing the drive letter with | 
|---|
| 388 | "'". This can be handy if you have a very slow drive like a | 
|---|
| 389 | CD-ROM or Zip drive. FM/2 Lite recognizes these switches, | 
|---|
| 390 | too. See also the Drive Flags dialog in FM/2. | 
|---|
| 391 |  | 
|---|
| 392 | If you place the plus sign "+" (alone, separated from | 
|---|
| 393 | anything else by spaces) in the parameters, FM/2 will log, | 
|---|
| 394 | to FM2.LOG, delete, rename, move and copy operations that | 
|---|
| 395 | are performed by drag-and-drop or with the menus. FM/2 Lite | 
|---|
| 396 | recognizes this switch, too. | 
|---|
| 397 |  | 
|---|
| 398 | The parameter "-" (alone, separated from anything else by | 
|---|
| 399 | spaces) causes FM/2 to ignore, not load or save, the | 
|---|
| 400 | previous state of directory windows (see the "Save state of | 
|---|
| 401 | dir windows" toggle under Config Menu->Toggles in the online | 
|---|
| 402 | help) for that invocation. | 
|---|
| 403 |  | 
|---|
| 404 | You can specify the name of an alternate INI file with | 
|---|
| 405 | "-<inifilename>" -- for example: "-C:\FM2\MYINI.INI". | 
|---|
| 406 |  | 
|---|
| 407 | You can also specify the INI file location with the | 
|---|
| 408 | environment variable FM2INI -- for example: | 
|---|
| 409 | SET FM2INI=C:\FM2\MYINI.INI. | 
|---|
| 410 |  | 
|---|
| 411 |  | 
|---|
| 412 | ------------------------------ | 
|---|
| 413 | How to get started using FM/2: | 
|---|
| 414 | ----------------------------- | 
|---|
| 415 | Please read the following sections in the online help when | 
|---|
| 416 | you start FM/2 for the first time: "How to use FM/2's Help," | 
|---|
| 417 | "Terminology" and "General Help," then "Hints." A peek at | 
|---|
| 418 | the labeled "Window Layouts" pictures would probably be a | 
|---|
| 419 | good idea, too. The rest you can browse as you get time/feel | 
|---|
| 420 | the need; for instance, if you want to know what a toggle | 
|---|
| 421 | does, read the help under Settings notebook for that page | 
|---|
| 422 | (each Settings notebook page has its own Help button). | 
|---|
| 423 |  | 
|---|
| 424 | If you prefer hard copy help, print this file, run FM/2, | 
|---|
| 425 | press F1, click the "Print" button at the bottom (IBM View) | 
|---|
| 426 | or top (Newview)of the help window that appears and then print | 
|---|
| 427 | both the "Contents" and "All sections" (keep an eye on the printer, | 
|---|
| 428 | after page 100 of "All sections" as the Help Manager will | 
|---|
| 429 | begin printing its own help then -- you may want to abort | 
|---|
| 430 | printing at that point). Advanced and/or curious users may | 
|---|
| 431 | also want to print FM3TOOLS.DAT and ARCHIVER.BB2. Be sure | 
|---|
| 432 | you have plenty of paper and ink handy -- the package is | 
|---|
| 433 | well documented. You'll probably also want a three-ring | 
|---|
| 434 | binder and hole punch to get it bound, as staples aren't | 
|---|
| 435 | going through that puppy. You can, of course, print only the | 
|---|
| 436 | sections that are of particular interest to you. | 
|---|
| 437 |  | 
|---|
| 438 | Additional documentation: | 
|---|
| 439 | ------------------------ | 
|---|
| 440 | FM3.HLP:        FM/2's online help file. | 
|---|
| 441 |  | 
|---|
| 442 | Look in the FM/2 Docs subfolder of the File Manager/2 folder | 
|---|
| 443 | for easy access to all documentation. | 
|---|
| 444 |  | 
|---|
| 445 |  | 
|---|
| 446 | Bonus programs: | 
|---|
| 447 | ============== | 
|---|
| 448 |  | 
|---|
| 449 | You'll note the extra objects that the Install program | 
|---|
| 450 | creates in the FM/2 Tools subfolder of the File Manager/2 | 
|---|
| 451 | folder. FM/2 is modular, so that you can get directly to | 
|---|
| 452 | some of its components without running the entire ball of | 
|---|
| 453 | wax. This may allow you to enhance the behavior of some of | 
|---|
| 454 | your other applications in the WPS tradition. You don't | 
|---|
| 455 | _have_ to keep these around, of course -- FM/2 itself | 
|---|
| 456 | contains all their functionality. | 
|---|
| 457 |  | 
|---|
| 458 | ARCHIVE VIEWER/2: Intended for drag-and-drop operation (or | 
|---|
| 459 | WPS association) with WPS objects or other applications. | 
|---|
| 460 | Drag an archive onto it, drop it, get an archive listing | 
|---|
| 461 | box. FM/2's installation program sets up some associations | 
|---|
| 462 | between archive files and this program by file extension. | 
|---|
| 463 | AV/2 will try to display whatever you give it as | 
|---|
| 464 | sensibly as it can. Filename AV2.EXE. | 
|---|
| 465 |  | 
|---|
| 466 | EA VIEWER: Drag a file system object onto it and it'll show | 
|---|
| 467 | you the object's extended attributes. Filename EAS.EXE. | 
|---|
| 468 |  | 
|---|
| 469 | INI VIEWER: Drag an .INI file onto it and it'll show you its | 
|---|
| 470 | contents. Filename INI.EXE. | 
|---|
| 471 |  | 
|---|
| 472 | BOOKSHELF VIEWER: Shows all .INF files in a listbox and lets | 
|---|
| 473 | you pick the one(s) you want to view. If you give any | 
|---|
| 474 | command line argument, the .HLP files on the HELP path will | 
|---|
| 475 | be shown instead (the Helpfile Viewer object calls | 
|---|
| 476 | VIEWINFS.EXE with "dummy" for an argument, for example). | 
|---|
| 477 | Filename VIEWINFS.EXE. | 
|---|
| 478 |  | 
|---|
| 479 | PROCESS KILLER: Lets you kill off renegade processes. An | 
|---|
| 480 | English version of PSTAT.EXE must be on your PATH. Filename | 
|---|
| 481 | KILLPROC.EXE. | 
|---|
| 482 |  | 
|---|
| 483 | UNDELETE: Lets you undelete files (via interface with | 
|---|
| 484 | UNDELETE.COM). Drag a file system object onto it and it'll | 
|---|
| 485 | let you undelete files for that drive. Filename UNDEL.EXE. | 
|---|
| 486 |  | 
|---|
| 487 | VISUAL TREE: Opens a Drive Tree window (like the WPS Drives | 
|---|
| 488 | object with more horsepower). Filename VTREE.EXE. | 
|---|
| 489 |  | 
|---|
| 490 | VISUAL DIRECTORY: Opens a Directory Container window; drag a | 
|---|
| 491 | file system object onto it and this will open its directory | 
|---|
| 492 | (like a WPS directory Folder with more horsepower). Filename | 
|---|
| 493 | VDIR.EXE. | 
|---|
| 494 |  | 
|---|
| 495 | COLLECTOR: Opens a Collector window. Filename VCOLLECT.EXE. | 
|---|
| 496 | Two other objects, "See all files" and "Seek and scan" are | 
|---|
| 497 | created which call up the Collector and go directly to | 
|---|
| 498 | dialogs for the appropriate purpose. | 
|---|
| 499 |  | 
|---|
| 500 | GLOBAL VIEWER: Opens a global view of a drive or drives. | 
|---|
| 501 | Filename GLOBAL.EXE. | 
|---|
| 502 |  | 
|---|
| 503 | DATABAR: Opens a databar showing some system information. | 
|---|
| 504 | Filename DATABAR.EXE. | 
|---|
| 505 |  | 
|---|
| 506 | DIRSIZE: Shows where drive usage is concentrated. Filename | 
|---|
| 507 | DIRSIZE.EXE. | 
|---|
| 508 |  | 
|---|
| 509 | FM/2 LITE: A simplified interface for "dummies." Filename | 
|---|
| 510 | FM4.EXE. | 
|---|
| 511 |  | 
|---|
| 512 | FM/2's install creates FM2.CMD, AV2.CMD, VDIR.CMD, | 
|---|
| 513 | VTREE.CMD, VCOLLECT.CMD, UNDEL.CMD, KILLPROC.CMD, INI.CMD, | 
|---|
| 514 | EAS.CMD, DIRSIZE.CMD, VIEWINFS.CMD and VIEWHELP.CMD files | 
|---|
| 515 | for you in a directory "utils" off the install directory. | 
|---|
| 516 | You should add this directory to your PATH= statement in | 
|---|
| 517 | CONFIG.SYS (type HELP PATH at a command line for more info). | 
|---|
| 518 | If you prefer, FM/2's INSTALL builds a SETENV.CMD in the | 
|---|
| 519 | FM/2 directory which you can call to set the PATH for FM/2 | 
|---|
| 520 | in any given session without modifying CONFIG.SYS. | 
|---|
| 521 |  | 
|---|
| 522 |  | 
|---|
| 523 | Troubleshooting: | 
|---|
| 524 | =============== | 
|---|
| 525 |  | 
|---|
| 526 | FM/2 seems much slower than previous versions. | 
|---|
| 527 | The Find Buffer in FM/2 has been reworked to make it user | 
|---|
| 528 | settable in more place and significantly enlarge it. This | 
|---|
| 529 | significantly increases the loading speed for large directories | 
|---|
| 530 | However, most users will need to reset the buffer by going | 
|---|
| 531 | to the settings notebook scanning page and setting FindBuf. | 
|---|
| 532 | The new default for clean installs is 10240. We recommend you | 
|---|
| 533 | change to this setting (or higher) unless you have very limited | 
|---|
| 534 | hardware (less than 32 meg of memory original Pentium or earlier). | 
|---|
| 535 |  | 
|---|
| 536 | If FM/2 won't run, the probable culprit is CONFIG.SYS. Your | 
|---|
| 537 | LIBPATH statement should contain a ".;" entry. If yours | 
|---|
| 538 | doesn't, add it. It's standard for an OS/2 installation, but | 
|---|
| 539 | some buggy install programs knock it out because they | 
|---|
| 540 | translate entries to their full pathname before rewriting | 
|---|
| 541 | (so ".;" gets translated to whatever the current directory | 
|---|
| 542 | is for the buggy install program). What this ".;" entry does | 
|---|
| 543 | is allow a program to find and use .DLL files in the | 
|---|
| 544 | program's current directory -- obviously something you want | 
|---|
| 545 | programs to be able to do, otherwise you'd have to put every | 
|---|
| 546 | application's .DLLs into directories already on the LIBPATH, | 
|---|
| 547 | or add the directories of all applications to the LIBPATH, a | 
|---|
| 548 | rather huge pain in the, uh, neck. | 
|---|
| 549 |  | 
|---|
| 550 | If things in FM/2 are suddenly acting strange after an | 
|---|
| 551 | upgrade, first check the integrity of the install using | 
|---|
| 552 | using WarpIN. If it shows a problem rerun the install | 
|---|
| 553 | package. If that fails try installing to a new directory | 
|---|
| 554 | or backup your existing directory so you can save any changes | 
|---|
| 555 | you made to the template files then uninstall and reinstall. | 
|---|
| 556 | Once you have FM/2 working migrate the *.ini, *.dat, *.tls, | 
|---|
| 557 | *.bb2 and *.cmd from your old install/backup to recover your | 
|---|
| 558 | custom settings | 
|---|
| 559 |  | 
|---|
| 560 | If the "FM/2 Online Help" object in the "FM/2 Docs" | 
|---|
| 561 | subfolder won't work properly, you've got a version of | 
|---|
| 562 | VIEW.EXE that won't directly display help (.HLP) files. Use | 
|---|
| 563 | SEEHELP.EXE from the FM/2 Utilities package to get around | 
|---|
| 564 | this problem (or upgrade your version of OS/2). | 
|---|
| 565 |  | 
|---|
| 566 | Don't drag files over Netscape -- it will lock up if files | 
|---|
| 567 | (not WPS objects; there's a subtle difference) are dragged | 
|---|
| 568 | over it. | 
|---|
| 569 |  | 
|---|
| 570 | If you get a popup dialog that needs to be reported to the | 
|---|
| 571 | maintainer, you can either take a screen shot or you can | 
|---|
| 572 | capture the information from STDERR with: | 
|---|
| 573 |  | 
|---|
| 574 | FM3 2>STDERR.LOG | 
|---|
| 575 |  | 
|---|
| 576 | This technique works for all the FM/2, FM/2 Lite and all the | 
|---|
| 577 | standalone applets. | 
|---|
| 578 |  | 
|---|
| 579 | If you are having trouble with Drag and Drop operations, try | 
|---|
| 580 | the + command line switch described above. The content of | 
|---|
| 581 | FM2.LOG may be helpful. | 
|---|
| 582 |  | 
|---|
| 583 |  | 
|---|
| 584 | Known problems/shortcomings: | 
|---|
| 585 | =========================== | 
|---|
| 586 |  | 
|---|
| 587 | - FM/2 does not properly report sizes of some files with | 
|---|
| 588 | long name resident on Win95/NT drives. | 
|---|
| 589 |  | 
|---|
| 590 | - File List Container fails to fill after drive change | 
|---|
| 591 | SYS0039 error. | 
|---|
| 592 |  | 
|---|
| 593 | - Tree switching on Focus/Directory Change appears to be | 
|---|
| 594 | slower than expected. | 
|---|
| 595 |  | 
|---|
| 596 | - Access to LS120 and FAT32 drives may be slower than expected | 
|---|
| 597 |  | 
|---|
| 598 | - Icon display in Directory Container does not always match | 
|---|
| 599 | WPS icons | 
|---|
| 600 |  | 
|---|
| 601 | - Spurious WPS Objects Handles may be created during some | 
|---|
| 602 | operations | 
|---|
| 603 |  | 
|---|
| 604 | - Trying to run Global.exe from the command line in 4OS2 | 
|---|
| 605 | (perhaps other shells) results in the execution of 4OS2's "Global" | 
|---|
| 606 | command. Global.exe can be run by placing it in quotes or | 
|---|
| 607 | prefixing it with *. See 4OS2's documentation for more information. | 
|---|
| 608 |  | 
|---|
| 609 | - As with any OS/2 program significant changes (such as our | 
|---|
| 610 | change to OpenWatcom) will result in the incompatibility of | 
|---|
| 611 | older (VAC) exes with new dlls and vice versa. Attempting to run | 
|---|
| 612 | OpenWatcom exes with a VAC dll loaded in memory or in your | 
|---|
| 613 | libpath ahead of the new version will result in a SYS3175 in | 
|---|
| 614 | popuplog.os2. The reverse gives a SYS2070. If you experience these | 
|---|
| 615 | problems search your libpath for fm3dll.dll and remove or rename | 
|---|
| 616 | it. Your libpath should have "." (without the quotes) as your | 
|---|
| 617 | first entry to minimize the likelihood of this problem. FM/2's | 
|---|
| 618 | installer does not add the FM/2 directory to the libpath. | 
|---|
| 619 |  | 
|---|
| 620 | - See http://svn.netlabs.org/fm2/report/1 for a complete list of | 
|---|
| 621 | currently active bugs | 
|---|
| 622 |  | 
|---|
| 623 |  | 
|---|
| 624 |  | 
|---|
| 625 | About FM/2: | 
|---|
| 626 | ========== | 
|---|
| 627 |  | 
|---|
| 628 | FM/2 was originally written by: | 
|---|
| 629 |  | 
|---|
| 630 | Mark Kimes | 
|---|
| 631 | <hectorplasmic@worldnet.att.net> | 
|---|
| 632 |  | 
|---|
| 633 | He has kindly allowed me to take over maintenance and | 
|---|
| 634 | support of FM/2 and to release the program under the GNU GPL | 
|---|
| 635 | license. I'm sure he would appreciate a Thank You note for | 
|---|
| 636 | his generosity. | 
|---|
| 637 |  | 
|---|
| 638 | Support: | 
|---|
| 639 | ======= | 
|---|
| 640 |  | 
|---|
| 641 | There is a Yahoo group devoted to fm/2 at: | 
|---|
| 642 |  | 
|---|
| 643 | http://groups.yahoo.com/group/fm2user/ | 
|---|
| 644 |  | 
|---|
| 645 | This group is now closed but it still contains some useful information | 
|---|
| 646 |  | 
|---|
| 647 | There is a new mailing list at: | 
|---|
| 648 |  | 
|---|
| 649 | fm2-user@netlabs.org | 
|---|
| 650 |  | 
|---|
| 651 | To subscribe send an email to: | 
|---|
| 652 |  | 
|---|
| 653 | fm2-user-subscribe@netlabs.org | 
|---|
| 654 |  | 
|---|
| 655 | The subject and body can be empty. | 
|---|
| 656 |  | 
|---|
| 657 | This group is mirrored on Gmane at: | 
|---|
| 658 |  | 
|---|
| 659 | http://dir.gmane.org/gmane.org.netlabs.fm2.user | 
|---|
| 660 |  | 
|---|
| 661 | You will find lots of friendly folks ready to help. | 
|---|
| 662 |  | 
|---|
| 663 | FM/2 has moved to Netlabs (thanks Adrian). | 
|---|
| 664 |  | 
|---|
| 665 | Check it out at | 
|---|
| 666 |  | 
|---|
| 667 | http://svn.netlabs.org/fm2 | 
|---|
| 668 |  | 
|---|
| 669 | To create a ticket reporting a defect or requesting an enhancement. | 
|---|
| 670 | You must be logged into TRAC. Please login with your Netlabs login id. | 
|---|
| 671 | If you do not have a login id, you can request one at | 
|---|
| 672 | http://www.netlabs.org/en/site/member/member.xml. | 
|---|
| 673 | If you have troubles acquiring a Netlabs login id send an e-mail to | 
|---|
| 674 | Netlabs Community Mailing List <community@netlabs.org>. | 
|---|
| 675 |  | 
|---|
| 676 | You can also browse the source at this site. | 
|---|
| 677 |  | 
|---|
| 678 | To obtain the source from the SVN use something like the following to check out the trunk | 
|---|
| 679 |  | 
|---|
| 680 | mkdir fm2_workspace | 
|---|
| 681 | cd fm2_workspace | 
|---|
| 682 | svn checkout http://svn.netlabs.org/repos/fm2/trunk trunk | 
|---|
| 683 |  | 
|---|
| 684 | If you wish commit access please contact us directly. | 
|---|
| 685 |  | 
|---|
| 686 | You can reach us directly at: | 
|---|
| 687 |  | 
|---|
| 688 | Steven H. Levine | 
|---|
| 689 | steve53@earthlink.net | 
|---|
| 690 |  | 
|---|
| 691 | or | 
|---|
| 692 |  | 
|---|
| 693 | Gregg Young | 
|---|
| 694 | ygk@qwest.net | 
|---|
| 695 |  | 
|---|
| 696 | We also monitor the comp.os.os2.apps newsgroup, several | 
|---|
| 697 | others in the comp.os.os2.* hierarchy and other groups where | 
|---|
| 698 | release announcements are made. | 
|---|
| 699 |  | 
|---|
| 700 | Thanks and enjoy. | 
|---|
| 701 |  | 
|---|
| 702 | $Id: README 1468 2009-09-21 17:23:53Z stevenhl $ | 
|---|