home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ftaskbar.zip / tread.me < prev    next >
Text File  |  1996-02-23  |  17KB  |  330 lines

  1.  
  2.  ┌──────────────────────────────────────────────────────────────────────────┐
  3.  │   FM/2 Taskbar copyright (c) 1995/96 by M. Kimes  (Barebones Software)   │
  4.  │                            All Rights Reserved                           │
  5.  │                                  v1.05                                   │
  6.  ├──────────────────────────────────────────────────────────────────────────┤
  7.  │                TREAD.ME file -- read before installing                   │
  8.  │        See end of document for contact info and license details          │
  9.  └──────────────────────────────────────────────────────────────────────────┘
  10.  
  11.  
  12. What is it?
  13. ==========
  14.  
  15. The FM/2 Taskbar is a small utility program that works in conjunction
  16. with the WPS Window List, program objects and Launchpad to control
  17. what's running on your system and where it runs.  It's much harder to
  18. explain than to try, and since installation is quick and painless and a
  19. deinstallation program is included, I encourage you to try it and see
  20. what you think.  See sections below for the information you need to get
  21. started.  Warning:  A pointing device _is_ required; the Taskbar would
  22. make little sense without one.
  23.  
  24. If you like the Taskbar, you'll love FM/2.  File Manager/2 (FM/2) is a
  25. shareware OS/2 2.1+ PM 32-bit file/directory/archive maintenance utility
  26. (a sort of super-Drives object, something midway between the Drives
  27. objects and a more traditional file manager) with plenty of bells,
  28. whistles and utilities, drag and drop, context menus, toolbars and
  29. accelerator keys.  FM/2 won a 1995 OS/2 Magazine Editor's Choice award
  30. -- the only file management software to do so.  If you know how to use
  31. OS/2, you already know how to use most of FM/2.  You can easily glean
  32. the rest from the extensive online help.  FM/2 is available from
  33. ftp.secret.com (/g/os2utl), from Compuserve's OS2SHARE (OS2BVEN) forum
  34. (GO OS2SHARE) in library 1, and from finer OS/2 BBSs everywhere.
  35.  
  36.  
  37. Installing and starting the Taskbar:
  38. ===================================
  39.  
  40. First, unpack the archive into a (preferably empty) directory.  Now run
  41. the TINSTAL.CMD file to create a WPS object for the Taskbar.  You're
  42. given a choice to create the object on the Desktop or in the Startup
  43. folder.  You're done.
  44.  
  45. Once the object is created, double-click it to run it.  If the object is
  46. in the Startup folder, OS/2 will start it every time you boot up OS/2.
  47.  
  48.  
  49. Using the Taskbar:
  50. =================
  51.  
  52. Here's a simple diagram showing the layout of the Taskbar:
  53.  
  54.  ┌───────────────────────────────────────────────────────────────────────────┐
  55.  │                                                                           │
  56.  │                                                                           │
  57.  │                                                                           │
  58.  │                                                                           │
  59.  │                                                                           │
  60.  ┴─────────────────────────────────\/\───────────────────────────────────────┴
  61.                                  Desktop
  62.  ┬─────────────────────────────────/\/───────────────────────────────────────┬
  63.  │                                                                           │
  64.  │                                                                           │
  65.  │    ┌──Taskbar                                                             │
  66.  │    │                                                                      │
  67.  │    │                                                                      │
  68.  ├────┴─┬─┬─┬─┬──────────────────────────────────────────────────────────────┤
  69.  │ Time/├─┼─┼─┤┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐        │
  70.  │ Date ├─┼┼┼─┤└──┘ └──┘ └──┘ └──┘ └┬─┘ └──┘ └──┘ └──┘ └──┘ └──┘ └─┬┘        │
  71.  └──────┴─┴┼┴─┴─────────────────────┼──────────────────────────────┼─────────┘
  72.            └──Virtual desktops      └──Icons of running programs───┘
  73.  
  74. After starting the Taskbar from the WPS object the TINSTAL.CMD program
  75. creates for you, move the mouse pointer to the bottom of the screen.
  76. The Taskbar pops up and remains up as long as you keep the mouse pointer
  77. within its window.  When you move the mouse outside the window, the
  78. window vanishes until you call it up again.  This "popup" action ensures
  79. that the Taskbar isn't occupying valuable Desktop space when you don't
  80. need it, but is always available when you do.
  81.  
  82. As you pass the mouse pointer over the icons of running programs, a
  83. caption window appears showing the name of the program the icons
  84. represent.  Click on one of these icons with mouse button one (usually
  85. the left button), and the program is brought to the foreground, and is
  86. restored if it was hidden or minimized.  You can request a context menu
  87. on these icons (click mouse button two, usually the right button) for
  88. more options (Show, Hide, Move to this desktop, Close and Kill).  The
  89. "current" window is shown extruded (an outtie instead of an innie, in
  90. navel terms -- jelly baby, anyone?).
  91.  
  92. The Time/Date field can be double-clicked to bring up a Settings
  93. notebook to allow you to set the time and date.  A context menu
  94. requested on this field is the same as a context menu requested over an
  95. empty part of the Taskbar, with various options to control how the
  96. Taskbar operates, and to close the Taskbar (we'll get to that in a
  97. moment).  If you have a three-button mouse and a driver that recognizes
  98. the third button, clicking it in this field will display the system
  99. clock (assuming you haven't told the Taskbar to change button three
  100. presses to button one double-clicks in the Taskbar settings -- see
  101. below).
  102.  
  103. The Virtual desktop field allows you to have nine separate workspaces on
  104. your desktop.  Click mouse button one in one of the nine squares of the
  105. grid, and the desktop "switches" to that workspace.  (If you close the
  106. Taskbar, all programs are brought onto the actual desktop so none are
  107. left stranded where you can't get to them without a lot of work.)
  108. Requesting a context menu on this field allows you to start command
  109. lines or open FM/2 or several WPS objects.  The context menu also allows
  110. you to hide or restore all open windows.
  111.  
  112. If you have the Settings toggle "Show process and thread counts" turned
  113. on another window appears between the Time/Date window and the Virtual
  114. desktops window that shows the number of processes and threads running
  115. on your system at the time the Taskbar appeared.  Double-clicking this
  116. window causes the FM/2 Process Killer program to be run.  Clicking it
  117. with the third button causes the FM/2 System Information program to be
  118. run (if you don't have button three emulating a button one
  119. double-click).  You _do_ have FM/2 installed, don't you?
  120.  
  121. You can quickly switch programs using the keyboard by pressing and
  122. holding the CTRL and ALT keys, then pressing either the "<" (comma) or
  123. ">" (period) keys.  The Taskbar displays a small window showing the icon
  124. and name of the program that would be brought to the foreground if you
  125. release the CTRL and ALT keys.  Use < or > to cycle through open
  126. applications until you find the one you want, then release the CTRL and
  127. ALT keys, or press ESCape to cancel the operation.  You can also use the
  128. CTRL, ALT and Tab keys together to switch tasks unless you disable them.
  129.  
  130. Requesting a context menu on the Time/Date field or any empty part of
  131. the Taskbar brings up a menu that allows you to change Taskbar settings
  132. or close (exit) the Taskbar.  An About box and (very) brief help are
  133. available here as well.  Some things that might be non-obvious are
  134. detailed below:
  135.  
  136.   Settings:  Opens a dialog where you can adjust the Taskbar settings.
  137.   In the dialog, you can set what part of the bottom of the screen will
  138.   activate the taskbar, how low the mouse pointer must go in that area,
  139.   and whether the taskbar window is "animated" or not.
  140.  
  141.     Button 2 send to bottom:  If checked, clicking mouse button two on a
  142.     window's titlebar will send it to the bottom of the window stack
  143.     (all other open windows will appear on top of it).  Hold down the
  144.     Shift key to temporarily override this action.
  145.  
  146.     Button 3 close:  If checked, clicking mouse button three on a
  147.     window's titlebar will close the application.  Hold down the Shift
  148.     key to temporarily override this action.
  149.  
  150.     Button 3 = B1 dbl clk:  If checked, the Taskbar translates a click
  151.     of mouse button three (the center button on three-button mice) to a
  152.     double-click of mouse button 1.  The WPS doesn't use button three
  153.     directly, so this may be a way to get some use out of it.  You can
  154.     hold down the Shift key to temporarily override this action.
  155.  
  156.     Sliding focus:  If checked, windows below the mouse pointer will be
  157.     activated and brought to the top of the window stack.  Holding down
  158.     the Shift key temporarily overrides this action.
  159.  
  160.     No zorder change:  Works in conjunction with Sliding focus.  If
  161.     checked, windows will be activated but NOT brought to the top of the
  162.     window stack.  Hold CTRL to temporarily override this action.
  163.  
  164.     Reposition mouse on show:  If checked, when you use the Taskbar
  165.     icons to Show a window, the mouse pointer will be placed in the
  166.     center of the window.
  167.  
  168.     Wrap mouse pointer at screen edges:  If checked, the mouse pointer
  169.     will wrap at screen edges rather than stop as if a wall was reached.
  170.  
  171.     Move folders:  If not checked, the Taskbar always keeps WPS folders
  172.     on the current desktop.
  173.  
  174.     Show detail in mini desktop:  Some programs cause a noticeable
  175.     slowdown when the WinEnumWindows API is called.  If the Taskbar
  176.     comes up, but the miniature virtual desktop window takes a second or
  177.     two to display, try turning this off.
  178.  
  179.     Disable desktops:  Disables the virtual desktop feature of the
  180.     Taskbar.
  181.  
  182.     Disable hotkey switching:  Disables CTRL+ALT+< and CTRL+ALT+> quick
  183.     visual task switching.
  184.  
  185.     Left-hand hotkey switching:  Uses CTRL+ALT+Z and CTRL+ALT+X instead
  186.     of the above keys.
  187.  
  188.     Also use CTRL-ALT-Tab switching:  The CTRL+ALT+TAB combination can
  189.     also be used to switch tasks via keyboard.
  190.  
  191.   Reloading and editing exclude lists:  See "Advanced topics" below;
  192.   normally, you don't need to worry about this at all.
  193.  
  194. My best advice to you regarding the settings above is to simply try them
  195. and see what you like best.  You can't destroy your computer or OS/2
  196. with them, so you've nothing to lose but the time it takes to turn
  197. something back off or on; relax and experiment.
  198.  
  199.  
  200. Advanced topics:
  201. ---------------
  202.  
  203. To exclude windows from the Taskbar display:  Enter their switch list
  204. titles (as shown in the Window List), one per line, in a file called
  205. "TEXCLUDE.LST" in the Taskbar's directory.  You can make this partial;
  206. if the first part of the window's switch list title matches the line
  207. in the file, it won't show on the Taskbar.  Use a standard text editor
  208. to create the file (E.EXE, the system editor, will work fine).
  209.  
  210. To exclude windows from being moved when you select a virtual desktop,
  211. enter their titlebar text, one per line, in a file called "VEXCLUDE.LST"
  212. in the Taskbar's directory.  You can make this partial as above.
  213.  
  214. You can reload an exclude list after you've edited it via menu
  215. selection.  Request a context menu on the Time/Date field or on a blank
  216. area of the Taskbar.  You can also open the files from the context menu;
  217. whatever editor you have assigned to the files via WPS associations is
  218. used.  After editing, don't forget to reload it.
  219.  
  220.  
  221. Uninstalling the Taskbar:
  222. ========================
  223.  
  224. If you try the Taskbar and decide you don't like it, run TUINSTAL.CMD
  225. in the Taskbar directory to remove it.  Thanks for giving it a shot;
  226. feel free to let me know what you didn't like.
  227.  
  228.  
  229. Troubleshooting:
  230. ===============
  231.  
  232. As with any non-trivial program, it's possible that the FM/2 Taskbar
  233. contains bugs.  If you encounter a bug, please do report it _in
  234. painstaking detail_ to one of the addresses at the bottom of this
  235. document.  Be sure to tell me how to duplicate the bug.
  236.  
  237. The only thing that I know of that could cause you problems with the
  238. Taskbar is the LIBPATH line in CONFIG.SYS.  This line should contain
  239. ".\" to allow TASKHOOK.DLL to be found in TASKBAR.EXE's default
  240. directory.  An example:
  241.   LIBPATH=.\;C:\OS2\APPS\DLL;C:\MMOS2\DLL;C:\OS2\DLL;C:\OS2\MDOS;C:\;
  242. This is the default for OS/2 installation, so you shouldn't encounter
  243. a problem.
  244.  
  245. The Taskbar is meant to run in conjunction with the WPS.  Some
  246. functionality will be missing if run without it, but it shouldn't blow
  247. up.  If you aren't running the WPS, shame on you.
  248.  
  249.  
  250. Simple license statement:
  251. ========================
  252.  
  253. You are granted a license to try this shareware program (FM/2 Taskbar)
  254. for up to sixty (60) days, after which you must register FM/2 or
  255. discontinue use of the Taskbar (that's right, to register the Taskbar
  256. you register File Manager/2 and get both -- what a deal).  You can
  257. alternatively register _just_ the FM/2 Taskbar by sending $15.00 US to
  258. the address below (I'll try to get it added to BMT Micro, too), but it
  259. _won't_ get you FM/2 as well, or a credit if you decide to register FM/2
  260. later, so think carefully.  You can register via CIS' SWREG service (the
  261. ID number is 8761).
  262.  
  263. Permission is granted to redistribute the unaltered shareware archive
  264. for a reasonable (read nominal, small) copying charge.  FM/2 Taskbar may
  265. specifically not be packaged with a commercial book without requesting
  266. and obtaining permission (common courtesy -- remember, "copyright" means
  267. literally "the right to control who copies the material").  Such
  268. permission is usually granted shortly after receipt of the request.  If
  269. you write a review on the FM/2 Taskbar, I'd certainly appreciate a
  270. courtesy copy of the review -- my wife collects them.  All rights are
  271. reserved by the author.  That's me.
  272.  
  273. There is NO warranty.  Support is NOT guaranteed to unregistered users.
  274.  
  275.  
  276. Contact info:
  277. ============
  278.   Mark Kimes (CIS 74601,1327; (318)222-3455 voice and fax;
  279.               mkimes@linux.secret.com)
  280.   542 Merrick
  281.   Shreveport, LA  71104  USA
  282.  
  283.  
  284. History:
  285. =======
  286. 1.02
  287.   o Taskbar switches to the virtual desktop containing the program that
  288.     was selected by icon, if required.
  289.   o You can turn off the virtual desktop if you want -- the "icon"
  290.     remains, but it won't respond to mouse clicks, except for context
  291.     menu requests.
  292.   o Context menu items were added to allow you to edit exclude files
  293.     with a click -- it just loads the appropriate file into the system
  294.     editor using the default OS/2 association.  You can change editors
  295.     by setting a different association on the files or adding them to
  296.     the associations of the editor.
  297.   o The taskbar now hides itself _before_ bringing programs to the front.
  298.   o Added a toggle to make the taskbar window animated or not, for those
  299.     who like that sort of thing.
  300.   o Modified registration policy by popular demand (sheesh, who woulda
  301.     thought folks would want to buy it alone?  The program was written
  302.     during some experimenting I was doing, and I really only initially
  303.     released it as an advertisement for FM/2).
  304. 1.03
  305.   o Added hotkey quick visual task switching -- press CTRL + ALT +
  306.     either "<" (the comma key) or ">" (the period key) to bring up a
  307.     small window that allows you to select a task and _then_ switch to
  308.     it.  ESCape will abort the selection, which is made when you release
  309.     the CTRL and ALT keys.
  310. 1.04
  311.   o Added "left-hand hotkey switching" toggle.
  312.   o Added "wrap mouse pointer at screen edges" toggle.
  313. 1.05:
  314.   o Tidied up Settings dialog.
  315.   o Miscellaneous small tweaks, logo redisplay, etc.
  316.   o Added toggle to use CTRL-ALT-TAB for quick visual taskswitching
  317.     as well as previous keys (closer to OS/2's keystrokes, so maybe
  318.     easier to remember).
  319.   o Added "Show detail in mini-desktop" toggle -- if your system is
  320.     heavily loaded, you might want to turn this off.
  321. 1.06:
  322.   o Added ability to remove an item from the Window List and Taskbar
  323.     via item's context menu.
  324.   o Added ability to control whether an item is jumpable or not
  325.     (basically whether you can switch to it with ALT-ESC) via item's
  326.     context menu.
  327. 1.07:
  328.   o Added optional process/thread count window.
  329.   o Changed B3 = B1x2 logic somewhat, special case certain window types.
  330.