/* $XConsortium: README /main/5 1996/07/15 14:20:13 drk $ */

1.  Test Suite Organization and Procedures

This readme presents an overview of the organization of the

OSF/Motif Test Suite and the procedures for building and

running the tests.  The testing procedures have changed sub-

stantially since the 1.2 release of Motif.  We think you

will find the new procedures more intuitive and easier to

use, but please familiarize yourself with them by reading

this guide before you run the new tests.

These test suites are the test suites that we used to test

OSF/Motif prior to the 2.0 release.  We provide them for

your convenience, and expect you may have the following uses

for them, although you may have other uses for them.

   * To examine our testing procedures

   * To test your implementation of OSF/Motif

   * To see examples of working code spanning the range of

     OSF/Motif

   * To check for bugs in the Motif source that may be caus-

     ing problems in your code

1.1  Identifying the Tests

Some of the areas of OSF/Motif Test Suite include:

   * The OSF/Motif Resource Manager (Mrm) Tests

   * The OSF/Motif Toolkit Tests

   * The OSF/Motif XmString Tests

   * The OSF/Motif Window Manager (mwm) Tests

   * The OSF/Motif User Interface Language (uil) Tests

   * The OSF/Motif Drag and Drop (DragAndDrop) Tests

   * The OSF/Motif Internationalization (I18N) Tests

   * The OSF/Motif Universal Transfer Model (UTM) Tests

1.2  Locating the Tests

The Motif 2.0 release software is shipped with the tests

located one level below the top directory.  Unless you move

the tests to another location after installing the Motif

software, you should have no trouble locating them.

Throughout this document, we use the path ./tests to specify

the path to the Test Suite.  The ./ indicates the testing

tree root and is not an actual path designation.  For exam-

ple, you might install the release software at a location

called /source/Motif.  In that case, the path ./tests

translates to /source/Motif/tests.

The Test Suite consists of a hierarchy of directories and

files; each directory has subordinate directories and files

relevant to that content area.

The different test sets are located in the Mrm, Toolkit,

XmString, mwm, and uil subdirectories of ./tests.

1.3  Building the Tests

The OSF/Motif Release Notes specify how to build the

OSF/Motif software.  If you follow this process, the tests

can be built along with other build components.

However, be aware that the test suites are very large and

can use large amounts of disk space when compiled on some

machines.  Consequently, you may prefer to build them indi-

vidually prior to running the tests.

If you build this directory separate from the rest of Motif,

make sure you do a make wml before you doing a make depend

in this directory.  There are dependencies between files

created by the make wml process and the test files.

1.4  Running the Tests

There are a variety of procedures for running the tests in

the Test Suite.  In general, tests are run individually

by hand, following instructions provided in a separate win-

dow for each test.  Scripts are provided for running a

number of test in series.  These scripts often provide some

initialization for the tests.  Any necessary initialization

is also described where appropriate in this guide.

In order to run the tests you should have read, write, and

execute permission in the test suite tree.  If you do not

have complete permissions, you are not able to run all

the tests correctly.