
   Gregorian Programmers Guild                           -- INSTALL.TXT --
 
   Installation Instructions for the dwm package

   Copyright (C) 1994, Gregorian Programmers Guild, all rights reserved.
   Published by Gregorian Programmers Guild,
   4112 Hotel de Ville
   Montreal, Quebec, 
   H2W 2H1
   Canada
   (514) 281-6425 

   ****************************************************************
   dwm (tm)    Copyright (c) 1994, Gregorian Programmers Guild
   dobs (tm)   Copyright (c) 1994, Gregorian Programmers Guild
   vern (tm)   Copyright (c) 1994, Gregorian Programmers Guild
   blanch (tm) Copyright (c) 1994, Gregorian Programmers Guild
   dnote (tm)  Copyright (c) 1994, Gregorian Programmers Guild
   ****************************************************************

   Installation
   ------------

     Installation must be done from within the Windows environment.

     In program manager go to the File menu and select Run.  Type in
    a:\setup.exe (or wherever the distribution files happen to be).  Enter the
    path for the destination directory, by default it will be c:\dwm; you can
    change this to wherever you want the files installed.  Click on the install
    button, wait several seconds.
    
     If you are installing over a previous version of dwm the setup program
    will ask to restart once you have finished the installation.  You can install
    the program directly onto the older version.

     The setup program first verifies that all the necessary system files are
    installed. It may copy a special dynamic link library file called
    ctl3dv2.dll into your Windows system directory (usually c:\windows\system).
    This library is used to create 3-dimensional looking dialog boxes and
    controls, and must be present in the system directory if dwm is to work
    properly. The second step of the installation is performed by the program
    part2.exe, which is run automatically by setup.exe during the setup
    process. During this step, several files (executables, libraries, help and
    text files, and special dwm startup files) are copied to the destination 
    directory and the PATH in the autoexec.bat file is modified to include 
    the dwm directory. When this is finished you can create a program manager
    group and/or read the README.TXT file, by clicking on the appropriate
    button in the setup dialog box (these buttons become active after the
    installation is complete).

     After you have finished the installation, go the the dwm group in the
    program manager and double click on the dwm icon.  This will launch dwm
    (which appears on the desktop as a small dark grey desktop object with
    several concentric squares (similar to an icon) as well as Vern (the light
    grey virtual desktop control). If you right click on the dwm button a 
    dialog box will open.  To make dwm the default shell (normally the shell

                                Gregorian Programmers Guild INSTALL.TXT Page 1


    is Program Manager whose primary function is the launching of 
    applications), open the dialog box as above and click the checkbox
    labelled 'Make dwm the default shell' ON.  Click on the 'Accept' button 
    and close program manager to exit Windows.  You might want to check the
    autoexec.bat file to verify that the PATH statement has indeed been 
    updated to include the dwm directory (c:\dwm by default). This is required
    only if you use dwm as the default Windows shell, which is recommended.

     Now reboot your computer (Ctrl-Alt-Del) or hit the reset button so the
    computer will recognize the updated PATH (or do whatever you normally do
    to update the PATH environment variable).

     After the computer has rebooted run Windows.  You should see a nice
    clean desktop with the small dwm button and vern (the virtual desktop).
    If you see the error message 'Cannot find About.dll' and 'Cannot find 
    dwmhook.dll' you have not properly updated your PATH statement.  Make
    sure that the dwm directory is in the PATH (type 'PATH' at the dos 
    prompt to view your path).

     If all is well (that is Windows has started and dwm is running as the
    shell) now would be a good time to click on the desktop (this is any
    area of the screen which is NOT covered by any other program). If you
    click the left mouse button on the background (i.e: desktop) you should
    see a pop-up menu.  This is a user configurable menu which is specified
    in the file dwm.mnu. If you click the right mouse button (we'll refer to
    these clicks as left-clicks and right-clicks from now on) you should see
    the Program Manager menu.  This menu contains a series of flyout menus,
    each of which represents a different program manager group.  Clicking
    on one of the group menus displays a list of group items.

     Click on the dwm group, and then click on the dobs entry. Now right-
    click on the desktop to popup the Program Manager menu and select
    a group that contains programs you use frequently.  A flyout menu will
    appear listing the items in that group, click on an application --
    if you release the mouse button right away that application will be
    launched, if you hold down the mouse button and drag the file onto the
    desktop, you can drop it to blanch your application.  Your dwm Windows
    environment is now basically configured, and you can use all the dob
    applications (dwm, dobs, vern and blanch).  All the applications have
    extensive online help that can be accessed through Windows help system.
    
  *Note* that making dwm the default shell changes the SHELL= line in the
    system.ini file so that Windows loads dwm.exe rather than progman.exe
    when Windows is started. If you have problems,

     - load c:\windows\system.ini using an ASCII text editor
        (like the DOS EDIT program)
     - change the line shell=c:\dwm\dwm.exe to shell=c:\windows\progman.exe 

    the above instructions assume that you have installed dwm.exe in the
    directory c:\dwm and that Windows is located in c:\windows.

                             Gregorian Programmers Guild INSTALL.TXT Page 2

   ****************************************************************

   Files: The way your software is packaged depends somewhat on the
   way in which it was obtained. Your shareware package must be an
   installation distribution, containing the 2 executable programs
   SETUP.EXE and PART2.EXE, as well as a number of files which have
   an underscore (_) as the third character of the file extension. 

          setup.exe - installation program
          part2.exe - private executable, used by setup.exe

   After installation, the following files will be present:

            dwm.exe - dob window manager
            dwm.mnu - dwm main menu file
           vern.exe - virtual desktop environment
           dobs.exe - file manager
         blanch.exe - button launcher
       reswatch.exe - resource graph
          dnote.exe - note pad
        gpglogo.exe - commercial for us
       metriclk.exe - metric clock
        dwmhook.dll - mouse/keyboard hooks for vern and dwm
          about.dll - general purpose about box dll
       ctrl3dv2.dll - dll for 3-D look in dialog boxes
         dwmhep.hlp - help for dwm
        dobshep.hlp - help for dobs
        vernhep.hlp - help for vern
       blanchep.hlp - help for blanch
       register.hlp - help for registering your shareware package
         readme.txt - info on dwm package and product support
        install.txt - this file
        license.txt - shareware license agreement
          order.txt - info for registering dwm
         vendor.txt - info for shareware vendors and distributors
            bbs.txt - info for BBS administrators
        changes.txt - changes/bug fixes from version to version
          order.frm - cheque/money order order forms

   After you run dwm the following files will also be installed,
      progman.mnu - program manager menu file (dwm directory)
          dwm.dsk - dwm desktop file          (dwm directory)
          dwm.ini - dwm initialisation file   (Windows directory)

   The aggregate size of the installed package is about 900 Kbytes.
   With the exception of the files ctrl3dv2.dll and dwm.ini, all files will be
   copied into the destination directory specified during the installation.







                             Gregorian Programmers Guild INSTALL.TXT Page 3

