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