home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 035 / fm2_214.zip / READ.ME < prev    next >
Text File  |  1994-10-30  |  15KB  |  309 lines
  1.  ┌──────────────────────────────────────────────────────────────────────────┐
  2.  │F(ile) M(anager)/2 copyright (c) 1993/94 by M. Kimes (Bare Bones Software)│
  3.  │                            All Rights Reserved                           │
  4.  ├──────────────────────────────────────────────────────────────────────────┤
  5.  │                READ.ME file -- read before installing                    │
  6.  │        See end of document for contact info and license details          │
  7.  └──────────────────────────────────────────────────────────────────────────┘
  8.  
  9.  
  10. File Manager/2 (FM/2) is a shareware OS/2 2.1+ PM 32-bit
  11. file/directory/archive maintenance utility (a sort of super-Drives
  12. object, something midway between the Drives objects and a more
  13. traditional file manager) with plenty of bells, whistles and utilities,
  14. drag and drop, context menus, toolbars and accelerator keys.  If you
  15. know how to use OS/2, you already know how to use most of FM/2.  You can
  16. easily glean the rest from the extensive online help.
  17.  
  18. This document explains how to install FM/2, including upgrading from
  19. previous versions.  It explains command line syntaxes and how to get the
  20. program(s) running.  The online help tells you how to actually use FM/2.
  21. A separate document (history.txt) lists changes for this version.
  22. Another (register.txt) tells you how to register FM/2.
  23.  
  24.  
  25. FM/2 2.14 installation instructions:
  26. ===================================
  27.  
  28.    1. Unpack the FM2_214 archive in a private directory (UNZIP.EXE
  29.       works nicely).  FM/2 2.x requires its own home directory (FAT or
  30.       HPFS, doesn't matter). I recommend that it _not_ be your old FM/2
  31.       1.x directory (and don't delete the old 1.x version until after
  32.       you install, so the install program can migrate some of your old
  33.       settings and registration first).  If upgrading from 2.x, just
  34.       unpack the files in the FM/2 2.x directory and go (you might want
  35.       to skip ARCHIVER.BB2 if you've customized it).
  36.  
  37.   2.  Run the provided INSTALL.CMD (a simple REXX program) in that
  38.       directory to build a folder and program objects and migrate some
  39.       old INI information.  Rerun INSTALL.CMD if you later move the FM/2
  40.       directory.  (If you later decide to remove FM/2, run UNINSTAL.CMD
  41.       in the FM/2 2.x directory and follow simple directions.  Both
  42.       installation and deinstallation are no-brainers.  UNINSTAL will
  43.       help you quickly and easily remove all traces of FM/2 from your
  44.       system if you don't like it for some reason.  All OS/2 programs
  45.       should be so nice.)
  46.  
  47.   3.  Run it.  Have fun.  Full help is available from within the
  48.       program.  If you're unfamiliar with OS/2's WPS, please take the
  49.       time to run the OS/2 Tutorial before attempting to use FM/2, as
  50.       FM/2 uses many of the same conventions.
  51.  
  52.  
  53. Starting FM/2:
  54. =============
  55.  
  56. If you start File Manager/2 (filename FM3.EXE) with no command line
  57. arguments, it opens the Drive Tree window but no directory windows
  58. (unless the "Save state of dir windows" toggle is checked -- see online
  59. help).
  60.  
  61. File Manager/2 optionally accepts names of directories on the command
  62. line; it'll open a directory window for each one.  Hint:  If you often
  63. do different specific things with FM/2, you might set up a WPS object
  64. customized to start up ideally for each activity.  For example, if you
  65. wanted to maintain your BBS areas, you might have one object like:
  66. "FM3.EXE D:\BBSDIR D:\BBSDIR\MAILIN", and if you also like to use FM/2
  67. to set icons on files, you might have another object like:  "FM3.EXE
  68. E:\MYICONS D:\NEWFILES".
  69.  
  70. You can exclude drives on the command line by prefacing the drive letter
  71. with "/", and there can be more than one drive letter behind the "/"
  72. (i.e. "FM3.EXE /BH" to exclude both drives B: and H:).  Hint:  Many
  73. people like to use /B to exclude "phantom" drive B: if they have a
  74. single-floppy system.
  75.  
  76. You can start FM/2 minimized by placing the argument "~" on the command
  77. line.  The frame window will show briefly before minimizing.
  78.  
  79. If you place the argument "+" on the command line, FM/2 will log, to
  80. FM2.LOG, delete, rename, move and copy operations that are performed by
  81. drag-and-drop or with the menus.
  82.  
  83. The command line argument "-" causes FM/2 to ignore, not load or save,
  84. the previous state of directory windows (see the "Save state of dir
  85. windows" toggle under Config Menu->Toggles in the online help) for that
  86. invocation.
  87.  
  88.  
  89. Installation notes:
  90. ==================
  91.  
  92. Please read the following sections in the online help when you start
  93. FM/2 for the first time:  "How to use FM/2's Help," "Terminology" and
  94. "General Help," then "Hints."  The rest you can browse as you get
  95. time/feel the need; for instance, if you want to know what a toggle
  96. does, read the help under Settings notebook->Toggles page.
  97.  
  98. You may want to either move ARCHIVER.BB2 (the data file containing
  99. information about archiver programs and archive files) to a directory in
  100. your PATH= statement or erase this one if you've customized an old one.
  101. FM/2 can still find, use and maintain ARCHIVER.BB2 on the PATH; it
  102. doesn't have to be in FM/2's directory (this allows it to be used by
  103. other programs as well, like XGroup, XBBS/2, LA, AV, etc.).
  104.  
  105. Bonus programs:
  106. --------------
  107.  
  108. You'll note the extra objects that the Install program creates in the
  109. File Manager/2 folder.  FM/2 is modular, so that you can get directly to
  110. some of its components without running the entire ball of wax.  This may
  111. allow you to enhance the behavior of some of your other applications in
  112. the WPS tradition.  You don't _have_ to keep these around, of course --
  113. FM/2 itself contains all their functionality.
  114.  
  115.   Archive Viewer/2:   Intended for drag-and-drop operation (or WPS
  116.                       association) with WPS objects or other
  117.                       applications.  Drag an archive onto it, drop it,
  118.                       get an archive listing box.  FM/2's installation
  119.                       program sets up some associations between archive
  120.                       files and this program by file extension (run
  121.                       INSTALL with "NOASSOC" as an argument if you don't
  122.                       want them).  Filename AV2.EXE.
  123.  
  124.   SysIcon:            Intended to let you change a system pointer by
  125.                       dragging an icon/pointer file (*.ICO or *.PTR)
  126.                       onto it, then picking the pointer to replace. You
  127.                       can reset a pointer by starting it without
  128.                       arguments.  Filename DOICON.EXE.
  129.  
  130.   EA Viewer:          Drag a file system object onto it and it'll show
  131.                       you the object's extended attributes.  Filename
  132.                       EAS.EXE.
  133.  
  134.   INI Viewer:         Drag an .INI file onto it and it'll show you its
  135.                       contents.  Filename INI.EXE.
  136.  
  137.   Bookshelf Viewer:   Shows all .INF files in a listbox and lets you
  138.                       pick the one(s) you want to view.  If you give any
  139.                       command line argument, the .HLP files on the HELP
  140.                       path will be shown instead (the Helpfile Viewer
  141.                       object calls VIEWINFS.EXE with "dummy" for an
  142.                       argument, for example).  Filename VIEWINFS.EXE.
  143.  
  144.   Process Killer:     Lets you kill off renegade processes.  An English
  145.                       version of PSTAT.EXE must be on your PATH.
  146.                       Filename KILLPROC.EXE.
  147.  
  148.   Undeleter:          Lets you undelete files (via interface with
  149.                       UNDELETE.COM).  Drag a file system object onto it
  150.                       and it'll let you undelete files for that drive.
  151.                       Filename UNDEL.EXE.
  152.  
  153.   Visual Tree:        Opens a Drive Tree window (like the WPS Drives
  154.                       object with more horsepower).  Filename VTREE.EXE.
  155.  
  156.   Visual Directory:   Opens a Directory Container window; drag a file
  157.                       system object onto it and this will open its
  158.                       directory (like a WPS directory Folder with more
  159.                       horsepower).  Filename VDIR.EXE.
  160.  
  161.   Collector:          Opens a Collector window.  Filename VCOLLECT.EXE.
  162.  
  163. Another bonus:
  164. -------------
  165.  
  166. I've included a few .CMD files for command line freaks.  If you find
  167. them useful you'll probably want to put them in a directory on your
  168. PATH.  Although FM/2 and the WPS support .SUBJECT EAs (descriptions of
  169. files and directories), not much else does.  This should provide you
  170. with the tools you need to take better advantage of .SUBJECTs.
  171. Obviously you can modify these .CMD files if you like.
  172.  
  173.   CVT4OS2.CMD:        Converts 4OS2/4DOS DESCRIPT.ION files to .SUBJECT
  174.                       EAs.  See comments in file.
  175.  
  176.   CVTFBBS.CMD:        Converts FILES.BBS files to .SUBJECT EAs.  See
  177.                       comments in file.
  178.  
  179.   SUBJ.CMD:           Allows entry of a .SUBJECT EA from the command line.
  180.                       Run without arguments for help.
  181.  
  182.   SDIR.CMD:           A DIR-like command that displays .SUBJECT EAs.  Run
  183.                       SDIR /? for help.
  184.  
  185. Also included LA.EXE, a command line archive manipulator.  Move this and
  186. ARCHIVER.BB2 somewhere on your PATH and you can use it from anywhere.
  187.  
  188. FM2PLAY.EXE is also included in the package; FM/2 uses this when you
  189. select the "Play Multimedia" command from an object's context menu. You
  190. can run it manually; just pass the names of the multimedia files on the
  191. command line.  You can also use wildcards; for instance, to play all the
  192. wave (sound) files in the C:\MMOS2\SOUNDS directory, try: "FM2PLAY.EXE
  193. C:\MMOS2\SOUNDS\*.WAV".  You can also Associate FM2PLAY with multimedia
  194. file types so that they'll be played when double-clicked.  Note:  OS/2
  195. has a command line length limitation of about 1000 characters (as
  196. compared to DOS' limit of about 128), so to play all the files of a type
  197. in a directory, you might want to use a Command something like
  198. FM2PLAY.EXE %p\*.<ext> (where <ext> is the extension of the desired file
  199. type) to get around that limit.  Finally, if you put "/!" as the first
  200. command line argument, FM2PLAY will start in Manual mode (double-click
  201. a filename to play it).
  202.  
  203. FM/2's install creates FM2.CMD and AV2.CMD files for you.  You can copy
  204. these files to a directory listed on your PATH (see SET PATH= in
  205. CONFIG.SYS) and use it to run FM/2 and/or AV2.CMD from any OS/2 command
  206. line, if desired.  A quick copy and text editor modification will let
  207. you build similar command files for the other utility .EXEs, too.
  208.  
  209.  
  210. Additional documentation:
  211. ========================
  212.  
  213.   Register.txt:   How to register FM/2.
  214.   Associat.txt:   Some association recommendations
  215.  
  216.   Note:  Warp II has a weird bug in it that causes FM/2's toolbar to
  217.   come up blank the first time.  Reload the toolbar and it'll work
  218.   fine thereafter.  Don't ask me...
  219.  
  220.  
  221. FM/2 isn't free, it's shareware:
  222. ===============================
  223.  
  224. To register FM/2, fill out REGISTER.TXT and send to the mailing address
  225. listed in it, together with the purchase price (commercial users,
  226. there's a 5% discount for each ten commercial licenses, up to one
  227. hundred licenses, where the price flattens, so you get a total 50%
  228. discount on each license for one hundred or more licenses in one order
  229. -- see REGISTER.TXT for a table).  Registration gets rid of the initial
  230. about box and closing screen, eases your conscience and makes the world
  231. safe for truth, justice, the democratic way and further FM/2 updates,
  232. not necessarily in that order.
  233.  
  234. Registrations are good for one year or one full version change (i.e.
  235. 2.00 -> 3.01), whichever comes first.  Versions before a full version
  236. change stay registered forever.  Considering the price, the program and
  237. the upgrade policy, I don't think you can beat FM/2 with a stick.  But
  238. then, I'm a prejudiced jerk.
  239.  
  240. (Someone asked me why registrations are cheaper for personal use than
  241.  for commercial use.  I thought it was obvious, but I guess it's not.  I
  242.  feel that individual, private use of software should be cheaper than
  243.  use in an environment where it's contributing to making money.  I feel
  244.  that much software is already priced far too high for individual,
  245.  private users as it is, and therefore I give individual, private users
  246.  a 50% break.  It just seems fair to me, and I've got to live with
  247.  myself.)
  248.  
  249. If you have a CIS address, _be sure_ to fill it in on REGISTER.TXT.
  250. You'll get your registration information much more quickly that way. You
  251. can also register online via Compuserve's Shareware Registration service
  252. (GO SWREG) and is #2859 -- warning: the price is a bit higher to give
  253. CIS a cut (CIS will show it to you first).  Support is currently being
  254. provided in the CIS OS/2 Shareware forum (GO OS2SHARE) and regular
  255. updates are posted there.
  256.  
  257. Speaking of updates, I tend to put them up _very_ regularly
  258. (incrementing the version number by .01 each time).  I'm one of those
  259. fellows who likes to always have some new software to play with, so I
  260. figure others might, too.  Besides, it's fun.
  261.  
  262.  
  263. Technical stuff:
  264. ===============
  265.  
  266. There are some limitations to FM/2, imposed by OS/2 2.1's current 16-bit
  267. subsystems (hopefully OS/2 3.0 will remove some or all of these).  It's
  268. possible to overload PM's resources and crash OS/2.  For instance, if I
  269. Collect all the files on all my drives, totaling over 9000 files, PM
  270. will cease up; for another, trying to list a directory containing
  271. hundreds of large icons will cause OS/2 to hang (in FM/2 _or_ a WPS
  272. folder!).  Listbox limitations are more obvious -- a listbox under OS/2
  273. 2.1 cannot contain more than 64k of information (less some system
  274. overhead).  Containers are better, but even they have their
  275. (undocumented) limits (about 320k as nearly as I can tell, though there
  276. seems to be a random element involved).  There also seems to be a bug in
  277. WinLoadFileIcon when called repeatedly (around 512 times in quick
  278. succession, though why "quick succession" seems to be required I don't
  279. know, and the size of the icons loaded may also be involved).
  280.  
  281. If you receive a message box telling you that PM is out of resources,
  282. you've slammed head-on into an OS/2 limitation (you won't always be
  283. notified -- the result is sometimes just an unexplained system lockup).
  284. The good news is that, as OS/2 is improved, these limitations should
  285. vanish without changes to FM/2.  The bad news is that there's no way
  286. around them, that I know of, at the present time (though again I
  287. emphasize that OS/2 3.0 is just over the horizon and may cure some or
  288. all of the problems) except to avoid situations where they occur.
  289.  
  290.  
  291. IMPORTANT!
  292. Simple license statement:
  293. ========================
  294.  
  295. You are granted a license to try this shareware program (FM/2) for up to
  296. thirty (30) days, after which you must register or discontinue its use.
  297. Permission is granted to redistribute the unaltered shareware archive
  298. for a reasonable (read nominal, small) copying charge.  FM/2 may
  299. specifically not be packaged with a book without requesting and
  300. obtaining permission (common courtesy).  All rights are reserved by the
  301. author.  That's me.
  302.  
  303. There is NO warranty.  Support is NOT guaranteed to unregistered users.
  304.  
  305.  
  306. Contact info:
  307. ============
  308.   Mark Kimes (CIS 74601,1327; Fidonet#1:380/16.0; (318)222-3455 data)
  309.