Regenerated html docs. Tweaked how Makefile.am builds tarballs.
[dejagnu.git] / README
blob0c66eab3c95ee1bad2e898bcbd6f3da9ca5d4d72
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:
5         - The flexibility and consistency of the DejaGnu framework
6           make it easy to write tests for any program.
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.
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.
22   Bugs can be reported to bug-dejagnu@gnu.org.
24                       How To Configure and Build
26  To build DejaGnu, run the ``configure'' script here, e.g.:
28         ./configure MYHOSTTYPE
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.
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.
40         PATH/configure MYHOSTYPE
42 where PATH is is the directory that the contains the sources.
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]
49 where PATH is the prefix used to install the programs. 
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"
58   Then when you compile, use "make CC=$CC". 
60 See /usr/doc/dejagnu-$version/overview/book1.html or
61 /usr/doc/dejagnu-$version/overview.ps for  for more details. 
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.