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