166 |
URL="mailto:deja@welcomehome.org">Deja Snow Savoye</ulink> |
URL="mailto:deja@welcomehome.org">Deja Snow Savoye</ulink> |
167 |
(now 13 years old as of September 2003), who was a toddler |
(now 13 years old as of September 2003), who was a toddler |
168 |
during DejaGnu's beginnings.</para> |
during DejaGnu's beginnings.</para> |
169 |
|
|
170 |
<para>DejaGnu offers several advantages for testing:</para> |
<para>DejaGnu offers several advantages for testing:</para> |
171 |
|
|
172 |
<itemizedlist mark="bullet" spacing="compact"> |
<itemizedlist mark="bullet" spacing="compact"> |
214 |
|
|
215 |
<sect1 id=new xreflabel="Release Notes"> |
<sect1 id=new xreflabel="Release Notes"> |
216 |
<title>What's New In This Release</title> |
<title>What's New In This Release</title> |
217 |
|
|
218 |
<para>This release has a number of substantial changes over version |
<para>This release has a number of substantial changes over version |
219 |
1.3. The most visible change is that the version of Expect and Tcl |
1.3. The most visible change is that the version of Expect and Tcl |
220 |
included in the release are up-to-date with the current stable net |
included in the release are up-to-date with the current stable net |
253 |
|
|
254 |
<sect2 id=cygwin xreflabel="Windows Support"> |
<sect2 id=cygwin xreflabel="Windows Support"> |
255 |
<title>Windows Support</title> |
<title>Windows Support</title> |
256 |
|
|
257 |
<para>To use DejaGnu on Windows, you need to first install the |
<para>To use DejaGnu on Windows, you need to first install the |
258 |
<ulink URL="http://www.cygwin.com/">Cygwin</ulink> |
<ulink URL="http://www.cygwin.com/">Cygwin</ulink> |
259 |
release. This works as of the B20.1 release. Cygwin is a POSIX |
release. This works as of the B20.1 release. Cygwin is a POSIX |
349 |
These definitions specify the output of a test |
These definitions specify the output of a test |
350 |
case:</para> |
case:</para> |
351 |
|
|
352 |
<variablelist> |
<variablelist> |
353 |
<varlistentry> |
<varlistentry> |
354 |
<term>PASS</term> |
<term>PASS</term> |
355 |
<listitem><para>A test has succeeded. That is, it demonstrated that |
<listitem><para>A test has succeeded. That is, it demonstrated that |
356 |
the assertion is true.</para></listitem> |
the assertion is true.</para></listitem> |
357 |
</varlistentry> |
</varlistentry> |
358 |
|
|
359 |
<varlistentry> |
<varlistentry> |
360 |
<term>XFAIL</term> |
<term>XFAIL</term> |
361 |
<listitem><para>POSIX 1003.3 does not incorporate the notion of |
<listitem><para>POSIX 1003.3 does not incorporate the notion of |
365 |
<emphasis>PASS</emphasis> is in some sense more ambiguous than if |
<emphasis>PASS</emphasis> is in some sense more ambiguous than if |
366 |
<emphasis>XPASS</emphasis> is also used.</para></listitem> |
<emphasis>XPASS</emphasis> is also used.</para></listitem> |
367 |
</varlistentry> |
</varlistentry> |
368 |
|
|
369 |
<varlistentry> |
<varlistentry> |
370 |
<term>FAIL</term> |
<term>FAIL</term> |
371 |
<listitem><para>A test has produced the bug it was intended to |
<listitem><para>A test has produced the bug it was intended to |
376 |
<emphasis>FAIL</emphasis> rather than <emphasis>XFAIL</emphasis> even |
<emphasis>FAIL</emphasis> rather than <emphasis>XFAIL</emphasis> even |
377 |
if a failure was expected.</para></listitem> |
if a failure was expected.</para></listitem> |
378 |
</varlistentry> |
</varlistentry> |
379 |
|
|
380 |
<varlistentry> |
<varlistentry> |
381 |
<term>UNRESOLVED</term> |
<term>UNRESOLVED</term> |
382 |
<listitem><para>A test produced indeterminate results. Usually, this |
<listitem><para>A test produced indeterminate results. Usually, this |
426 |
</itemizedlist> |
</itemizedlist> |
427 |
|
|
428 |
<variablelist> |
<variablelist> |
429 |
<varlistentry> |
<varlistentry> |
430 |
<term>UNTESTED</term> |
<term>UNTESTED</term> |
431 |
<listitem><para>A test was not run. This is a place-holder, used |
<listitem><para>A test was not run. This is a place-holder, used |
432 |
when there is no real test case yet.</para></listitem> |
when there is no real test case yet.</para></listitem> |
438 |
conditional:</para> |
conditional:</para> |
439 |
|
|
440 |
<variablelist> |
<variablelist> |
441 |
<varlistentry> |
<varlistentry> |
442 |
<term>UNSUPPORTED</term> |
<term>UNSUPPORTED</term> |
443 |
<listitem><para>There is no support for the tested case. This may |
<listitem><para>There is no support for the tested case. This may |
444 |
mean that a conditional feature of an operating system, or of a |
mean that a conditional feature of an operating system, or of a |
448 |
test for the system subroutine <emphasis>gethostname</emphasis> |
test for the system subroutine <emphasis>gethostname</emphasis> |
449 |
would never work on a target board running only a boot |
would never work on a target board running only a boot |
450 |
monitor.</para></listitem> |
monitor.</para></listitem> |
451 |
</varlistentry> |
</varlistentry> |
452 |
</variablelist> |
</variablelist> |
453 |
|
|
454 |
<para>DejaGnu uses the same output procedures to produce these messages |
<para>DejaGnu uses the same output procedures to produce these messages |
455 |
for all testsuites and these procedures are already known to conform |
for all testsuites and these procedures are already known to conform |
456 |
to POSIX 1003.3. For a DejaGnu testsuite to conform to POSIX 1003.3, |
to POSIX 1003.3. For a DejaGnu testsuite to conform to POSIX 1003.3, |
462 |
</sect1> |
</sect1> |
463 |
|
|
464 |
</chapter> |
</chapter> |
465 |
|
|
466 |
<!-- include the user manual --> |
<!-- include the user manual --> |
467 |
&user; |
&user; |
468 |
|
|