<!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>