/* $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 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