home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1995 December / SOFM_Dec1995.bin / pc / os2 / winshell / readme.1st < prev    next >
Text File  |  1995-10-31  |  21KB  |  507 lines
  1. DISCLAIMER:
  2.  
  3.    THIS IS EMPLOYEE WRITTEN SOFTWARE (ESW) AND AS SUCH IS NOT AN OFFICIAL
  4.  
  5.    IBM PRODUCT.
  6.  
  7.    THEREFORE NO TECHNICAL SUPPORT IS GIVEN TO THIS SOFTWARE BY IBM.
  8.  
  9.    THIS PROGRAM IS DISTRIBUTED "AS IS" WITH NO FORMAL SUPPORT WHATSOEVER.
  10.  
  11.    WHILE IT IS USEABLE, ITS SOLE PURPOSE IS TO DEMONSTRATE SOME OF THE
  12.  
  13.    FEATURES AVAILABLE IN THE OS/2 WARP WORKPLACE SHELL.
  14.  
  15.    PLEASE READ LICENSE.TXT FILE FOR IBM EWS SOFTWARE LICENSE DETAILS.
  16.  
  17.  
  18. ========================================================================
  19. ==                                                                    ==
  20. ==   W O R K P L A C E   S H E L L   F O R   W I N D O W S   3 . 1    ==
  21. ==                                                                    ==
  22. ==                    V e r s i o n   1 . 51                          ==
  23. ==                                                                    ==
  24. ==                                                                    ==
  25. == Release Date  : 10/10/95                                           ==
  26. ==                                                                    ==
  27. ==                                                                    ==
  28. ==    Copyright IBM Corporation, 1994-1995.  All rights reserved.     ==
  29. ==                                                                    ==
  30. ========================================================================
  31.  
  32.  
  33. TABLE OF CONTENTS (in order of appearance):
  34. ===========================================
  35.  
  36.     1) Minimum Program Requirements
  37.     2) Subscribing To Package
  38.     3) When You Encounter A Problem
  39.     4) Release File List
  40.     5) Installation (and Uninstallation) Instructions.
  41.     6) Editing Your SYSTEM.INI File
  42.     7) Editing Your WIN.INI File
  43.     8) Known Problems
  44.  
  45.  
  46. ------------------------------------------------------------------------
  47. 1)     M I N I M U M   P R O G R A M   R E Q U I R E M E N T S
  48. ------------------------------------------------------------------------
  49.  
  50.    Hardware:
  51.       Processor : Intel 80386SX (or compatible).
  52.       Memory    : About 350K (when loaded and running).
  53.       Disk      : Maximum of 750K after installation with all support files.
  54.                   Minimium of 1MB free in boot drive for installation files.
  55.       Video     : Minimum of VGA (640x480 16 color) resolution.
  56.  
  57.    Software:
  58.       DOS 5.x with Windows 3.1 or Windows for Workgroups 3.1 or higher.
  59.       -or-
  60.       OS/2 2.1x or higher (WPSFWIN is installed on Win-OS/2 full-screen session).
  61.  
  62.  
  63. ------------------------------------------------------------------------
  64. 2)        S U B S C R I B I N G   T O   P A C K A G E
  65. ------------------------------------------------------------------------
  66.  
  67. The latest release is available as WPSFWxxx.ZIP (where xxx is the version
  68. number, i.e. 150 = 1.50) in the following places:
  69.  
  70. CompuServe:
  71. -----------
  72.    The following "libraries" contain the latest release:
  73.  
  74.    OS2DF1  Forum Library 3
  75.    WINUTIL Forum Library 12
  76.  
  77.  
  78. Internet:
  79. ---------
  80.    The following "ftp" sites contain the latest release:
  81.  
  82.    software.hursley.ibm.com, 193.129.184.20 in directory /pub/os2/ibmews
  83.  
  84.  
  85. Bulletin Board Systems (BBS's):
  86. -------------------------------
  87.    Look into file IBMBBS.TXT for a BBS near your country & city that might
  88.    carry the latest release of this package.
  89.  
  90.  
  91. For IBM Employees:
  92. ------------------
  93.    Send requests for WPSHELL package to WPSFWIN at BCRVMPC2:
  94.       TOOLS SENDTO BCRVMPC2 WPSFWIN WPSFWIN GET WPSHELL PACKAGE
  95.  
  96.    To subscribe to future updates of the package issue the command:
  97.       TOOLS SENDTO BCRVMPC2 WPSFWIN WPSFWIN SUBSCRIBE WPSHELL PACKAGE
  98.  
  99.    Get the latest information through WPSFWIN FORUM on IBMPC conference disk.
  100.  
  101.    OS2EWS Catalog also contains the latest release.  Type the following
  102.    command from VM:
  103.  
  104.       TOOLCAT OS2EWS
  105.  
  106.    Search for WPSFWIN package and press PF4 to request package,
  107.  
  108.  
  109. ------------------------------------------------------------------------
  110. 3)    W H E N   Y O U   E N C O U N T E R   A   P R O B L E M
  111. ------------------------------------------------------------------------
  112.  
  113. To ask any questions, report any problems, or send any comments,
  114. please address them to:
  115.  
  116.    IBM FORUM :  WPSFWIN FORUM (in IBMPC conference disk)
  117.                 and
  118.                 See WPSFWIN 941FORUM on IBMPCARC for appends from 3/94 to 6/94
  119.                 See WPSFWIN 951FORUM on IBMPCARC for appends from 6/94 to 9/94
  120.                 See WPSFWIN 952FORUM on IBMPCARC for appends from 9/94 to 1/95
  121.  
  122.  
  123.    MAIL      :  WPS for Windows
  124.                 IBM
  125.                 Internal Zip 1211
  126.                 1000 N.W. 51st Street
  127.                 Boca Raton, FL 33431
  128.  
  129.  
  130. NOTE: When sending a problem report please include the following
  131.       information in your note:
  132.          - Version of Workplace Shell for Windows being used.
  133.          - Windows (i.e. 3.1, 3.11) and DOS (i.e. 5.x, 6.x) versions.
  134.          - Computer manufacturer and model number.
  135.          - Video adapter manufacturer and resolution mode tested in.
  136.          - Amount of RAM memory.
  137.          - Processor type and clock speed.
  138.          - Any software that is automatically loaded by Windows.
  139.            (such as Adobe Type Manager (ATM), screen savers, ect...).
  140.  
  141.  
  142. ------------------------------------------------------------------------
  143. 4)            R E L E A S E   F I L E   L I S T
  144. ------------------------------------------------------------------------
  145.  
  146. Files that make up this release of Workplace Shell for Windows are:
  147.  
  148. Run-time:
  149.     WPSHELL.EXE     : Workplace Shell for Windows executable.
  150.     WNDLIST.EXE     : Workplace Shell for Windows task manager replacement.
  151.     FCLNBW.DLL      : IBM CUA Notebook control library.
  152.     FCLSPBW.DLL     : IBM CUA Spin Button control library.
  153.     CTL3D.DLL       : Microsoft 3-D controls library.
  154.     WARPICON.DLL    : OS/2 WARP 3.0 icon library supplement.
  155.     OS21ICON.DLL    : OS/2 2.1 icon library (old WPSHELL.EXE icon set).
  156.  
  157. Language-dependent:
  158.     WPS_XXXX.DLL    : WPSHELL.EXE NLS resource library.
  159.     PTW_XXXX.DLL    : PMTOWP.EXE NLS resource library.
  160.     CNV_XXXX.DLL    : CONVINI.EXE NLS resource library.
  161.  
  162.     Where "XXXX" is one of the following languages:
  163.        DUTC : Dutch.
  164.        ENUS : English (US).
  165.        FINN : Finnish.
  166.        FREN : French (Canadian).
  167.        GRMN : German.
  168.        PORT : Portuguese (Brazilian).
  169.        SPAN : Spanish.
  170.        SWED : Swedish.
  171.  
  172. Documentation:
  173.     INSTALL.TXT     : Intallation instructions for package.
  174.     README.1ST      : (This file) "Read Me First" file containing basic
  175.                       directions on what to do with this program.
  176.     LICENSE.TXT     : IBM EWS License Agreement details.
  177.     WPSHELL.HLP     : Workplace Shell for Windows help file.
  178.     IBMBBS.TXT      : BBS listings for package availability.
  179.  
  180. Support Utilities:
  181.     CONVINI.EXE     : Conversion utility for WPSHELL.INI files 0.5.x -> 1.0.
  182.     PMTOWP.EXE      : Program Manager to Workplace Shell desktop migration
  183.                       utility (always run from PROGMAN).
  184.     WINSHUT.EXE     : Windows shutdown utility program.
  185.  
  186. Optional:
  187.     IBMWALL.BMP     : "IBM" Wallpaper for Windows (copy to \WINDOWS directory).
  188.  
  189.  
  190.  
  191. ------------------------------------------------------------------------
  192. 5)        I N S T A L L A T I O N   I N S T R U C T I O N S
  193. ------------------------------------------------------------------------
  194.  
  195.  
  196. (A) Automatic:
  197. -------------
  198.  
  199.    Read text file INSTALL.TXT for complete installation instructions.
  200.  
  201.  
  202. (B) Manual:
  203. ----------
  204.  
  205.    1) Uncompress files listed in the "Release File List" above by using
  206.       EXPAND.EXE (in \DOS directory) and copy expanded files into a
  207.       destination directory (i.e. C:\WPSHELL).
  208.  
  209.       Copy the following files in your \WINDOWS\SYSTEM directory:
  210.  
  211.          FCLNBW.DLL      : IBM CUA Notebook control library.
  212.          FCLSPBW.DLL     : IBM CUA Spin Button control library.
  213.          CTL3D.DLL       : Microsoft 3-D controls library.
  214.  
  215.       Copy file WPSHELL.HLP into the \WINDOWS directory.
  216.  
  217.       Copy NLS resource libraries that match the language you have installed
  218.       in Windows.  Look in WIN.INI file "[Intl]" section, "sLanguage" key
  219.       and find out which language it is. Following are some of the language
  220.       codes used by Windows:
  221.  
  222.       "sLanguage"   Name                          Resource Library
  223.  
  224.          dan        Danish                        DANI
  225.          deu        German                        GRMN
  226.          eng        International English         ENUS
  227.          enu        U.S. English                  ENUS
  228.          esn        Modern Spanish                SPAN
  229.          esp        Castilian Spanish             SPAN
  230.          fin        Finnish                       FINN
  231.          fra        French                        FREN
  232.          frc        French Canadian               FREN
  233.          isl        Icelandic
  234.          ita        Italian
  235.          nld        Dutch                         DUTC
  236.          nor        Norwegian
  237.          ptb        Brazilian Portuguese          PORT
  238.          ptg        Portuguese                    PORT
  239.          sve        Swedish                       SWED
  240.  
  241.  
  242.    2) Run PMTOWP.EXE from Program Manager's "File" -> "Run..." menu.
  243.  
  244.    3) Manually change the following SYSTEM.INI entries in the [boot] section:
  245.  
  246.         taskman.exe=taskman.exe    (if any, most will not have this line)
  247.         shell=progman.exe
  248.  
  249.            to
  250.  
  251.         taskman.exe=<path>\wndlist.exe     (add if it does not exists)
  252.         shell=<path>\wpshell.exe
  253.  
  254.         (where <path> is the directory where WPSHELL.EXE is stored).
  255.  
  256.    4) Exit Windows and restart so that the new shell will take effect.
  257.       If you experience any problems at this point, please refer to the
  258.       "When You Encounter A Problem" section above.
  259.  
  260.    Optional Step In Manual Installation:
  261.    ------------------------------------
  262.  
  263.    5) Copy IBMWALL.BMP to the \WINDOWS directory and using the
  264.       the "Background" page in the Desktop's settings notebook or
  265.       "Control Panel" -> "Desktop" application change the background bitmap
  266.       to IBMWALL.BMP and select the "Tile" attribute.
  267.  
  268.  
  269.  
  270. (C) Uninstall Instructions:
  271. --------------------------
  272.  
  273.    1) If in Windows, exit Windows.
  274.  
  275.    2) Edit SYSTEM.INI file in \WINDOWS directory and replace the following
  276.       lines:
  277.  
  278.       taskman.exe=<path>\wndlist.exe
  279.       shell=<path>\wpshell.exe
  280.  
  281.       with
  282.  
  283.       taskman.exe=taskman.exe
  284.       shell=progman.exe
  285.  
  286.    3) Restart Windows 3.1.
  287.  
  288.    4) Remove the following files from your \WINDOWS\SYSTEM directory:
  289.  
  290.           FCLNBW.DLL      : IBM CUA Notebook control library.
  291.           FCLSPBW.DLL     : IBM CUA Spin Button control library.
  292.  
  293.    5) Delete all contents of the Workplace Shell for Windows destination
  294.       diretory.
  295.  
  296.  
  297. ------------------------------------------------------------------------
  298. 6)     E D I T I N G   Y O U R   S Y S T E M . I N I   F I L E
  299. ------------------------------------------------------------------------
  300.  
  301.    A "Workplace_Shell_for_Windows" section is created (and maintained)
  302. automatically by WPSFWIN in your SYSTEM.INI file in the \WINDOWS directory.
  303.  
  304.    The SYSTEM.INI file is where Windows 3.1 and other system-related
  305. applications and drivers keep vital information that reflects or changes
  306. the behavior of the system.  This is a pure text file (ASCII-file) that
  307. can be edited by any of your favorite ASCII editors (i.e. e, epm, edit).
  308.  
  309.    WPSFWIN will create (if you edit the "System" settings notebook) a
  310. Workplace Shell for Windows section in this file when you change any of
  311. the "System" default settings.  This section will look something like this
  312. (and it will probably be at the end of the SYSTEM.INI file):
  313.  
  314. [Workplace_Shell_for_Windows]
  315. DESKTOP_HorzIconIndent=23               (other values:0-32,000)
  316. DESKTOP_VertIconIndent=5                (other values:0-32,000)
  317. SYSTEM_ConfirmOnFolderDelete=Yes        (other values: No)
  318. SYSTEM_ConfirmOnDelete=Yes              (other values: No)
  319. SYSTEM_ConfirmOnFileSystemDelete=Yes    (other values: No)
  320. SYSTEM_ButtonAppearance=Minimize        (other values: Hide)
  321. SYSTEM_Animation=Enabled                (other values: Disabled)
  322. SYSTEM_MinBehavior=MinToViewer          (other values: Hide and MinToDesktop)
  323. SYSTEM_OpenBehavior=CreateNew           (other values: DisplayExisting)
  324. SYSTEM_SystemSetupFolderName=System Setup (depends on the language installed)
  325. SYSTEM_NoSave=Disabled                  (other values: Enabled)
  326. COLOR_ShadowText=00FF00                 (other values: <Blue><Green><Red>)
  327.  
  328.    As you can see must of the entries in the section are self-explanatory.
  329. The "ConfirmOnDelete" entry lets WPSFWIN know that you want to confirm
  330. all delete operations done in the shell.  "ConfirmOnFolderDelete" is
  331. a sub-classed "ConfirmOnDelete", this means that if "ConfirmOnDelete" is
  332. "No", the "ConfirmOnFolderDelete" will take precedence for delete operations
  333. done on folder objects (recommened default settings is "Yes").
  334.  
  335.    Also, The whole "Window" page in the "System" settings notebook is
  336. listed. You can edit these entries manually if you want, but they won't
  337. take effect until you restart Windows or open the "System" settings
  338. notebook again and press "Default" on the "Windows" page.
  339.  
  340.    Notice the "other values" possible in each entry in the WPSFWIN section.
  341. These values can be case-insensitive.
  342.  
  343.    The "COLOR_ShadowText" is a BGR triplet mapped to 2-digit hexadecimal
  344. values.  Each primary color can be a hexadecimal value from 00 to FF.
  345. Therefore, if you want bright cyan, for example, you would want the Blue and
  346. Green primary colors full brightness (hex. FF).  So, the final SYSTEM.INI
  347. entry for COLOR_ShadowText would be FFFF00.
  348.  
  349.    If you are not familiar with the meaning of these values, refer to any
  350. OS/2 2.x user's manual.
  351.  
  352.     Also, I would like to explain the other entries made and used by WPSFWIN
  353. in SYSTEM.INI:
  354.  
  355.    [boot]
  356.    taskman.exe=<path>\wndlist.exe
  357.    shell=<path>\wpshell.exe
  358.  
  359.    These two entries are the core of how WPSFWIN is able to substitute
  360. PROGMAN "seamlessly".  Windows 3.1 uses these two key entries to figure
  361. out who will be handling the task management for the user, and who will
  362. become the default Windows GUI shell to the user.
  363.  
  364.    The entry "taskman.exe=<path>\wndlist.exe" makes the WPSFWIN "Window
  365. List" the default task manager.  If you ever want to switch to the
  366. original "Task Manager" that comes with Windows 3.1, just manually edit
  367. this line and make it: "taskman.exe=taskman.exe". Just that simple!
  368.  
  369.    The entry "wpshell.exe=<path>\wpshell.exe" makes WPSHELL.EXE become
  370. the default GUI for Windows 3.1.  If you ever decide that WPSFWIN is not
  371. the "cola" for you... just edit that statement to "shell=progman.exe".
  372. Easy huh!?, and you don't even need a bottle opener!!
  373.  
  374.  
  375.  
  376. ------------------------------------------------------------------------
  377. 7)      E D I T I N G   Y O U R   W I N . I N I   F I L E
  378. ------------------------------------------------------------------------
  379.  
  380.    The "WPSFWIN System Event Sounds", just like its OS/2 counterpart
  381. (but to a lesser degree), registers 5 system events when installed.
  382. These event registrations are just 5 more lines in your WIN.INI file.
  383. Just look for the "[sounds]" section of the file, and you'll find many
  384. system events and the sounds (WAV files) associated with them listed.
  385. At the bottom of the list, there should be 5 entries of this form
  386. (if no associations have been done):
  387.  
  388. WPBeginDrag=,Workplace Shell Begin Drag
  389. WPEndDrag=,Workplace Shell End Drag
  390. WPFolderClose=,Workplace Shell Folder Close
  391. WPFolderOpen=,Workplace Shell Folder Open
  392. WPShred=,Workplace Shell Shred
  393.  
  394.    Notice that there are no *.WAV files associated with them.  The
  395. easiest way to do it is by selecting the "Control Panel"'s "Sounds" program.
  396. It will read the events for you and let you associate sounds to them.
  397.  
  398.    If you ever want to edit the name of the events, edit the text at the
  399. END of the line.  For example if I wanted to change the description of
  400. the "Workplace Shell Folder Close" event to "Close'em up!", here is what
  401. you'll need to edit:
  402.  
  403. <from>:
  404. WPFolderClose=,Workplace Shell Folder Close
  405.  
  406. <to>:
  407. WPFolderClose=,Close'em up!
  408.  
  409.    If you ever want to delete all events from you Windows 3.1 system,
  410. delete all 5 lines and voila! They're gone.
  411.  
  412.  
  413. ------------------------------------------------------------------------
  414. 8)                  K N O W N   P R O B L E M S
  415. ------------------------------------------------------------------------
  416.  
  417.    8.1) The "Disappearing-Desktop" problem (or ATM-bug) is caused by
  418.         the automatic loading of the Adobe Type Manager (ATM) drivers
  419.         in SYSTEM.INI.  We have been able to isolate the problem to the
  420.         loading of the drivers while WPSFWIN is the default Windows shell.
  421.  
  422.         For ATM 2.0 or 2.5 drivers installed:
  423.  
  424.         To quickly fix this problem, manually edit your SYSTEM.INI file
  425.         and comment out the following lines by placing a ';' (semi-colon)
  426.         at the beginning of the line:
  427.  
  428.         system.drv=atmsys.drv
  429.         atm.system.drv=system.drv
  430.  
  431.         <to>
  432.  
  433.         ;system.drv=atmsys.drv
  434.         ;atm.system.drv=system.drv
  435.  
  436.         Contact Adobe Systems to get the latest ATM drivers (version 3.01).
  437.  
  438.         If you have ATM 3.0 drivers or higher, just add the following line
  439.         to the "Settings" section of ATM.INI file:
  440.  
  441.         ATMIcon=Off
  442.  
  443.         With this change the ATM drivers can be loaded but no "ATM" icon will
  444.         be displayed on the bottom-left corner of the screen at startup time.
  445.  
  446.  
  447.    8.2) When running Program Manager AND Workplace Shell together, Program
  448.         Manager will respond to any "PROGMAN" and "SHELL" DDE services.
  449.         The "PROGMAN" DDE service is used by installation programs to create
  450.         and query program groups and items.
  451.         The "SHELL" DDE service is used in Windows by DOS applications and
  452.         DOS "boxes" to associate title text and icons to them.
  453.         Therefore, if installing a new software application, be aware that
  454.         you must run Workplace Shell alone for it to communicate correctly
  455.         with the installing application.
  456.  
  457.  
  458.    8.3) OS/2 Full-Pack Warp users installing under Win-OS/2 sessions will
  459.         not be able to terminate (or shutdown) their Windows session
  460.         correctly.  This is a problem that only happens in the Full-Pack
  461.         version of OS/2 Warp.  The shutdown function works with no problems
  462.         under native Windows 3.1x and OS/2 Warp (for Windows).
  463.  
  464.  
  465.    8.4) Applications which have been documented not to install properly
  466.         under WPSHELL.EXE:
  467.            * Quicken 4.0
  468.            * Arts & Letters
  469.  
  470.  
  471.    8.5) If you have any problems using DOS applications (or DOS windows)
  472.         while running WPSFWIN, you can disable the DOS DDE "SHELL" service
  473.         in WPSFWIN by adding the following key value to SYSTEM.INI in the
  474.         "Workplace_Shell_for_Windows" section:
  475.         DEBUG_DOSDDEFlags=0x0001
  476.  
  477.  
  478.    8.6) If you encounter a problem with repainting the Windows desktop,
  479.         add the following key value to the SYSTEM.INI in the
  480.         "Workplace_Shell_for_Windows" section:
  481.         COMPATIBLE_Flags=0x0001
  482.         The following applications have been found to cause this problem:
  483.         * PC-Xware for Windows v2.0
  484.  
  485.  
  486.    8.7) Because settings notebooks contain multiple dialogs and each dialog
  487.         owns many controls, it is recommended you do not open more than
  488.         5 settings notebooks at any one time.  There is a maximum of about
  489.         10 settings notebooks open before the Windows system runs out of
  490.         "USER" resources.  Of course, this might vary depending on which
  491.         object's settings notebooks you open; template and shredder objects
  492.         use less memory than folder and program objects.
  493.  
  494.         But, as a general rule, try to keep the number of settings notebooks
  495.         open at any one time to a minimum.
  496.  
  497.  
  498.    8.8) If you have any problems using the utility program WINSHUT.EXE,
  499.         try adding the following command line switch ot it: -skipwps
  500.         This will skip some special processing that WINSHUT.EXE does for
  501.         WPSFWIN and call ExitWindows() directly.  Therefore, the message box
  502.         confirming shutdown won't appear and Windows will shutdown
  503.         immediatedly.
  504.  
  505. ------------------------------------------------------------------------
  506. END OF 'README.1ST' FILE
  507.