diff options
Diffstat (limited to 'contrib/bluegnu2.0.3/doc/notice.html')
| -rw-r--r-- | contrib/bluegnu2.0.3/doc/notice.html | 395 |
1 files changed, 395 insertions, 0 deletions
diff --git a/contrib/bluegnu2.0.3/doc/notice.html b/contrib/bluegnu2.0.3/doc/notice.html new file mode 100644 index 0000000..4c59360 --- /dev/null +++ b/contrib/bluegnu2.0.3/doc/notice.html @@ -0,0 +1,395 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<!--Converted with LaTeX2HTML 98.1p1 release (March 2nd, 1998) +originally by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds +* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan +* with significant contributions from: + Jens Lippmann, Marek Rouchal, Martin Wilck and others --> +<HTML> +<HEAD> +<TITLE>Release NoticeBlueGnu Testing Framework +Version 2.0.3</TITLE> +<META NAME="description" CONTENT="Release NoticeBlueGnu Testing Framework +Version 2.0.3"> +<META NAME="keywords" CONTENT="READMEdvi"> +<META NAME="resource-type" CONTENT="document"> +<META NAME="distribution" CONTENT="global"> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<LINK REL="STYLESHEET" HREF="READMEdvi.css"> +</HEAD> +<BODY > + +<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" + SRC="/tools/latex2html-98.1p1/icons.gif/next_motif_gr.gif"> +<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" + SRC="/tools/latex2html-98.1p1/icons.gif/up_motif_gr.gif"> +<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" + SRC="/tools/latex2html-98.1p1/icons.gif/previous_motif_gr.gif"> <BR> +<BR> <P> + +<!--End of Navigation Panel--> + +<P> + +<P> +<H1 ALIGN="CENTER">Release Notice +<BR> +BlueGnu Testing Framework +<BR> +Version 2.0.3</H1> +<P ALIGN="CENTER"><STRONG>Jan-Willem Neurdenburg +<BR> +jotOmega dsc +<BR> +56 Brigham Hill Road +<BR> +Grafton MA 01519-1135 +<BR> +neurdenburgj@acm.org +<BR> +Tel: (508) 839-0276 +<BR> +Fax: (508) 839-7267</STRONG></P> +<P ALIGN="LEFT"></P> + +<P> + +<H1><A NAME="SECTION00010000000000000000"> +Introduction</A> +</H1> +BlueGnu is a framework for testing other programs. It has been created +to be compatible with DejaGnu. Its purpose is to provide a single +front end for all tests. Beyond this, BlueGnu offers several +advantages for testing: + +<P> +<UL> +<P> +<LI>The flexibility and consistency of the BlueGnu framework makes it +easy to write tests for any program, with the exception of GUI +applications. + +<P> +<LI>BlueGnu provides a layer of abstraction, which makes all tests +(if correctly written) portable to any host or target where a program +must be tested. + +<P> +<LI>BlueGnu is written in [incr Tcl], which in turn is based on Tcl +(Tool Command Language). The framework comprises two parts: +<DL COMPACT> +<DT>1. +<DD>the testing framework, +<DT>2. +<DD>the test-suites or test-sets themselves. +</DL> +<P> +<LI>BlueGnu will work with any Tcl based interpreter as long as +[incr Tcl] has been included. You can include 'expect', 'Tk', and/or +other extensions. + +<P> +<LI>Includes DejaGnu release 1.6 + +<P> +</UL> +<P> + +<H1><A NAME="SECTION00020000000000000000"> +Requirements</A> +</H1> +The following modules should have been installed, before you can +install and/or use BlueGnu: + +<P> +<UL> +<LI>Tcl release 8.0 or higher, +<LI>incr Tcl release 3.0 or higher. +</UL> +<P> +Any other extensions that is compatible with Tcl release 8.0 can be used +as well. + +<P> + +<H1><A NAME="SECTION00030000000000000000"> +Structure and Contents of the Release</A> +</H1> + +<P> +The root directory of the release contains the README files with +installation instructions and the files needed to build and install +this product. It also contains the executable scripts of the +BlueGnu testing framework. + +<P> +The top-level directories are listed below: + +<P> +<DL> +<DT><STRONG>lib:</STRONG> +<DD>the packages and procedures that make the BlueGnu and +DejaGnu testing framework. This also includes the default target +definition files. +<P> +<DT><STRONG>testsets:</STRONG> +<DD>the BlueGnu test-suites and test examples. It contains +the following subdirectories. + +<P> +<DL> +<DT><STRONG>BlueGnu:</STRONG> +<DD>test scripts to test the testing framework itself. +<P> +<DT><STRONG>examples:</STRONG> +<DD>test suite and test script examples. + +<P> +<DT><STRONG>config, lib, tools:</STRONG> +<DD>currently empty, but can be used for +test-set dependent configuration files, library files, and tools. +</DL> +<P> +<DT><STRONG>config:</STRONG> +<DD>currently empty. + +<P> +<DT><STRONG>doc:</STRONG> +<DD>the DejaGnu texinfo source and the documentation in +'info', 'dvi', 'ps', and 'pdf' representation, respectively +dejagnu.info*, dejagnu.dvi, dejagnu.ps, and dejagnu.pdf. A DejaGnu man +page is also available. + +<P> +It also contains +the T<SMALL>E</SMALL>X version (README.tex) of this document as well as the 'dvi', 'ps' +'html', and 'pdf' representation, respectively notice.dvi, notice.ps, +notice.html, and notice.pdf. + +<P> +<DT><STRONG>testsuite:</STRONG> +<DD>contains a mixture of DejaGnu and BlueGnu test +scripts. + +<P> +<DT><STRONG>contrib:</STRONG> +<DD>contains examples how DejaGnu is used at Cygnus. + +<P> +<DT><STRONG>example:</STRONG> +<DD>contains a full DejaGnu test framework example for testing the program 'calc' which is also included. + +<P> +</DL> +<P> + +<H1><A NAME="SECTION00040000000000000000"> +Installation and use under Unix</A> +</H1> + +<P> +Before you can install and use BlueGnu you need to have installed the +following three packages: +<UL> +<LI>Tcl version 8.0.3 +<LI>Tk version 8.0.3 +<LI>incr Tcl version 3.0.1 +</UL>The source for these packages should all be located in one directory. +The subdirectory in the directory should be: +<UL> +<LI>tcl8.0.3 +<LI>tk8.0.3 +<LI>itcl3.0.1 +</UL> +<P> +The following examples use the command `./configure +-prefix=/tools/...`. This will install all packages in a directory +``/tools''. When you omit the ``-prefix''-switch then the +installation default will be the directory ``/usr/local''. + +<P> + +<H2><A NAME="SECTION00041000000000000000"> +Installation of needed Packages</A> +</H2> + +<P> +When you have not installed Tcl and the other needed extensions, then +you need to retrieve the sources from ``www.tcltk.com/itcl''. You need +to `gunzip` the files and do a `tar xf` of all these packages in one +directory, let's call this directory ``TclTk''. + +<P> +From the directory ``TclTk'', you should do the following to install +the packages: + +<P> +<PRE> +% cd tcl8.0.3/unix +% ./configure --prefix=/tools/tcl8.0.3 --enable-gcc --enable-shared +% make +% mkdir /tools/tcl8.0.3 +% make install +% cd ../../tk8.0.3/unix +% ./configure --prefix=/tools/tk8.0.3 --enable-gcc --enable-shared +% make +% mkdir /tools/tk8.0.3 +% make install +% cd ../../itcl3.0.1 +% ./configure --prefix=/tools/itcl3.0.1 --enable-gcc --enable-shared +% make +% mkdir /tools/itcl3.0.1 +% make install +</PRE> +<P> + +<H2><A NAME="SECTION00042000000000000000"> +Installing BlueGnu</A> +</H2> +You can now `gunzip` and `tar xf` the BlueGnu version 2.0.3 in the +directory ``TckTk''. This will create the directory +``bluegnu2.0.3''. Now do the following: + +<P> +<PRE> +% cd bluegnu2.0.3 +% ./configure --prefix=/tools/bluegnu2.0.3 +% make +% mkdir /tools/bluegnu2.0.3 +% make install +</PRE> +<P> +This will install BlueGnu in the directories: +<UL> +<LI>/tools/bluegnu2.0.3/bin +<LI>/tools/bluegnu2.0.3/lib/bluegnu +<LI>/tools/bluegnu2.0.3/info +<LI>/tools/bluegnu2.0.3/man +</UL> +<P> + +<H2><A NAME="SECTION00043000000000000000"> +Using BlueGnu</A> +</H2> +When you have installed [incr Tcl] and BlueGnu and you have the +respective ``bin'' directories in your PATH variable, then you can +start running some tests. You can go into the BlueGnu source directory +``bluegnu2.0.3/testsets/examples'' and run the following: + +<P> +<PRE> +% bluegnu versionTcl.itcl +% bluegnu ts_001 +% bluegnu ts_002 +% bluegnu ts_003 +</PRE> +<P> +The above test result should all be PASS. The following test will give +a result UNKNOWN, because no pass/fail instruction have been given. + +<P> +<PRE> +% bluegnu tc001 +</PRE> +<P> +The last test you can run will fail in its simple form: + +<P> +<PRE> +% bluegnu tc002 +</PRE> +<P> +But will pass if you execute the test as follows: + +<P> +<PRE> +% bluegnu tc002[English] +</PRE> +<P> +This is because the test scripts need a test case identifier to find +the correct benchmark code. + +<P> + +<H1><A NAME="SECTION00050000000000000000"> +Changes</A> +</H1> + +<H2><A NAME="SECTION00051000000000000000"> +Version 2.0.3</A> +</H2> +This being the first public release it is not to useful to list all +the changes. BlueGnu has been modeled after DejaGnu and is a complete +new implementation which has been tested thoroughly. When +documentation is being written more changes will be made. An example +of some of these changes as a result of this documentation effort can +be found in the test-suites ts<code>_</code>001, ts<code>_</code>002, and +ts<code>_</code>003. The first two are not as easy to write as the +third. The test suite ts<code>_</code>001 is a script implementation of the +command line: +<PRE> +% cd bluegnu2.0.3/testsets +% bluegnu examples/tc002[English=B] \ +> "examples/tc002[Dutch=B]={MSG=Hallo Wereld}" +</PRE>This may be useful for simple tests but when you want to write more +complex test-suite scripts you would like some more flexibility, so two +procedures were introduced, which are shown in test-suite ts<code>_</code>002. This +makes writing rather complex so the procedures have become part of +the procedures 'appendQueue', 'prependQueue', and 'runtest'. The +resulting script is shown in test-suit ts<code>_</code>003. + +<P> +Changes like this will be made in the future! + +<P> + +<H1><A NAME="SECTION00060000000000000000"> +Future Enhancements</A> +</H1> +The following enhancements are being planned: +<UL> +<LI>Target code will be made into a class with methods 'start', +'load', 'exit', and 'version'. Instead of the current +'<target><code>_</code>start', '<target><code>_</code>load', '<target><code>_</code>exit', and +'<target><code>_</code>version', which have been taken from DejaGnu. + +<P> +<LI>Procedures will be created that make it easy to test WEB +application from the framework. + +<P> +<LI>Other enhancements will be made depending on the use of the +framework in testing different applications. +</UL> +<H1><A NAME="SECTION00070000000000000000"> + About this document ... </A> +</H1> + <STRONG>Release Notice +<BR> +BlueGnu Testing Framework +<BR> +Version 2.0.3</STRONG><P> +This document was generated using the +<A HREF="http://www-dsed.llnl.gov/files/programs/unix/latex2html/manual/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 98.1p1 release (March 2nd, 1998) +<P> +Copyright © 1993, 1994, 1995, 1996, 1997, +<A HREF="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos Drakos</A>, +Computer Based Learning Unit, University of Leeds. +<P> +The command line arguments were: <BR> + <STRONG>latex2html</STRONG> <tt>-t BlueGnu Release Notice -split 0 READMEdvi.tex</tt>. +<P> +The translation was initiated by Jan-Willem Neurdenburg on 1999-09-19<HR> +<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" + SRC="/tools/latex2html-98.1p1/icons.gif/next_motif_gr.gif"> +<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" + SRC="/tools/latex2html-98.1p1/icons.gif/up_motif_gr.gif"> +<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" + SRC="/tools/latex2html-98.1p1/icons.gif/previous_motif_gr.gif"> <BR> + +<!--End of Navigation Panel--> +<ADDRESS> +<I>Jan-Willem Neurdenburg <BR> +1999-09-19</I> +</ADDRESS> +</BODY> +</HTML> |