home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / utility / dwm121b / install.txt < prev    next >
Encoding:
Text File  |  1995-03-08  |  10.2 KB  |  212 lines
  1.     Gregorian Programmers Guild                           -- INSTALL.TXT --
  2.  
  3.    Installation and Upgrade Instructions for the dwm package
  4.  
  5.    Copyright (C) 1994, Gregorian Programmers Guild, all rights reserved.
  6.    Published by Gregorian Programmers Guild,
  7.    4112 Hotel de Ville
  8.    Montreal, Quebec, 
  9.    H2W 2H1
  10.     Canada
  11.    (514) 281-6425 
  12.  
  13.    ***********************************************************
  14.    dwm (tm)    Copyright (c) 1994, Gregorian Programmers Guild
  15.    dobs (tm)   Copyright (c) 1994, Gregorian Programmers Guild
  16.    vern (tm)   Copyright (c) 1994, Gregorian Programmers Guild
  17.    blanch (tm) Copyright (c) 1994, Gregorian Programmers Guild
  18.    ***********************************************************
  19.  
  20.  
  21.   Installation
  22.  
  23.   Installation must be done from within the Windows environment. The
  24.   user must have an installation distribution of the software, that includes
  25.   the two executable programs SETUP.EXE and PART2.EXE, as well as a
  26.   number of files that have an underscore (_) as the third character.
  27.  
  28.   In Program Manager go to the File menu and select Run. Type in
  29.   a:\setup.exe (or wherever the distribution files happen to be).  Enter the
  30.   path for the destination directory, by default it will be c:\dwm; you can
  31.   change this to wherever you want the files installed. Click on the install
  32.   button, wait several seconds.
  33.  
  34.   If you are installing over a previous version of dwm the setup program
  35.   will ask to restart once you have finished the installation. You can
  36.   install the program directly onto the older version (see the following
  37.   section on upgrading for more details).
  38.  
  39.   The setup program first verifies that all the necessary system files are
  40.   installed. It may copy the special dynamic link library file ctl3dv2.dll
  41.   into your Windows system directory (usually c:\windows\system).
  42.   This library is used to create 3-dimensional looking dialog boxes and
  43.   controls, and must be present in the system directory if dwm is to work
  44.   properly. The second step of the installation is performed by the program
  45.   part2.exe, which is run automatically by setup.exe during the setup
  46.   process. During this step, several files (executables, libraries, help and
  47.   text files, and special dwm startup files) are copied to the destination
  48.   directory and the PATH in the autoexec.bat file is modified to include
  49.   the dwm directory. When this is finished you can create a program
  50.   manager group and/or read the README.TXT file, by clicking on the
  51.   appropriate button in the setup dialog box (these buttons become active
  52.   after the installation is complete).
  53.  
  54.                                       Gregorian Programmers Guild INSTALL.TXT Page 1
  55.  
  56.   After you have finished the installation, go the the dwm group in the
  57.   program manager and double click on the dwm icon. This will launch dwm
  58.   (which appears on the desktop as a small dark grey desktop object with
  59.   several concentric squares (similar to an icon) as well as Vern (the light
  60.   grey virtual desktop control). If you right click on the dwm button a 
  61.   dialog box will open. To make dwm the default shell (normally the shell
  62.   is Program Manager whose primary function is the launching of 
  63.   applications), open the dialog box as above and click the checkbox
  64.   labelled 'Make dwm the default shell' ON. Click on the 'Accept' button 
  65.   and close Program Manager to exit Windows. You might want to check
  66.   the autoexec.bat file to verify that the PATH statement has indeed been 
  67.   updated to include the dwm directory (c:\dwm by default). This is required
  68.   only if you use dwm as the default Windows shell, which is recommended.
  69.  
  70.   Now reboot your computer (Ctrl-Alt-Del) or hit the reset button so the
  71.   computer will recognize the updated PATH (or do whatever you normally
  72.   do  to update the PATH environment variable).
  73.  
  74.   After the computer has rebooted run Windows. You should see a nice
  75.   clean desktop with the small dwm button and vern (the virtual desktop).
  76.   If you see the error message 'Cannot find About.dll' and 'Cannot find 
  77.   dwmhook.dll' you have not properly updated your PATH statement. Make
  78.   sure that the dwm directory is in the PATH (type 'PATH' at the DOS 
  79.   prompt to view your path).
  80.  
  81.   If all is well (that is Windows has started and dwm is running as the
  82.   shell) now would be a good time to click on the desktop (this is any
  83.   area of the screen which is NOT covered by any other program).
  84.  
  85.   If you click the left mouse button on the background (i.e: desktop) you
  86.   should see a pop-up menu. This is a user configurable menu which
  87.   contains some stock Windows applications, along with some native dwm
  88.   functions. If you click the right mouse button (we'll refer to these clicks as
  89.   left- clicks and right-clicks from now on) you should see the Program
  90.   Manager menu. This menu contains a series of flyout menus, each of
  91.   which represents a different program manager group. Clicking on one of
  92.   the group menus displays a list of items in the group.
  93.  
  94.   Click on the dwm group of the pop up program manager menu, and then
  95.   click on the dobs entry. Dobs will start, and a small button that looks
  96.   like a stylized hard disk will be stuck to the cursor. Move the cursor to
  97.   where you want the dob button, and left click with the mouse to stick the
  98.   dob button onto the desktop.
  99.  
  100.   Now click on the desktop to pop up the Program Manager menu and select
  101.   a group that contains programs you use frequently. A flyout menu will
  102.   appear listing the items in that group, click on an application -- if you
  103.   release the mouse button right away that application will be launched, if
  104.   you hold down the mouse button and drag the file onto the desktop, you
  105.   can drop it to blanch your application. Make blanches for your favorite
  106.   applications. Your dwm Windows environment is now basically configured,
  107.   and you can use all the dwm applications (dwm, dobs, vern and blanch).
  108.   All the applications have extensive online help that can be accessed
  109.   through the Windows help system.
  110.                                       Gregorian Programmers Guild INSTALL.TXT Page 2
  111.  
  112.   *Note* that making dwm the default shell changes the SHELL= line in the
  113.   system.ini file so that Windows loads dwm.exe rather than progman.exe
  114.   when Windows is started. If you have problems,
  115.  
  116.   - load c:\windows\system.ini using an ASCII text editor
  117.   - (like the DOS EDIT program)
  118.   - change the line shell=c:\dwm\dwm.exe to shell=c:\windows\progman.exe
  119.  
  120.   the above instructions assume that you have installed dwm.exe in the
  121.   directory c:\dwm and that Windows is located in c:\windows.
  122.    *****************************************************
  123.   Files: The way your software is packaged depends somewhat on the
  124.   way in which it was obtained. Your shareware package must be an
  125.   installation distribution, containing the 2 executable programs
  126.   SETUP.EXE and PART2.EXE, as well as a number of files which have
  127.   an underscore (_) as the third character of the file extension. 
  128.  
  129.           setup.exe - installation program
  130.           part2.exe - private executable, used by setup.exe
  131.  
  132.    After installation, the following files will be present:
  133.  
  134.             dwm.exe - dob window manager
  135.             dwm.mnu - dwm main menu file
  136.            vern.exe - virtual desktop environment
  137.            dobs.exe - file manager
  138.          blanch.exe - button launcher
  139.        reswatch.exe - resource graph
  140.         gpglogo.exe - commercial for us
  141.         dwmhook.dll - mouse/keyboard hooks for vern and dwm
  142.           about.dll - general purpose about box dll
  143.        ctrl3dv2.dll - dll for 3-D look in dialog boxes
  144.          dwmhep.hlp - help for dwm
  145.         dobshep.hlp - help for dobs
  146.         vernhep.hlp - help for vern
  147.        blanchep.hlp - help for blanch
  148.          register.hlp - help for registering your shareware package
  149.             readme.txt - info on dwm package and product support
  150.           install.txt - this file
  151.           license.txt - shareware license agreement
  152.              order.txt - info for registering dwm
  153.             vendor.txt - info for shareware vendors and distributors
  154.                 bbs.txt - info for BBS administrators
  155.              order.frm - cheque/money order order form
  156.           ccorder.frm - credit card order form
  157.  
  158.     After you run dwm the following files will also be created,
  159.           progman.mnu - program manager menu file  (dwm directory)
  160.                 dwm.dsk - dwm desktop file           (dwm directory)
  161.                 dwm.ini - dwm initialisation file    (Windows directory)
  162.             blanch.ini - blanch initialisation file (Windows directory)
  163.   The aggregate size of the installed package is about 900 Kbytes.
  164.   With the exception of the files ctrl3dv2.dll and dwm.ini, all files will
  165.   be copied into the destination directory specified during the installation.
  166.                                       Gregorian Programmers Guild INSTALL.TXT Page 3
  167.  
  168.   Upgrading
  169.  
  170.   Registered users will be contacted whenever there are changes or
  171.   improvements made to any of the dwm applications. Upgrades can be
  172.   obtained directly from GPG for a modest handling charge, or downloaded
  173.   electronically from a number of different locations. Registration codes
  174.   provided by GPG are good for any version of similar generation as the
  175.   original registration (1.xx, for example); major upgrades will require
  176.   new codes that registered users can purchase for a small upgrade fee.
  177.  
  178.   To upgrade your software to a more recent version, simply run the SETUP
  179.   program of your new distribution disk (you can run SETUP out of dobs,
  180.   or a dwm Run... dialog box). Setup will install the upgrade over the old
  181.   distribution. After the installation is complete you should restart
  182.   Windows or you may have trouble.  The user is given the following cautions
  183.   for performing upgrades:
  184.  
  185.   Do not click on the Create Program Group button. Creating a program
  186.   group during an upgrade will duplicate icons in the group (i.e. two copies
  187.   of each icon for each of the executable, help and text files). The
  188.   duplication of icons, if accidentally performed, is not fatal, but
  189.   annoying as the user will have to run the Program Manager to delete the
  190.   unnecessary items.
  191.  
  192.   Your old dwm.mnu file will be preserved in the course of upgrading, if
  193.   one already exists.  The default menu file installed during the setup
  194.   will be renamed as dwm.new.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.                                       Gregorian Programmers Guild INSTALL.TXT Page 4
  212.