TECHNICAL INFORMATION DOCUMENT

TITLE:              PTF652 - Fix for Numlock in mwm
DOCUMENT ID:        TID300121
DOCUMENT REVISION:  B
DATE:               18APR95
ALERT STATUS:       Yellow
INFORMATION TYPE:   Symptom Solution
README FOR:         ptf652

PRODUCT and VERSION:
UnixWare 1.1

ABSTRACT:

This patch provides a new 'mwm' program that is able to ignore the 
status of the NUMLOCK key. Previous versions of 'mwm' didn't allow 
any window manipulation with the mouse when the NUMLOCK key was on.


SYMPTOM

various, see below

SOLUTION

Apply the ptf652 file.


Installation Instructions:  

DATATYPE: datastream

1.  Download the ptf652.Z and ptf652.txt files to the /tmp directory
    on your machine.

2.  Read the release notes contained in this file and follow the
    instuctions to add the packages to your system.

3.  Now become root, uncompress the file and add the package to your 
    system using the following commands:

        $ su
        # uncompress /tmp/ptf652.Z
        # pkgadd -d /tmp/ptf652

Solution Specifics

SYMPTOM

The patched version of 'mwm' in ptf652 adds a new X resource to 'mwm'.  
This resource, 'ignoreNumLock', is a boolean.  When set to 'true', 
the status of the NUMLOCK key has no effect on mwm.  When set to 
'false', the new 'mwm' behaves as previous versions have -- it dis-allows 
all window manipulation with the mouse.  The default value for 
'ignoreNumLock' is 'true'.  So, the new 'mwm' will ignore the NUMLOCK 
key by default.

New Features
------------
The patched version of 'mwm' in ptf652 adds a new X resource to 'mwm'.  
This resource, 'ignoreNumLock', is a boolean.  When set to 'true', 
the status of the NUMLOCK key has no effect on mwm.  When set to 
'false', the new 'mwm' behaves as previous versions have -- it dis-allows 
all window manipulation with the mouse.  The default value for 
'ignoreNumLock' is 'true'.  So, the new 'mwm' will ignore the NUMLOCK 
key by default.

Software Notes and Recommendations
----------------------------------
The 'mrun' (Motif Runtime Package) must be installed before ptf652 may be
installed.

Hardware Notes and Recommendations
----------------------------------
None

Installation instructions
-------------------------
Place the diskette in the drive, and at the shell prompt type

     pkgadd -d diskette1

Or use the desktop installation procedure.

Troubleshooting
---------------
To test that the new 'mwm' program is correctly installed,
     
     - Make 'mwm' the window manager for a desktop user by editing
"$HOME/.olinitrc".

     - Log in as the 'mwm' desktop user.  You should see the 'mwm' hourglass
symbol as well as the standard clock symbol as the desktop is starting.

     - Press the NUMLOCK key.

     - Try to iconify the top desktop window using the mouse.

If you can iconify the window with the NUMLOCK key on, then the new version of
'mwm' installed correctly.

If mouse window manipulation does not work with the NUMLOCK key, make sure
there are no lines of the form:

     *ignoreNumLock: false

In the users X defaults file ("$HOME/.Xdefaults").  If there is such a line,
change the 'false' to 'true' and re-test as above.

If a user would prefer 'mwm' to interpret NUMLOCK as it has in the past, have
the user add the line above that sets the 'ignoreNumLock' resource to 'false'.