home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / os2 / pmvd021.zip / PMVD.DOC < prev    next >
Text File  |  1993-06-21  |  8KB  |  213 lines
  1.  
  2.  PM VIRTUAL DESKTOP (PMVDesk) FOR OS/2 2.X
  3.  ==========================================
  4.  Version: 0.21 (previous version: CvS - Virtual Screen ver 0.11) 
  5.  Date:    June 20, 1993
  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.  - "Util" + "Retrieve windows" to retrieve windows back to the active
  45.    desktop. 
  46.    Note. Retrieved windows are hidden. To activate: select application
  47.    from Workplace Shell "Window List". Only windows with child windows
  48.   (ex. dialog windows) are retrieved visible.
  49.  
  50.  "Help" menu:
  51.  Standard "Help" menu. You can also use F1 to activate help.
  52.  
  53.  System menu:
  54.  Standard system menu.
  55.  
  56.  Popup menu:
  57.  Popup menu available when frames are hidden. To activate press mouse
  58.  button 2 between the border and the 9-button grid, or press SHIFT + F10
  59.  (when PMVDesk is active).
  60.  Same features as in "Options" menu + "Help" menu and some features from
  61.  the system menu.
  62.  Sorry about this. I know it is difficult to get hold of this popup menu,
  63.  but I did not find a way to grab mouse clicks on pushbuttons.
  64.  
  65.  To move the PMVDesk window (when frames are hidden), press mouse
  66.  button 1 (between the border and the 9-button grid) and drag the
  67.  window. You can also select "Move" from the popup menu "Window"
  68.  submenu, or press ALT-F7.
  69.  Sorry about this. I know it is difficult to drag the window, but I
  70.  did not find a way to grab mouse clicks on pushbuttons.
  71.  
  72.  Choose any application from the "Window List", and it will be shown in
  73.  the visible area.
  74.  
  75.  Choose "Retrieve windows" from PMVDesk "Options" + "Util" menu to
  76.  bring all windows to the lover left corner of the visible area.
  77.  Windows that were moved are now hidden. To get them visible, just
  78.  choose them from the "Window List".
  79.  
  80.  By hiding the title and menu bars and resizing the window, you can
  81.  position PMVDesk for example in the lower corner of the screen, and so
  82.  out of the way.
  83.  
  84.  Environment variable
  85.  ---------------------
  86.  PMVDesk uses a environment variable: PMVDESK_INI. This variable
  87.  specifies the filename (including full path) that PMVDesk should use
  88.  for storing its options. If this environment variable is not set,
  89.  PMVDesk will create the file PMVDESK.INI in the current directory
  90.  and store its information there. I recommend that you put the line:
  91.  
  92.  SET PMVDESK_INI=C:\OS2\PMVDESK.INI
  93.  
  94.  in your CONFIG.SYS (Of course, you can use any other path or filename
  95.  that you want). By doing this you avoid multiple copies of PMVDESK.INI
  96.  scattered around your hard drive.
  97.  You will have to reboot before this line will take effect.
  98.  
  99.  PMVDesk will "remember" it's last position and virtual screen. If you 
  100.  put a PMVDesk Program Object in your startup folder, it will start where 
  101.  you last left it. You may also "Shutdown" your system without closing 
  102.  PMVDesk (because "Shutdown" closes it for you). Remember to put the 
  103.  line SET RESTARTOBJECTS=STARTUPFOLDERSONLY, in your CONFIG.SYS
  104.  file before SET AUTOSTART=PROGRAMS, TASKLIST, FOLDERS, CONNECTIONS.
  105.  
  106.  Troubleshooting
  107.  ----------------
  108.  Recovering "lost" windows: 
  109.  - Choose "Retrieve windows" from PMVDesk "Settings" menu to
  110.    bring all windows to the lover left corner of the visible area.
  111.    Note. Retrieved windows are hidden. To activate: select application
  112.    from Workplace Shell "Window List". Only windows with child windows
  113.   (ex. dialog windows) are retrieved visible.
  114.  - you may choose the "lost" program from Workplace Shell "Window List"
  115.    and cascade the program back to the visible area (press mouse button
  116.    2, choose "Cascade").
  117.  
  118.  Limitations
  119.  ------------
  120.  This version supports up to 100 open windows.
  121.  It is possible to start only one instance of PMVDesk. A warning
  122.  dialog informs you if you try to start a second instance.
  123.  
  124.  Starting the program
  125.  ---------------------
  126.  To start PMVDesk, double click on the program object.
  127.  
  128.  Program requirements
  129.  ---------------------
  130.  To use PMVDesk, you must be running OS/2 2.0 (or later), and of
  131.  course Workplace Shell as your shell. 
  132.  
  133.                             *      *      *
  134.  
  135.  Registering
  136.  ------------
  137.  PM Virtual Desktop is in its current version a freeware program. 
  138.  As this is not the final version, I do not require you to register 
  139.  it even if you should choose to keep and use it. However, it would be 
  140.  nice to get a postcard from your part of the world! 
  141.  
  142.  Since this version of PMVDesk is freeware, you are permitted
  143.  (and encouraged) to pass on the file PMVD???.ZIP. You may NOT 
  144.  modify this file (or its individual components) before passing it on.
  145.  
  146.  
  147.  Development System
  148.  -------------------
  149.  IBM PS/2 model 90       486/20MHz (Overdrive)
  150.                          16 Mb RAM
  151.                          370 Mb hardfile
  152.                          XGA + 14" multisync
  153.  OS/2 ver. 2.0 GA + SP,
  154.  IBM OS/2 2.1 (Dec. beta)
  155.  
  156.  Development Tools
  157.  ------------------
  158.  GCC/2 ver 2.3.3 (2.2.2)
  159.  IBM OS/2 Developer's Toolkit 2.1 (Dec. beta)
  160.  EPM and E editors
  161.  - and of course:
  162.  PM Virtual Desktop (earlier versions)
  163.  
  164.  Tested Environments
  165.  --------------------
  166.  OS/2 ver. 2.0 GA + SP, OS/2 ver. 2.1 (Dec. beta),
  167.  in XGA (1024*768) and VGA (640*480) resolutions.
  168.  A beta version was also tested on OS/2 ver. 2.1 (March beta), and
  169.  OS/2 ver. 2.1 GA. Special thanks to you who performed this beta test.
  170.  
  171.  Why I wrote PMVDesk
  172.  --------------------
  173.  Since nobody had yet released a Virtual Desktop utility, and I find my 
  174.  screen a little tiny. I also had to write a program as an assignment 
  175.  for my C-language course at school, and had the opportunity to choose 
  176.  what to do. I also wanted to learn about writing OS/2 Workplace Shell 
  177.  compliant programs, and this was the hard way. 
  178.  Any further enhancements (after version 0.11) are made just to keep you
  179.  happy, ...and to keep me busy.
  180.  
  181.  History
  182.  --------
  183.  PMVDesk was first released as "CvS - Virtual Screen". I changed the name,
  184.  to avoid confusion, when I was told there is a CVS (Concurrent Versioning
  185.  System) application.
  186.  See "new.doc" for new features introduced and bugs corrected, and some
  187.  problems not yet solved.
  188.  
  189.  Who am I
  190.  ---------
  191.  Name:       Carrick von Schoultz
  192.  Age:        25
  193.  Occupation: Student(Computer Science at Abo Akademi University, Finland) 
  194.  
  195.  How to contact me
  196.  ------------------
  197.  I would love to hear from you. If you have any comments, suggestions, 
  198.  or wishes for new PMVDesk features, please write to me. 
  199.  
  200.  I can be reached on the Internet at cschoult@aton.abo.fi. 
  201.  And remember to send me a postcard: 
  202.  
  203.  Carrick von Schoultz
  204.  Mittarinkatu 4 bB 32
  205.  SF-20100 Turku
  206.  FINLAND
  207.  
  208.  
  209.  SPECIAL THANKS TO CHRISTIAN BURMAN, PETER NIELSEN AND ALL OF YOU WHO HAVE
  210.  WRITTEN TO ME.
  211.  
  212.  
  213.