home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / 9lives0d.zip / README.TXT < prev   
Text File  |  1993-05-20  |  19KB  |  489 lines
  1. ======================================================================
  2.  
  3. Welcome to Version 1.0d of 9 Lives!
  4.  
  5. written by Ross Judson of The Code Industry
  6.  
  7. 9 Lives gives you multiple desktops in OS/2's Workplace Shell!
  8.  
  9. 9 Lives is a desktop expander.  It makes nine "virtual desktops"
  10. available to the user, instead of the standard one.  Why is this
  11. useful?  It reduces window clutter and allows you to organize groups
  12. of windows more effectively.
  13.  
  14. Thanks to everyone who registered the previous version!  Your
  15. registration code will work with this version as well.  Contact
  16. the address at the bottom of this file if you have any trouble.
  17.  
  18. ======================================================================
  19.  
  20.  
  21. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  22. Disclaimer!
  23. -----------
  24.  
  25. This version has proven to be relatively stable, but to achieve
  26. multiple desktops 9 Lives needs to do unusual things to PM.
  27. Therefore, Ross Judson and the Code Industry cannot be held
  28. responsible for any losses or damages incurred by the use of this
  29. program.  Use it at your own risk!
  30.  
  31.  
  32. Improvements
  33. ------------
  34.  
  35. 1.0d gives you the option of activating the window you click on in
  36. the desktop diagram.  When you clicked to change a window in 1.0b,
  37. the desktop changed but the active window didn't.  Selecting the
  38. "activate under click" option tells 9 Lives' to switch to the desktop
  39. you clicked on AND activate the window you clicked on.
  40.  
  41. 1.0d makes the number keys activate particular desktops.  
  42.  
  43. 1.0d lets you drag windows between desktops but have them end up in
  44. the same position.  Hold down the control key while dragging windows
  45. on the desktop diagram to force your window to have the same screen
  46. position it had before.
  47.  
  48. 1.0c adds a zooming capability; by clicking both mouse buttons at the
  49. same time you can tell 9 Lives to fill the entire screen.  It then
  50. becomes extremely easy to place your windows.  Click both buttons
  51. again to put 9 Lives back to its original size.  You can also use the
  52. 'control-Z' key, or choose 'Zoom' from the context menu.  A 'visible
  53. margin' feature has been added to the option dialog.  It's convenient
  54. to have a margin around the virtual desktop diagram that doesn't
  55. activate any desktop if you have the activate on first click option
  56. turned off.
  57.  
  58. 1.0c also changes all accelerator keys to use the control key as a
  59. modifier (that means you type control-z instead of just z).  This is
  60. in reponse to users who said that, due to confusion about the focus,
  61. they were accidentally activating 9 Lives features when they thought
  62. they were typing in a program.  No more!
  63.  
  64. 1.0c removes byte alignment from its window.  That makes it a little
  65. easier to position the window.
  66.  
  67. 1.0c improves upon the method used to detect the workplace shell.
  68. The improvement to you, the user, is that you will no longer have to
  69. enter the title of the shell window into the options dialog.
  70.  
  71. 1.0c gives you sticky windows.  Sticky windows are windows (such as
  72. Pulse or a memory watcher) that you want to keep visible at all times.
  73. To set up sticky windows, use the "sticky windows..." button in the
  74. options dialog.  Enter the titles of the windows you want to be
  75. sticky.  9 Lives will match what you type against window titles it
  76. looks at.  It uses _prefixes_.  That means if you type BIC in the
  77. sticky list, all windows with BIC as their first three letters will
  78. stick.
  79.  
  80. 1.0c now correctly resets the shell window when deleted from the
  81. task list.
  82.  
  83. V1.0b adds the ability to drag 9 Lives' window around on the screen.
  84. Right click and hold anywhere there isn't a mini-window in the
  85. desktop diagram, then drag.  You'll be able to easily position 9
  86. Lives' window.  If you want to bring up the context menu, don't drag;
  87. just click.
  88.  
  89. Fixes
  90. -----
  91.  
  92. V1.0d fixes an error that could occur during the "Retrieve Windows"
  93. operation.  Some windows might not be retrieved correctly.
  94.  
  95. V1.0c correct some shell position errors when growing and shrinking
  96. the shell window.
  97.  
  98. V1.0c corrects an error that occurred with certain complex parent/
  99. owner relationships.  An owned-relationship was not being correctly
  100. detected.  This was primarily visible with the Help System of Borland
  101. C++.
  102.  
  103. V1.0c unzooms before closing so that the zoomed position will not be
  104. stored.
  105.  
  106. V1.0c improves the keep on top logic.  It's still not perfect, but it
  107. works better.
  108.  
  109. V1.0b corrects a deficiency in changing desktops when invisible,
  110. owned windows are present.  The bug identified for V1.0a was not
  111. actually completely fixed in that release, but turns out to be
  112. related to the code used to keep the window on top.  I am searching
  113. for a better method to do this.  In the mean time, you can work
  114. around it by turning off the keep on top option.
  115.  
  116. V1.0a corrects an oddity PM presents to 9 Lives.  Apparently, after
  117. quitting from a full screen session, the WM_BUTTON1CLICK message is
  118. not received.  This resulted in an inability to switch desktops with
  119. the mouse, but the keyboard controls still worked!  A slight change
  120. in 9 Lives attempts to work around this, so the problem should be no
  121. more (NOTE - not so; see preceding paragraph).
  122.  
  123. If you find any problems, please let me know.  My street address and
  124. email addresses are at the bottom of this file.
  125.  
  126. Release Notes
  127. -------------
  128.  
  129. If you lose a window (and I hope you don't), try the following:
  130.  
  131. 1 - 9 Lives' Retrieve Lost Windows option
  132. 2 - The Alt-F7 keystroke
  133. 3 - The Alt then M keystroke
  134.  
  135. One of them should help you get it back.  Remember, the window isn't
  136. lost.  It's just somewhere out of sight.
  137.  
  138. There is slight problem associated with VIO window, such as an OS/2
  139. shell window.  VIO windows need to be notified when they are moved or
  140. sized.  Unfortunately, 9 Lives can't let this processing happen
  141. (arrgg :-).  9 Lives attempts to compensate for this, but is not
  142. always successful.  I am researching ways to fix this problem.
  143.  
  144. When leaving a full screen session, if you have the "keep on top"
  145. option active, do not immediately change to another desktop.  There
  146. is some focus confusion happening, and 9 Lives will not correctly
  147. respond.  Either choose some other program first, or turn off the
  148. keep on top option.  This will be fixed!  In the mean time, it might
  149. happen to you.  Here's what you should look for.  When you exit the
  150. full screen session, you'll notice that both 9 Lives and another
  151. window are active (have title bars/borders in the active color).
  152. Choose the other active window (not 9 Lives).  PM seems to reset the
  153. activation correctly at this point, and everything is normal from
  154. then on.
  155.  
  156. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  157. Instructions
  158. ------------
  159.  
  160. 9 Lives is a desktop expander.  It makes nine "virtual desktops"
  161. available to the user, instead of the standard one.  Why is this
  162. useful?  It reduces window clutter and allows you to organize groups
  163. of windows more effectively.
  164.  
  165. Manifest
  166. --------
  167.  
  168. The 9 Lives package consists of two files:
  169.  
  170. 9LIVES.EXE - main executable
  171. README.TXT - documentation file (ASCII)
  172.  
  173. Please do not tamper with the archive; upload it intact to other
  174. bulletin boards.
  175.  
  176. Installation
  177. ------------
  178.  
  179. Installing 9 Lives is simple.  Unpack the archive and place 9LIVES.EXE
  180. and README.TXT either in their own directory, or with your other
  181. OS/2 utilities.
  182.  
  183. You'll probably want to make an icon on your desktop for 9 Lives.
  184. Open up the Templates folder and drag a new Program object to the
  185. desktop.  Enter the directory and file name to locate 9 Lives.
  186. Switch to the General Page and change the title to 9 Lives.  Now
  187. you're ready to run 9 Lives!
  188.  
  189. Using 9 Lives
  190. -------------
  191.  
  192. Once 9 Lives is running, you'll see a grid of desktops on its window
  193. ( this is called the "Desktop Diagram" throughout the rest of this
  194. documentation).  Miniature rectangles representing the windows on
  195. your desktop will be shown in the diagram.  Some are conspicuously
  196. absent; 9 Lives itself, your shell window (the Desktop), and anything
  197. you have in the "sticky" list (more on the sticky list later).
  198.  
  199. You can pick a new desktop by clicking the left mouse button on it.
  200. The windows in your current desktop disappear, and those in the new
  201. desktop become visible.  Turn on the "activate under click" option
  202. and the window you click on while you are changing desktops will
  203. become activate automatically.  If you click on an area of the
  204. desktop diagram that has no window, the window currently activated
  205. will stay activated.
  206.  
  207. Click the right mouse button to show a context menu.  Click the right
  208. mouse button on a mini-window to drag it somewhere else.  Hold down
  209. the control key while dragging a mini-window to force it to stay in
  210. the same screen position, but change desktops.
  211.  
  212. Click the right mouse button where there isn't a mini-window, then drag
  213. without releasing the button, and you can drag 9 Lives' window around.
  214.  
  215. The following accelerator keys are available (^ means control):
  216.  
  217. F1 - Bring up help (instructions)
  218. ^A  - Show the about dialog
  219. ^O  - Show the options dialog
  220. ^R  - Retrieve lost windows
  221. ^Z    - Zoom in and out
  222. ^H  - Hey, cut that out! key.  If 9 Lives stops updating itself,
  223.      hitting this key may return it to action.
  224. Esc- Turn the title bar on and off
  225.  
  226. The number keys (1-9) activate desktops.  The desktops are numbered
  227. sequentially from lower left to upper right (the numbering resembles
  228. the numeric keypad.  So if you want to change to the top left desktop,
  229. hit 7.  If you want to change to the middle right desktop, hit 6.
  230. Remember to check the num lock key; if it's off, the numeric keypad
  231. won't work.  Use the number keys at the top of your keyboard instead.
  232.  
  233. You can also use the cursor keys to move the current virtual desktop.
  234. The desktop moves in the direction of the arrow key you push.
  235.  
  236. Right clicking on an empty area (without a window underneath) will
  237. pop up the 9 Lives context menu, from which many commands can be
  238. executed.
  239.  
  240. Clicking both buttons at the same time zooms 9 Lives' window in and
  241. out.  Clicking both buttons is commonly called a chord.  Zooming is
  242. nice for position windows across desktops -- the big picture is much
  243. easier to work with.
  244.  
  245. Use the retrieve lost windows to pull all other windows to the
  246. current desktop.  This is very useful if, for example, you
  247. accidentally move windows off the virtual desktop and want to get
  248. them back.
  249.  
  250. Options
  251. -------
  252.  
  253. A "Follow Active" option tells 9 Lives to try to keep the currently
  254. active window visible.  If you change to another window by, say,
  255. using the task list, 9 Lives will attempt to figure out which desktop
  256. that window is on and go there.  You can activate and deactivate this
  257. option from the options dialog.
  258.  
  259. "Keep on top" tries to keep 9 Lives on top of other windows.  9 Live
  260. tries to do this fairly unobtrusively.
  261.  
  262. "Expand desktop" tells 9 lives what to do with your workplace shell.
  263. If this option is selected, 9 Lives will expand the shell window to
  264. cover the entire virtual desktop.  Your icons will only appear in one
  265. desktop, unless you move them to another.  If this option is not
  266. checked, the workplace shell is not touched, and will be available on
  267. each virtual desktop.
  268.  
  269. "Hide on Desktop Change" hides 9 Lives after you change desktops.
  270. Hide on desktop change does not work very well at this time.  It will
  271. be repaired. 
  272.  
  273. "Activating click..." prevents 9 Lives from changing desktops when you
  274. click on it to active it.  This option is very handy if most of 9
  275. Lives is behind another window.  You can click on the 9 Lives window
  276. to activate it, then click on the desktop you want to go to.  Without
  277. this option turned on, the click that activated 9 Lives would also
  278. have chosen a new desktop.  But, some people prefer to have 9 Lives
  279. on top and instantly respond to desktop changes on the first click.  
  280.  
  281. "Visible margin..." tells 9 Lives to draw a small margin around the
  282. virtual desktop diagram.  This makes it easy to activate 9 Lives
  283. without changing desktops.  It also looks neat on some systems.
  284.  
  285. "Activate under..." tells 9 Lives to activate the window that's under
  286. the mouse when you click on the desktop diagram to change desktops.
  287. Was that a run-on sentence or what.  Simple explanation -- see the
  288. desktop diagram?  Left click on a window in that and 9 Lives will
  289. change to that desktop _and_ activate that program.
  290.  
  291. The "sticky windows" button brings up a dialog that lets you make
  292. windows stay put when you change desktops.  Many OS/2 users always
  293. have a memory manager and a pulse-type program visible.  If you enter
  294. the window titles of those programs here, they will stay visible when
  295. you change desktops.  So if you want to keep Pulse visible, enter
  296. "Pulse" (without the double quotes) into one of the sticky window
  297. boxes.  The titles you enter in this dialog are compared as _prefixes_.
  298. That means that 9 Lives compares the window title with what you enter
  299. for the length of the string that you enter.  If you enter PUL, all
  300. windows that start with PUL will be sticky.  The comparison is case
  301. sensitive, so make sure you have the correct spelling and capitalization
  302. of the words.
  303.  
  304. You can drag and drop a font from the font palette on the 9 Lives
  305. window.  9 Lives will use that font to draw the titles of windows in
  306. its desktop diagram.
  307.  
  308. 9 Lives remembers where you put it and how you set it up.
  309.  
  310. Tips and Tricks
  311. ---------------
  312.  
  313. 9 Lives' many options make it easy to configure to your tastes.  If
  314. there's something that you'd like to see, please let me know!  I'll
  315. be happy to consider your request.
  316.  
  317. I like to set up 9 Lives so that it sits in the bottom right corner
  318. of my screen.  I turn on the expand desktop and stay on top options,
  319. then turn off the title bar.  It's quite small and convenient in this
  320. configuration.  I can then run my compilers in one window, my shell
  321. in another, and keep several help files open and easily accessible.
  322.  
  323. When you are arranging windows across desktops, it's very handy to
  324. use the zoom feature.  Click both buttons on the 9 Lives window.  You
  325. can then easily move windows from desktop to desktop in the large
  326. desktop diagram.  Select the desktop you want to work on with the
  327. left mouse button, then click both buttons again.  9 Lives will
  328. "unzoom", and you will be working on the desktop you selected.
  329.  
  330. I have my program object for 9 Lives sitting in the lower right
  331. corner of my screen.  When 9 Lives is running, it covers up the icon.
  332.  
  333. Registration
  334. ------------
  335.  
  336. You may use this program freely in a 14 day trial period.  If you
  337. continue to use this program after the trial period has elapsed, you
  338. must register it by sending your name, address, and $18 (U.S.) to:
  339.  
  340. Ross Judson
  341. 7935 Tyson Oaks Circle
  342. Vienna, Virginia, USA
  343. 22182
  344.  
  345. In Canada, you may send a cheque for $20 Canadian to:
  346.  
  347. John Judson
  348. 6 St. Remy Drive
  349. Nepean, Ontario, Canada
  350. K2J 1A3
  351.  
  352. Make Cheques payable to Ross Judson in the U.S.A., and to John Judson
  353. in Canada.  A registration form follows in this text; you can print it,
  354. fill it out, and send it.
  355.  
  356. You will receive a registration code in response.  Entering this
  357. registration code into 9 Lives will defeat a nag mechanism that
  358. becomes active after you use the program a certain number of times.
  359.  
  360. You can reach the author via email on Compuserve.  The ID is
  361. 73657,1712.  Please email me with your comments!  They are very
  362. useful for evolving the program.
  363.  
  364. I am available on America Online.  You can email my screen name,
  365. JRossJ.
  366.  
  367. If you have access to FidoNet, you can reach me on the OS/2 Shareware
  368. BBS.  The address is 1:109/347, and my name is Ross Judson, there.
  369.  
  370. Enjoy your expanded lifestyle under the Workplace Shell!
  371.  
  372. ======================================================================
  373. Release History
  374.  
  375. v1.0 - Initial Release
  376. v1.0a - Fix Full-Screen session release
  377. v1.0b - Fixed change desktop bug related to invisible, owned windows
  378. v1.0c - Add zoom feature, margin option. Corrected shell management.
  379.         Added sticky windows.
  380. v.10d - Added activate under click.  Added control-drag of windows.
  381.  
  382. ======================================================================
  383. Revision-O-Matic
  384.  
  385. $Id: readme.txt 1.16 1993/05/21 02:01:10 Ross Exp Ross $
  386.  
  387. $Log: readme.txt $
  388. # Revision 1.16  1993/05/21  02:01:10  Ross
  389. # Proofreading.
  390. #
  391. # Revision 1.15  1993/05/21  01:53:33  Ross
  392. # Added notes for snap to screen window dragging.
  393. #
  394. # Revision 1.14  1993/05/16  21:28:47  Ross
  395. # Further notes for release.
  396. #
  397. # Revision 1.13  1993/05/15  04:19:46  Ross
  398. # Further revisions and checks for 1.0d.
  399. #
  400. # Revision 1.12  1993/05/15  04:00:49  Ross
  401. # Added note about hot key and VIO programs.
  402. #
  403. # Revision 1.11  1993/05/13  02:48:52  Ross
  404. # DLL and instructions for installation.
  405. #
  406. # Revision 1.10  1993/05/13  02:36:37  Ross
  407. # More notes for 1.0d.
  408. #
  409. # Revision 1.9  1993/05/13  02:33:38  Ross
  410. # Updated for keyboard hooks in 1.0d.
  411. #
  412. # Revision 1.8  1993/05/11  04:24:10  Ross
  413. # More updates for 1.0c.
  414. #
  415. # Revision 1.7  1993/05/09  15:07:34  Ross
  416. # More revision -- activate under click option.
  417. #
  418. # Revision 1.6  1993/05/07  02:14:58  Ross
  419. # More bug fixing notes added.
  420. #
  421. # Revision 1.5  1993/05/02  14:37:21  Ross
  422. # Sticky window notes.
  423. #
  424. # Revision 1.4  1993/05/01  16:44:35  Ross
  425. # Further 1.0c notes.
  426. #
  427. # Revision 1.3  1993/04/30  02:16:27  Ross
  428. # Added 1.0c notes -- zoom and new margin option.
  429. #
  430. # Revision 1.2  1993/04/26  01:50:03  Ross
  431. # for v1.0b
  432. #
  433. # Revision 1.1  1993/04/26  01:33:37  Ross
  434. # Initial revision
  435. #
  436.  
  437.  
  438. ======================================================================
  439.  
  440. Order Form for 9 Lives!
  441.  
  442.  
  443. Name _________________________________________________________________
  444.  
  445.  
  446. Address ______________________________________________________________
  447.  
  448.  
  449. ______________________________________________________________________
  450.  
  451.  
  452. City _________________________________________________________________
  453.  
  454.  
  455. State/Province _________________________  Country ____________________
  456.  
  457.  
  458. Zip/Postal Code ______________________
  459.  
  460.  
  461. Compuserve ID ___________________
  462.  
  463.  
  464. America OnLine screen name ___________________
  465.  
  466.  
  467.  
  468. Enclosed is a cheque for _______________, for _____ copies of 9 Lives.
  469.  
  470.  
  471. Mail to:
  472.  
  473. Ross Judson
  474. 7935 Tyson Oaks Circle
  475. Vienna, VA, USA
  476. 22182
  477.  
  478. or
  479.  
  480. John Judson
  481. 6 St. Remy Drive
  482. Nepean, Ontario, Canada
  483. K2J 1A3
  484.  
  485. Make cheque payable to Ross Judson in the U.S. and John Judson in Canada.
  486.  
  487. Thank you!
  488.  
  489.