README

   1   DejaGnu is a framework for testing other programs. Its purpose is to
   2 provide a single front end for all tests.  Beyond this, DejaGnu offers
   3 several advantages for testing:
   4
   5         - The flexibility and consistency of the DejaGnu framework
   6           make it easy to write tests for any program.
   7
   8         - DejaGnu provides a layer of abstraction which makes all
   9           tests (if correctly written) portable to any host or target
  10           where a program must be tested.  For instance, a test for
  11           GDB can run (from any Unix based host) on any target
  12           architecture supported by DejaGnu. Currently DejaGnu runs
  13           tests on several single board computers, whose operating
  14           software ranges from just a boot monitor to a full-fledged,
  15           Unix-like realtime OS.
  16
  17         - DejaGnu is written in expect, which in turn uses Tcl
  18           (Tool command language).  The framework comprises two parts:
  19           the testing framework and the testsuites themselves. Tests
  20           are usually written in expect using Tcl.
  21
  22   Bugs can be reported to bug-dejagnu@gnu.org.
  23
  24                       How To Configure and Build
  25
  26  To build DejaGnu, run the ``configure'' script here, e.g.:
  27
  28         ./configure MYHOSTTYPE
  29
  30 followed by running ``make''.  (MYHOSTTYPE is a name for your host computer,
  31 for instance "sun4".  You can use the script ``config.sub'' to test whether
  32 a name is recognized; if it is, config.sub translates it to a triplet
  33 specifying CPU, vendor, and OS.) This is used when you plan to
  34 configure and build in the source tree.
  35
  36   If you use a separate tree for object files, (the recommended way),
  37 then the --srcdir option must also be specified. This would also
  38 require that the configure script be run from the top level directory.
  39
  40         PATH/configure MYHOSTYPE
  41
  42 where PATH is is the directory that the contains the sources.
  43
  44   To configure it so it gets installed somewhere other than the
  45 default of /usr/local, use the --prefix option.
  46
  47         configure MYHOSTYPE --prefix [PATH]
  48
  49 where PATH is the prefix used to install the programs.
  50
  51   The configure testing and building will use the native compiler "cc"
  52 on your host machine. To change which compiler gets used (like gcc)
  53 set a the variable "CC" in your environment to point to it.
  54
  55         For csh users:          "setenv CC gcc"
  56         For bourne shell users: "CC=gcc;export CC"
  57
  58   Then when you compile, use "make CC=$CC".
  59
  60 See /usr/doc/dejagnu-$version/overview/book1.html or
  61 /usr/doc/dejagnu-$version/overview.ps for  for more details.
  62
  63  As DejaGnu is a Tcl program, there is little to build. However, the
  64 documentation is not built by default. Use these targets:
  65 "make overview.html" - Generate the html formatted documentation from
  66                   the SGML source.
  67 "make overview.ps" - Generate the Postscript formatted documentation from
  68                   the SGML source.
  69 "make overview.pdf" - Generate the PDF formatted documentation from
  70                   the SGML source.
  71 "make install"  - This installs DejaGnu based on the --prefix option
  72                   when configuring. Otherwise it defaults to
  73                   /usr/local. See the DejaGnu manual for more
  74                   information on installation.