/* $XConsortium: README /main/7 1996/07/15 14:31:12 drk $ */
DESCRIPTION:

This directory contains tests of the OSF/Motif Window Manager (mwm)
Programmatic Interface.  It is assumed that the latest version of mwm
is running (found in ../../../clients/mwm/mwm).  All of the tests are
interactive, and include displayed user instructions where needed.  The
remaining tests create and display widgets, including a MessageBox
widget which displays instructions and a summary message.

The test PINames is run from within a script called "run_PINames." See
below for details.

The PIProto test does not currently test the WM_SAVE_YOURSELF or the
WM_TAKE_FOCUS properties.

The script run_PINames runs the command 'machine' to decide what type
of machine it is running on.  If this command is not available on your
platform, or if your platform is a version of System V, but not the
hp300 machine, modify the script appropriately.  Also, the run_PINames
script will print a message at the end that says something like
"run_PINames: 21326 Killed" with a different number before "killed".
This is normal and not to be concerned with.  Confirm that the above
script has execute permission before attempting any tests that use
them.

TESTS:

PIColormap	- Tests the property WM_COLORMAP_WINDOWS

PIHints		- Tests the properties WM_NORMAL_HINTS, WM_HINTS

PIIconSt	- Tests the properties WM_STATES, WM_ICON_SIZE

PIMwmHints	- Tests the property _WM_MOTIF_HINTS

PIMwmInfo	- Tests the property _WM_MOTIF_INFO

PINames		- Tests the properties WM_NAME, WM_ICON_NAME, WM_CLASS

PIProto		- Tests the properties WM_PROPERTIES, _MOTIF_WM_MESSAGES,
			_MOTIF_WM_MENU


FILES:

PIColormap.c	- source file for PIColormap test
PIColormap.uil	- value and object declarations for PIColormap test

PIHints.c	- source file for PIHints test
PIHints.uil	- value and object declarations for PIHints test

PIIconSt.c	- source file for PIIconSt test
PIIconSt.uil	- value and object declarations for PIIconSt test

PIMwmHints.c	- source file for PIMwmHints test
PIMwmHints.uil	- value and object declarations for PIMwmHints test

PIMwmInfo.c	- source file for PIMwmInfo test
PIMwmInfo.uil	- value and object declarations for PIMwmInfo test

PINames.c	- source file for PINames test
PINames.uil	- value and object declarations for PINames test

PIProto.c	- source file for PIProto test
PIProto.uil	- value and object declarations for PIProto test

PI.Xdefaults	- some resource lines used by the PINames/run_PINames test

README		- this file

convenience.c	- help and quit callbacks

main.c		- code for generating MessageBox widget
main.uil	- value and object declarations for MessageBox widget

run_PINames	- script to run the PINames test, it will save the current
			resource database, merge new things into the database,
			kill the mwm running, start a new mwm, run the PINames
			test, restore the old resource database, and restart
			the original mwm window manager.

summary.c	- code for generating summary messages



COMPILATION:

To compile all of these tests, type either "make"
or "make all".

To compile individual tests:

PIHints		- "make PIHints PIHints.uid"

PIIconSt	- "make PIIconSt PIIconSt.uid"

PIMwmHints	- "make PIMwmHints PIMwmHints.uid"

PIMwmInfo	- "make PIMwmInfo PIMwmInfo.uid"

PINames		- "make PINames PINames.uid"

PIProto		- "make PIProto PIProto.uid"

PIColormap	- "make PIColormap PIColormap.uid"


EXECUTION:

To run any of these tests (except PINames), simply type the name of
the test, e.g.

% PIHints

The test PINames requires the window manager to be restarted after new
resource are added to the database.  To do this, there is a run script
that will handle all the saving, starting, restoring and restarting.  So,
to run the PINames test, run the script as follow:

% run_PINames


BUGS SHOWN BY THESE TESTS
 
PIHints
PIRS No.:      4215
mwm teStatus:		don't test for change in transient characteristic, w
which doesn't appear to work
Version found in:	1.2S3
Version fixed in:	1.2S4
Assigned to:	M.S. RAMESH
Priority:	5
Status:		R

PIIconSt
PIRS No.:      3363
Do not display the window menu when double-clicking on an
icon or the window menu.
Version found in:	1.1.2
Version fixed in:	1.2S3
Assigned to:	MICHAEL YEE
Priority:	7
Status:		C

PIIconSt
PIRS No.:      3720
<CR> character in an icon label, results in the label getting
wiped out completely.
Version found in:	1.1.4
Version fixed in:	
Assigned to:	MICHAEL YEE
Priority:	3
Status:		A

PIIconSt
PIRS No.:      4040
Single click of MouseBtn1 on an icon should post the window
menu.
Version found in:	1.2S3
Version fixed in:	1.2S3
Assigned to:	MICHAEL YEE
Priority:	5
Status:		R

PIIconSt
PIRS No.:      4046
Creating a MessageBox child of an already realized Shell does
not resize the Shell properly.
Version found in:	1.2S3
Version fixed in:	1.2S4
Assigned to:	DANIEL DARDAILLER
Priority:	5
Status:		C

ENDBUGS