home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / system / pmvd / pmvd.doc < prev    next >
Encoding:
Text File  |  1994-01-05  |  7.5 KB  |  205 lines
  1.  
  2.  PM VIRTUAL DESKTOP (PMVDesk) FOR OS/2 2.X
  3.  ==========================================
  4.  Version: 0.25 (previous version: PMVDesk ver 0.21) 
  5.  Date:    January 3, 1994
  6.  Author:  Carrick von Schoultz, cschoult@aton.abo.fi
  7.  
  8.  
  9.  Introduction
  10.  -------------
  11.  This is the documentation for the PMVDesk. I recommend that you
  12.  read it!
  13.  (At least have a look at the "Environment variable" section.)
  14.  
  15.  PMVDesk is a Virtual Desktop utility for the OS/2 2.x Workplace Shell. 
  16.  When you start the program you will see a 9 button grid. Each button 
  17.  represents a screen (of your current videoadapter resolution). The 
  18.  current screen is marked with an "X". 
  19.  
  20.  When you press one of the buttons (move the cursor over it and click 
  21.  mouse button 1) you move to that virtual location. (In this version 
  22.  you can not see your open windows in the PMVDesk application, ...but 
  23.  just wait for the future versions). Your Workplace Shell Desktop 
  24.  (icons) will always be visible. This way you can easily get hold of
  25.  those objects (where ever you are). 
  26.  
  27.  Features
  28.  ---------
  29.  
  30. "Options" menu:
  31.  
  32.  - Uncheck "Frame controls" to hide title and menu bars.
  33.    You can also use Alt-F.
  34.  
  35.  - Check "Float on top" to keep PMVDesk the topmost window. Uncheck to
  36.    let it behave as a normal window. You can also use Alt-T.
  37.  
  38.  - Check "Retrieve windows on exit" to retrieve windows back to
  39.    the active desktop when you exit PMVDesk. 
  40.    Note. Retrieved windows are hidden. To activate: select application
  41.    from Workplace Shell "Window List". Only windows with child windows
  42.    (ex. dialog windows) are retrieved visible.
  43.  
  44.  - "Buttons" + "2 x 2", "3 x 3" or "4 x 4" changes the size of your
  45.    virtual desktop.
  46.  
  47.  - "Util" + "Retrieve windows" to retrieve windows back to the active
  48.    desktop. 
  49.    Note. Retrieved windows are hidden. To activate: select application
  50.    from Workplace Shell "Window List". Only windows with child windows
  51.    (ex. dialog windows) are retrieved visible.
  52.  
  53.  "Help" menu:
  54.  Standard "Help" menu. You can also use F1 to activate help.
  55.  
  56.  System menu:
  57.  Standard system menu.
  58.  
  59.  Popup menu:
  60.  To activate press mouse button 2, or press SHIFT + F10 (when PMVDesk is
  61.  active). Same features as in "Options" menu + "Help" menu and some
  62.  features from the system menu.
  63.  
  64.  To move the PMVDesk window (when frames are hidden), select "Move"
  65.  from the popup menu "Window" submenu, or press ALT-F7.
  66.  
  67.  Choose any application from the "Window List", and it will be shown in
  68.  the visible area.
  69.  
  70.  Choose "Retrieve windows" from PMVDesk "Options" + "Util" menu to
  71.  bring all windows to the lover left corner of the visible area.
  72.  Windows that were moved are now hidden. To get them visible, just
  73.  choose them from the "Window List".
  74.  
  75.  By hiding the title and menu bars and resizing the window, you can
  76.  position PMVDesk for example in the lower corner of the screen, and so
  77.  out of the way.
  78.  
  79.  Environment variable
  80.  ---------------------
  81.  PMVDesk uses a environment variable: PMVDESK_INI. This variable
  82.  specifies the filename (including full path) that PMVDesk should use
  83.  for storing its options. If this environment variable is not set,
  84.  PMVDesk will create the file PMVDESK.INI in the current directory
  85.  and store its information there. I recommend that you put the line:
  86.  
  87.  SET PMVDESK_INI=C:\OS2\PMVDESK.INI
  88.  
  89.  in your CONFIG.SYS (Of course, you can use any other path or filename
  90.  that you want). By doing this you avoid multiple copies of PMVDESK.INI
  91.  scattered around your hard drive.
  92.  You will have to reboot before this line will take effect.
  93.  
  94.  PMVDesk will "remember" it's last position and virtual screen. If you 
  95.  put a PMVDesk Program Object in your startup folder, it will start where 
  96.  you last left it. You may also "Shutdown" your system without closing 
  97.  PMVDesk (because "Shutdown" closes it for you). Remember to put the 
  98.  line SET RESTARTOBJECTS=STARTUPFOLDERSONLY, in your CONFIG.SYS
  99.  file before SET AUTOSTART=PROGRAMS, TASKLIST, FOLDERS, CONNECTIONS.
  100.  
  101.  Troubleshooting
  102.  ----------------
  103.  Recovering "lost" windows: 
  104.  - Choose "Retrieve windows" from PMVDesk "Settings" menu to
  105.    bring all windows to the lover left corner of the visible area.
  106.    Note. Retrieved windows are hidden. To activate: select application
  107.    from Workplace Shell "Window List". Only windows with child windows
  108.   (ex. dialog windows) are retrieved visible.
  109.  - you may choose the "lost" program from Workplace Shell "Window List"
  110.    and cascade the program back to the visible area (press mouse button
  111.    2, choose "Cascade").
  112.  
  113.  Limitations
  114.  ------------
  115.  This version supports up to 100 open windows.
  116.  It is possible to start only one instance of PMVDesk. A warning
  117.  dialog informs you if you try to start a second instance.
  118.  
  119.  Starting the program
  120.  ---------------------
  121.  To start PMVDesk, double click on the program object.
  122.  
  123.  Program requirements
  124.  ---------------------
  125.  To use PMVDesk, you must be running OS/2 2.0 (or later), and of
  126.  course Workplace Shell as your shell. 
  127.  
  128.                             *      *      *
  129.  
  130.  Registering
  131.  ------------
  132.  PM Virtual Desktop is in its current version a freeware program. 
  133.  As this is not the final version, I do not require you to register 
  134.  it even if you should choose to keep and use it. However, it would be 
  135.  nice to get a postcard from your part of the world! 
  136.  
  137.  Since this version of PMVDesk is freeware, you are permitted
  138.  (and encouraged) to pass on the file PMVD???.ZIP. You may NOT 
  139.  modify this file (or its individual components) before passing it on.
  140.  
  141.  
  142.  Development System
  143.  -------------------
  144.  IBM PS/2 model 90       486/20MHz (Overdrive)
  145.                          16 Mb RAM
  146.                          270 Mb hardfile
  147.                          APPLE CD-ROM 150 (Sony-541)
  148.                          XGA + 14" multisync
  149.  OS/2 ver. 2.1 GA (UK edition),
  150.  
  151.  Development Tools
  152.  ------------------
  153.  IBM C Set ++ for OS/2, ver 2.0
  154.  IBM OS/2 Developer's Toolkit 2.0 + toolkit update
  155.  EPM and E editors
  156.  - and of course:
  157.  PM Virtual Desktop (earlier versions)
  158.  
  159.  Tested Environments
  160.  --------------------
  161.  OS/2 ver. 2.1 GA,
  162.  in XGA (1024*768) and VGA (640*480) resolutions.
  163.  
  164.  Why I wrote PMVDesk
  165.  --------------------
  166.  Since nobody had yet released a Virtual Desktop utility, and I find my 
  167.  screen a little tiny. I also had to write a program as an assignment 
  168.  for my C-language course at school, and had the opportunity to choose 
  169.  what to do. I also wanted to learn about writing OS/2 Workplace Shell 
  170.  compliant programs, and this was the hard way. 
  171.  Any further enhancements (after version 0.11) are made just to keep you
  172.  happy, ...and to keep me busy.
  173.  
  174.  History
  175.  --------
  176.  PMVDesk was first released as "CvS - Virtual Screen". I changed the name,
  177.  to avoid confusion, when I was told there is a CVS (Concurrent Versioning
  178.  System) application.
  179.  See "new.doc" for new features introduced and bugs corrected, and some
  180.  problems not yet solved.
  181.  
  182.  Who am I
  183.  ---------
  184.  Name:       Carrick von Schoultz
  185.  Age:        26
  186.  Occupation: Student (Computer Science at Abo Akademi University, Finland) 
  187.  
  188.  How to contact me
  189.  ------------------
  190.  I would love to hear from you. If you have any comments, suggestions, 
  191.  or wishes for new PMVDesk features, please write to me. 
  192.  
  193.  I can be reached on the Internet at cschoult@aton.abo.fi. 
  194.  And remember to send me a postcard: 
  195.  
  196.  Carrick von Schoultz
  197.  Mittarinkatu 4 bB 32
  198.  SF-20100 Turku
  199.  FINLAND
  200.  
  201.  
  202.  SPECIAL THANKS TO PETER NIELSEN AND ALL OF YOU WHO HAVE WRITTEN TO ME.
  203.  
  204.  
  205.