README
1
2 contrib- 3.7a June 2006
3
4 This directory contains the unsupported user-contributed software.
5 This distribution is for use with TET3.7.
6
7 Please be aware that this software has been designed by its contributors
8 to work on UNIX operating systems. It is likely that some changes will be
9 required in order to make this software work on the
10 Windows NT operating system, see each demo to see whether it has been
11 ported to NT.
12
13 configtool - a configure shell script to simplify installation
14 of TETware
15
16 demo - is a simple demo test suite to illustrate the capabilities
17 of TETware. Follow the instructions in the readme file.
18
19
20 demo110 - is the standard simple TET1.10 demo, with an additional
21 scenario etet_scen to demo some of the ETET extensions.
22 To run this demo on Windows NT , use the NT makefile
23 (nt.mk)
24
25
26 win32demo.zip - is the simple demo test suite ported to Win32.
27
28
29 cplusdemo - a simple C++ demo. This is the standard TET1.10 demo
30 written in C++ with minor extensions to demonstrate the
31 tet_exec() call in the C++ API. See the README.NT file
32 for notes on porting to Windows NT. This version is written
33 to run under TETware.
34
35 perldemo - a simple Perl demo. This is equivalent to the
36 standard TET 1.10 demo.
37
38 remotedemo - a simple demonstration that runs a test of tests
39 written to run on a single system,
40 simultaneously on a number of remote systems.
41
42 NTperldemo - the same Perl demo above, but ported to Windows NT.
43
44 capi - the is the C API demo suite from the TETware Programmers
45 Guide. This has been extended over that described in the Guide
46 to include some additional build tools and a sample
47 report writer. This test suite tests the chmod, uname, fileno
48 and stat interfaces.
49
50 SHELL-API - this is the Shell API demo suite from the
51 TETware Programmers Guide. See the README file
52 for instructions on how to execute this.
53
54 scripts - this contains some sample reporting scripts which
55 process journal files. These are written in awk, perl and C.
56
57 tetreport - a report tool written in perl , together with
58 perl class libraries and documentation for generating
59 custom report formats.
60
61 crpt - report writer tools written in C, including a comparative
62 report writer - binaries for win32 systems are included
63
64 php-cli_api - this is a contributed PHP binding for TETware.
65
66 ruby_api - this is a contributed Ruby binding for TETware.
67
68 python_api - the contributed Python binding for TETware.
69 This is included here for use with the unsupported TET3.
70 (TETware support customers should use the supported Python
71 API included in TETware 3.8.)
72
73 tclapi - this is a contributed TCL API binding for TETware.
74 You need to use this with the TclX distribution that
75 supports signal handling.
76
77 tcldemo - this is simple demo test using the TCL API.
78
79 suite - is a test suite for the ETET, which tests both TET
80 base functionality for Perl, Shell and C API's as
81 well as ETET extensions.
82
83 This suite runs the suites under the contrib/api and
84 contrib/napi directories.
85
86 usltools - a sample buildtool and awk script to generate summary
87 results.
88
89 sun_lib - some sample library routines built upon the TET
90 API to make it simpler to use.
91
92 port - a TET portability library for BSD systems (taken from the
93 MIT X test suite release 1.2). The portability library
94 may be useful as a base for porting the TET to
95 other non-POSIX systems, however the portability library
96 is designed to run on a BSD system, and will not
97 necessarily build without change on other systems.
98
99 kshdapi - distributed Korn Shell API
100
101
102 To run the test suites provided here, please check for any README
103 files. Also note that unless you specify that the test suites
104 are rooted here in the contrib directory you'll need to specify
105 the path from TET_ROOT on the command invocation to tcc,
106
107 for example to run the demo suite
108
109 TET_ROOT=tet_root
110 export TET_ROOT
111 tcc -p -bec contrib/demo
112
113 or
114 TET_SUITE_ROOT=$TET_ROOT/contrib
115 export TET_SUITE_ROOT
116 tcc -p -bec demo
117
118