Update with new files, and upgraded version of Doctools.

author Rob Savoye <rob@welcomehome.org>

Sat, 31 Aug 2002 05:44:56 +0000 (05:44 +0000)

committer Rob Savoye <rob@welcomehome.org>

Sat, 31 Aug 2002 05:44:56 +0000 (05:44 +0000)
author Rob Savoye <rob@welcomehome.org>
Sat, 31 Aug 2002 05:44:56 +0000 (05:44 +0000)
committer Rob Savoye <rob@welcomehome.org>
Sat, 31 Aug 2002 05:44:56 +0000 (05:44 +0000)
diff --git a/doc/overview/addboard.html b/doc/overview/addboard.html

index 786bcdf..abb532f 100644 (file)
--- a/doc/overview/addboard.html
+++ b/doc/overview/addboard.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Adding A New Board</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Board Config File Values"
  HREF="boarddefs.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="addtarget.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="boarddefs.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -108,9 +116,12 @@ CLASS="FUNCTION"
        processors.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1224"
+></A
  ><P
  ><B
->Example 4-6. Testing a New Board Config File</B
+>Example 6. Testing a New Board Config File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -146,9 +157,12 @@ CLASS="EMPHASIS"
  >, which is the Tcl execution characters.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1231"
+></A
  ><P
  ><B
->Example 4-7. Example Board Config File</B
+>Example 7. Example Board Config File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -211,7 +225,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="addtarget.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -227,7 +241,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="boarddefs.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/adding.html b/doc/overview/adding.html

index fb6ff34..99a3387 100644 (file)
--- a/doc/overview/adding.html
+++ b/doc/overview/adding.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Adding A Test Case To A Test Suite.</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Hints On Writing A Test Case"
  HREF="hints.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="debugging.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="hints.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -198,7 +206,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="debugging.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -214,7 +222,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="hints.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/addtarget.html b/doc/overview/addtarget.html

index 9de60c4..539ce69 100644 (file)
--- a/doc/overview/addtarget.html
+++ b/doc/overview/addtarget.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Adding A New Target</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Adding A New Board"
  HREF="addboard.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="addtool.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="addboard.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -158,7 +166,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="addtool.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -174,7 +182,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="addboard.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/addtool.html b/doc/overview/addtool.html

index 4f2b8a6..b12ced4 100644 (file)
--- a/doc/overview/addtool.html
+++ b/doc/overview/addtool.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Adding A New Tool</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Adding A New Target"
  HREF="addtarget.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="extending.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="addtarget.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -175,9 +183,7 @@ CLASS="FILENAME"
  > file. This will add all the Makefile
        support needed to run DejaGnu, and support the <A
  HREF="runningtests.html#MAKECHECK"
-><I
->Make Check</I
-></A
+>Make Check</A
  >
        target.</P
  ><P
@@ -192,9 +198,7 @@ CLASS="EMPHASIS"
  >, to set up the Tcl copies of
        configuration-dependent values. This is called the <A
  HREF="customizing.html#LOCAL"
-><I
->Local Config File</I
-></A
+>Local Config File</A
  >
        The check target must run the <B
  CLASS="COMMAND"
@@ -215,9 +219,12 @@ CLASS="COMMAND"
        line.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1145"
+></A
  ><P
  ><B
->Example 4-1. Sample Makefile.in Fragment</B
+>Example 1. Sample Makefile.in Fragment</B
  ></P
  ><TABLE
  BORDER="0"
@@ -333,9 +340,12 @@ CLASS="FILENAME"
           with:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1162"
+></A
  ><P
  ><B
->Example 4-2. Simple Batch Program Tool Init File</B
+>Example 2. Simple Batch Program Tool Init File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -363,9 +373,12 @@ CLASS="EMPHASIS"
           using an init file like this:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1167"
+></A
  ><P
  ><B
->Example 4-3. Simple Interactive Program Tool Init File</B
+>Example 3. Simple Interactive Program Tool Init File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -425,9 +438,12 @@ CLASS="FILENAME"
           line of Tcl code to issue a message.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1178"
+></A
  ><P
  ><B
->Example 4-4. Testing A New Tool Config</B
+>Example 4. Testing A New Tool Config</B
  ></P
  ><TABLE
  BORDER="0"
@@ -474,9 +490,12 @@ CLASS="COMMAND"
           something like this:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1189"
+></A
  ><P
  ><B
->Example 4-5. Example Test Case Run</B
+>Example 5. Example Test Case Run</B
  ></P
  ><TABLE
  BORDER="0"
@@ -531,7 +550,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="extending.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -547,7 +566,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="addtarget.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/boardconfig.html b/doc/overview/boardconfig.html

index 234e20d..b850130 100644 (file)
--- a/doc/overview/boardconfig.html
+++ b/doc/overview/boardconfig.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Board Config File</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Remote Host Testing"
  HREF="releng.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="global.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 3. Customizing DejaGnu</TD
+>Customizing DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="releng.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -74,9 +82,7 @@ NAME="BOARDCONFIG"
        are also collections of custom procedures for common environments. For
        more information on adding a new board config file, go to the <A
  HREF="addboard.html"
-><I
->Adding A New Board</I
-></A
+>Adding A New Board</A
  > chapter. </P
  ><P
  >An example board config file for a GNU simulator is as
@@ -98,9 +104,12 @@ CLASS="EMPHASIS"
        is part of your build tree.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN943"
+></A
  ><P
  ><B
->Example 3-5. Board Config File</B
+>Example 5. Board Config File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -165,9 +174,7 @@ CLASS="FUNCTION"
  >. These return the proper flags to
       compiler and link an executable image using <A
  HREF="builtins.html#LIBGLOSS"
-><I
->Libgloss</I
-></A
+>Libgloss</A
  >, the GNU BSP (Board Support Package). The final
       procedures are <TT
  CLASS="FUNCTION"
@@ -196,7 +203,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="global.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -212,7 +219,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="releng.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/boarddefs.html b/doc/overview/boarddefs.html

index 08ccbc5..76c3d18 100644 (file)
--- a/doc/overview/boarddefs.html
+++ b/doc/overview/boarddefs.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Board Config File Values</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Writing A Test Case"
  HREF="writing.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="addboard.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="writing.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -80,13 +88,20 @@ CLASS="FUNCTION"
  ><P
  ><DIV
  CLASS="TABLE"
+><A
+NAME="AEN1240"
+></A
  ><P
  ><B
->Table 4-1. Common Board Info Fields</B
+>Table 1. Common Board Info Fields</B
  ></P
  ><TABLE
  BORDER="1"
+BGCOLOR="#E0E0E0"
+CELLSPACING="0"
+CELLPADDING="4"
  CLASS="CALSTABLE"
+><THEAD
  ><TR
  ><TH
  ALIGN="LEFT"
@@ -101,6 +116,8 @@ ALIGN="LEFT"
  VALIGN="TOP"
  >Description</TH
  ></TR
+></THEAD
+><TBODY
  ><TR
  ><TD
  ALIGN="LEFT"
@@ -328,6 +345,7 @@ ALIGN="LEFT"
  VALIGN="TOP"
  >Additional link flags, rarely used.</TD
  ></TR
+></TBODY
  ></TABLE
  ></DIV
  >
@@ -341,13 +359,20 @@ VALIGN="TOP"
  ><P
  ><DIV
  CLASS="TABLE"
+><A
+NAME="AEN1316"
+></A
  ><P
  ><B
->Table 4-2. Board Info Fields For GCC &#38; GDB</B
+>Table 2. Board Info Fields For GCC &#38; GDB</B
  ></P
  ><TABLE
  BORDER="1"
+BGCOLOR="#E0E0E0"
+CELLSPACING="0"
+CELLPADDING="4"
  CLASS="CALSTABLE"
+><THEAD
  ><TR
  ><TH
  ALIGN="LEFT"
@@ -362,6 +387,8 @@ ALIGN="LEFT"
  VALIGN="TOP"
  >Description</TH
  ></TR
+></THEAD
+><TBODY
  ><TR
  ><TD
  ALIGN="LEFT"
@@ -818,6 +845,7 @@ VALIGN="TOP"
  ><TD
  >&nbsp;</TD
  ></TR
+></TBODY
  ></TABLE
  ></DIV
  >
@@ -839,7 +867,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="addboard.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -855,7 +883,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="writing.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/book1.html b/doc/overview/book1.html

index 9fa0814..e4a9d01 100644 (file)
--- a/doc/overview/book1.html
+++ b/doc/overview/book1.html
@@ -1,14 +1,22 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >DejaGnu</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="NEXT"
  TITLE="Abstract"
  HREF="preface.html"></HEAD
  ><BODY
+CLASS="BOOK"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="BOOK"
  ><A
@@ -27,7 +35,10 @@ CLASS="SUBTITLE"
  >The GNU Testing Framework</H2
  ><H3
  CLASS="AUTHOR"
->Rob Savoye</H3
+><A
+NAME="AEN9"
+>Rob Savoye</A
+></H3
  ><DIV
  CLASS="AFFILIATION"
  ><SPAN
@@ -36,10 +47,10 @@ CLASS="ORGNAME"
  ></DIV
  ><P
  CLASS="COPYRIGHT"
->Copyright &copy; 2001 by <SPAN
-CLASS="HOLDER"
->Free Software Foundation, Inc.</SPAN
-></P
+>Copyright &copy; 2002 by Free Software Foundation, Inc.</P
+><SPAN
+CLASS="RELEASEINFO"
+> New release<BR></SPAN
  ><HR></DIV
  ><DIV
  CLASS="TOC"
@@ -54,7 +65,7 @@ HREF="preface.html"
  >Abstract</A
  ></DT
  ><DT
->1. <A
+><A
  HREF="overview.html"
  >Overview</A
  ></DT
@@ -92,7 +103,127 @@ HREF="posix.html"
  ></DL
  ></DD
  ><DT
->2. <A
+><A
+HREF="gettingup.html"
+>Getting DejaGnu up and running</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="gettingup.html#AEN210"
+>Test your installation</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="gettingup.html#AEN220"
+>Windows</A
+></DT
+><DT
+><A
+HREF="gettingup.html#AEN224"
+>Getting the source code for the calc example</A
+></DT
+></DL
+></DD
+><DT
+><A
+HREF="x227.html"
+>Create a minimal project, e.g. calc</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="x227.html#AEN230"
+>A simple project without the GNU autotools</A
+></DT
+><DT
+><A
+HREF="x227.html#AEN235"
+>Using autoconf/autoheader/automake</A
+></DT
+></DL
+></DD
+><DT
+><A
+HREF="x276.html"
+>Our first automated tests</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="x276.html#AEN278"
+>Running the test for the calc example</A
+></DT
+><DT
+><A
+HREF="x276.html#AEN286"
+>The various config files or how to avoid warnings</A
+></DT
+><DT
+><A
+HREF="x276.html#AEN303"
+>When trouble strikes</A
+></DT
+><DT
+><A
+HREF="x276.html#AEN312"
+>Testing &#8220;Hello world&#8221; locally</A
+></DT
+></DL
+></DD
+><DT
+><A
+HREF="x319.html"
+>A first remote test</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="x319.html#AEN322"
+>Setup telnet to your own host</A
+></DT
+><DT
+><A
+HREF="x319.html#AEN331"
+>A test case for login via telnet</A
+></DT
+><DT
+><A
+HREF="x319.html#AEN357"
+>Remote testing &#8220;Hello world&#8221;</A
+></DT
+><DT
+><A
+HREF="x319.html#AEN372"
+>Transferring files from/to the target</A
+></DT
+><DT
+><A
+HREF="x319.html#AEN382"
+>Preparing for crosscompilation</A
+></DT
+><DT
+><A
+HREF="x319.html#AEN393"
+>Remote testing of calc</A
+></DT
+><DT
+><A
+HREF="x319.html#AEN396"
+>Using WindowsNT as host and vxWorks as target</A
+></DT
+></DL
+></DD
+></DL
+></DD
+><DT
+><A
  HREF="runningtests.html"
  >Running Tests</A
  ></DT
@@ -154,7 +285,7 @@ HREF="outputfiles.html#DEBUGFILE"
  ></DL
  ></DD
  ><DT
->3. <A
+><A
  HREF="customizing.html"
  >Customizing DejaGnu</A
  ></DT
@@ -202,7 +333,7 @@ HREF="configfile.html#PERSONAL"
  ></DL
  ></DD
  ><DT
->4. <A
+><A
  HREF="extending.html"
  >Extending DejaGnu</A
  ></DT
@@ -261,7 +392,26 @@ HREF="tvariables.html"
  ></DL
  ></DD
  ><DT
->5. <A
+><A
+HREF="unit.html"
+>Unit Testing</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="unit.html#UNITTEST"
+>What Is Unit Testing ?</A
+></DT
+><DT
+><A
+HREF="djh.html"
+>The dejagnu.h Header File</A
+></DT
+></DL
+></DD
+><DT
+><A
  HREF="reference.html"
  >Reference</A
  ></DT
@@ -352,6 +502,83 @@ HREF="filemap.html"
  ></DT
  ></DL
  ></DD
+><DT
+><A
+HREF="unittestapi.html"
+>Unit Testing API</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="unittestapi.html#CUNIT"
+>C Unit Testing API</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="unittestapi.html#PASSFUNC"
+>Pass Function</A
+></DT
+><DT
+><A
+HREF="unittestapi.html#FAILFUNC"
+>Fail Function</A
+></DT
+><DT
+><A
+HREF="unittestapi.html#UNTESTEDFUNC"
+>Untested Function</A
+></DT
+><DT
+><A
+HREF="unittestapi.html#UNRESOLVEDFUNC"
+>Unresolved Function</A
+></DT
+><DT
+><A
+HREF="unittestapi.html#TOTALSFUNC"
+>Totals Function</A
+></DT
+></DL
+></DD
+><DT
+><A
+HREF="cppunit.html"
+>C++ Unit Testing API</A
+></DT
+><DD
+><DL
+><DT
+><A
+HREF="cppunit.html#PASSMETH"
+>Pass Method</A
+></DT
+><DT
+><A
+HREF="cppunit.html#FAILMETH"
+>Fail Method</A
+></DT
+><DT
+><A
+HREF="cppunit.html#UNTESTEDMETH"
+>Untested Method</A
+></DT
+><DT
+><A
+HREF="cppunit.html#UNRESOLVEDMETH"
+>Unresolved Method</A
+></DT
+><DT
+><A
+HREF="cppunit.html#TOTALSMETH"
+>Totals Method</A
+></DT
+></DL
+></DD
+></DL
+></DD
  ></DL
  ></DIV
  ></DIV
@@ -381,7 +608,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="preface.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/builtins.html b/doc/overview/builtins.html

index dce635a..bb8b668 100644 (file)
--- a/doc/overview/builtins.html
+++ b/doc/overview/builtins.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Builtin Procedures</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="File Map"
  HREF="filemap.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="installation.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 5. Reference</TD
+>Reference</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="filemap.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -86,22 +94,29 @@ NAME="MAILFILE"
  ></H3
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1662"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->mail_file</B
+><TT
+CLASS="FUNCTION"
+>mail_file</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file to subject</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file to subject</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -116,6 +131,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -128,17 +144,22 @@ NAME="OPENLOGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1676"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->open_logs</B
+><TT
+CLASS="FUNCTION"
+>open_logs</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -155,17 +176,22 @@ NAME="CLOSELOGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1684"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->close_logs</B
+><TT
+CLASS="FUNCTION"
+>close_logs</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -199,22 +225,29 @@ CLASS="EMPHASIS"
           configuration.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1695"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->isbuild</B
+><TT
+CLASS="FUNCTION"
+>isbuild</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->pattern</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -229,6 +262,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -241,22 +275,29 @@ NAME="ISREMOTE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1709"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->is_remote</B
+><TT
+CLASS="FUNCTION"
+>is_remote</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->board</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>board</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -271,6 +312,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -292,17 +334,22 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1725"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->is3way</B
+><TT
+CLASS="FUNCTION"
+>is3way</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -334,22 +381,29 @@ CLASS="EMPHASIS"
           characters, using shell syntax, to specify sets of names).</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1736"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->ishost</B
+><TT
+CLASS="FUNCTION"
+>ishost</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->pattern</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -364,6 +418,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -393,22 +448,29 @@ CLASS="EMPHASIS"
           build canonical configuration.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1753"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->istarget</B
+><TT
+CLASS="FUNCTION"
+>istarget</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -423,6 +485,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -444,17 +507,22 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1769"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->isnative</B
+><TT
+CLASS="FUNCTION"
+>isnative</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -471,22 +539,29 @@ NAME="UNKNOWN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1777"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unknown</B
+><TT
+CLASS="FUNCTION"
+>unknown</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -501,6 +576,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -513,22 +589,29 @@ NAME="CLONEOUTPUT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1791"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->clone_output</B
+><TT
+CLASS="FUNCTION"
+>clone_output</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->message</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>message</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -543,6 +626,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -555,17 +639,22 @@ NAME="RESETVARS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1805"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->reset_vars</B
+><TT
+CLASS="FUNCTION"
+>reset_vars</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -582,17 +671,22 @@ NAME="LOGANDEXIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1813"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->log_and_exit</B
+><TT
+CLASS="FUNCTION"
+>log_and_exit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -609,22 +703,29 @@ NAME="LOGSUMMARY"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1821"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->log_summary</B
+><TT
+CLASS="FUNCTION"
+>log_summary</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -639,6 +740,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -651,17 +753,22 @@ NAME="CLEANUP"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1835"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->cleanup</B
+><TT
+CLASS="FUNCTION"
+>cleanup</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -717,18 +824,20 @@ CLASS="WARNING"
  ></P
  ><TABLE
  CLASS="WARNING"
-BORDER="1"
  WIDTH="100%"
+BORDER="0"
  ><TR
  ><TD
+WIDTH="25"
  ALIGN="CENTER"
-><B
->Warning</B
-></TD
-></TR
-><TR
+VALIGN="TOP"
+><IMG
+SRC="./stylesheet-images/warning.gif"
+HSPACE="5"
+ALT="Warning"></TD
  ><TD
  ALIGN="LEFT"
+VALIGN="TOP"
  ><P
  >Warning you must clear the expected failure after
           using setup_xfail in a test case.  Any call to <TT
@@ -753,26 +862,35 @@ CLASS="FUNCTION"
  ></DIV
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1856"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->setup_xfail</B
+><TT
+CLASS="FUNCTION"
+>setup_xfail</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->config</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>config</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->bugid</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>bugid</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -800,6 +918,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -812,30 +931,41 @@ NAME="RECORDTEST"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1876"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->record_test</B
+><TT
+CLASS="FUNCTION"
+>record_test</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->type</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->message</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>message</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -872,6 +1002,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -902,22 +1033,29 @@ CLASS="PARAMETER"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1906"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->pass</B
+><TT
+CLASS="FUNCTION"
+>pass</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -933,6 +1071,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -963,22 +1102,29 @@ CLASS="PARAMETER"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1924"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->fail</B
+><TT
+CLASS="FUNCTION"
+>fail</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -994,6 +1140,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1025,22 +1172,29 @@ CLASS="PARAMETER"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1942"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->xpass</B
+><TT
+CLASS="FUNCTION"
+>xpass</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1056,6 +1210,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1087,22 +1242,29 @@ CLASS="PARAMETER"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1960"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->xpass</B
+><TT
+CLASS="FUNCTION"
+>xpass</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1118,6 +1280,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1152,22 +1315,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1980"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->set_warning_threshold</B
+><TT
+CLASS="FUNCTION"
+>set_warning_threshold</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->threshold</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>threshold</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1183,6 +1353,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1207,17 +1378,22 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN1997"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->get_warning_threshold</B
+><TT
+CLASS="FUNCTION"
+>get_warning_threshold</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -1299,27 +1475,36 @@ CLASS="EMPHASIS"
         known side effects.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2020"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->warning</B
+><TT
+CLASS="FUNCTION"
+>warning</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->number</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>number</I
+></TT
  >
             );<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1355,6 +1540,7 @@ CLASS="EMPHASIS"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1412,27 +1598,36 @@ CLASS="EMPHASIS"
         errors with no known side effects.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2053"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->perror</B
+><TT
+CLASS="FUNCTION"
+>perror</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->number</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>number</I
+></TT
  >
             );<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1468,6 +1663,7 @@ CLASS="EMPHASIS"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1506,22 +1702,29 @@ CLASS="FUNCTION"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2081"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->note</B
+><TT
+CLASS="FUNCTION"
+>note</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1536,6 +1739,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1561,22 +1765,29 @@ CLASS="EMPHASIS"
         does not yet exist for some feature.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2098"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->untested</B
+><TT
+CLASS="FUNCTION"
+>untested</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1592,6 +1803,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1618,22 +1830,29 @@ CLASS="EMPHASIS"
         determine if it passed or failed (and to improve the test case).</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2115"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unresolved</B
+><TT
+CLASS="FUNCTION"
+>unresolved</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1649,6 +1868,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1670,22 +1890,29 @@ CLASS="EMPHASIS"
  >, appending the argument string.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2131"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unsupported</B
+><TT
+CLASS="FUNCTION"
+>unsupported</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->string</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1701,6 +1928,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1713,17 +1941,22 @@ NAME="INITTESTCOUNTS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2145"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->init_testcounts</B
+><TT
+CLASS="FUNCTION"
+>init_testcounts</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -1740,26 +1973,35 @@ NAME="INCRCOUNT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2153"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->incr_count</B
+><TT
+CLASS="FUNCTION"
+>incr_count</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->name</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1785,6 +2027,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1817,22 +2060,29 @@ CLASS="COMMAND"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2177"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->transform</B
+><TT
+CLASS="FUNCTION"
+>transform</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->toolname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>toolname</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1848,6 +2098,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -1905,34 +2156,47 @@ CLASS="EMPHASIS"
           false.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2198"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->check_conditional_xfail</B
+><TT
+CLASS="FUNCTION"
+>check_conditional_xfail</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->message</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>message</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->targets</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>targets</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->includes</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>includes</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->excludes</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>excludes</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -1987,11 +2251,15 @@ CLASS="PARAMETER"
             match) then this conditional is de-activated.</P
  ></DD
  ></DL
+></DIV
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN2227"
+></A
  ><P
  ><B
->Example 5-1. Specifying the conditional xfail data</B
+>Example 1. Specifying the conditional xfail data</B
  ></P
  ><TABLE
  BORDER="0"
@@ -2058,22 +2326,29 @@ CLASS="COMMAND"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2240"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->clear_xfail</B
+><TT
+CLASS="FUNCTION"
+>clear_xfail</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->config</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>config</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2089,6 +2364,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2116,55 +2392,91 @@ CLASS="EMPHASIS"
  CLASS="OPTION"
  >-log</TT
  > argument to cause string to always
-         be added to the log file, even if it won't be printed.  Use the
-         optional <TT
+          be added to the log file, even if it won't be printed.  Use the
+          optional <TT
+CLASS="OPTION"
+>-x</TT
+> argument to log the test results into
+          a parsable XML file.  Use the optional <TT
  CLASS="OPTION"
  >-n</TT
-> argument to print string without a
-         trailing newline.  Use the optional <TT
+> argument
+          to print string without a trailing newline.  Use the optional
+          <TT
  CLASS="OPTION"
  >--</TT
-> argument if
-         string begins with "-".</P
+> argument if string begins with "-".</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2261"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->verbose</B
+><TT
+CLASS="FUNCTION"
+>verbose</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->-log</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>-log</I
+></TT
+>
+            <TT
+CLASS="PARAMETER"
+><I
+>-x</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->-n</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>-n</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->-r</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>-r</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->string</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->number</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>number</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
  CLASS="PARAMETER"
  ><I
+>-x</I
+></TT
+></DT
+><DD
+><P
+></P
+></DD
+><DT
+><TT
+CLASS="PARAMETER"
+><I
  >-log</I
  ></TT
  ></DT
@@ -2218,6 +2530,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2244,22 +2557,29 @@ CLASS="FILENAME"
           earlier ones.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2307"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->load_lib</B
+><TT
+CLASS="FUNCTION"
+>load_lib</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->filespec</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>filespec</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2276,6 +2596,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -2339,34 +2660,47 @@ NAME="CALLREMOTE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2333"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->call_remote</B
+><TT
+CLASS="FUNCTION"
+>call_remote</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->type</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->proc</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>proc</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->dest</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2403,6 +2737,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2415,22 +2750,29 @@ NAME="CHECKFORBOARDSTATUS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2360"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->check_for_board_status</B
+><TT
+CLASS="FUNCTION"
+>check_for_board_status</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->variable</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>variable</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2445,6 +2787,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2457,30 +2800,41 @@ NAME="FILEONBUILD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2374"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->file_on_build</B
+><TT
+CLASS="FUNCTION"
+>file_on_build</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->op</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>op</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2517,6 +2871,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2529,30 +2884,41 @@ NAME="FILEONHOST"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2400"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->file_on_host</B
+><TT
+CLASS="FUNCTION"
+>file_on_host</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->op</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>op</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2589,6 +2955,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2601,34 +2968,47 @@ NAME="LOCALEXEC"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2426"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->local_exec</B
-></CODE
->(<VAR
-CLASS="PDPARAM"
->commandline</VAR
+><TT
+CLASS="FUNCTION"
+>local_exec</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>commandline</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->inp</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>inp</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->outp</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>outp</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->timeout</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>timeout</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2665,6 +3045,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2677,22 +3058,29 @@ NAME="REMOTEBINARY"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2453"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_binary</B
+><TT
+CLASS="FUNCTION"
+>remote_binary</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2707,6 +3095,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2719,22 +3108,29 @@ NAME="REMOTECLOSE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2467"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_close</B
+><TT
+CLASS="FUNCTION"
+>remote_close</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->shellid</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>shellid</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2763,6 +3159,7 @@ CLASS="SYMBOL"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2775,30 +3172,41 @@ NAME="REMOTEDOWNLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2484"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_download</B
+><TT
+CLASS="FUNCTION"
+>remote_download</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2835,6 +3243,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2847,30 +3256,41 @@ NAME="REMOTEEXEC"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2510"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_exec</B
+><TT
+CLASS="FUNCTION"
+>remote_exec</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->program</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>program</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2907,6 +3327,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2919,30 +3340,41 @@ NAME="REMOTEEXPECT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2536"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_expect</B
+><TT
+CLASS="FUNCTION"
+>remote_expect</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->board</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>board</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->timeout</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>timeout</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -2979,6 +3411,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -2991,26 +3424,35 @@ NAME="REMOTEFILE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2562"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_file</B
+><TT
+CLASS="FUNCTION"
+>remote_file</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3036,6 +3478,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3048,26 +3491,35 @@ NAME="REMOTELD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2582"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_ld</B
+><TT
+CLASS="FUNCTION"
+>remote_ld</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->prog</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>prog</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3093,6 +3545,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3105,30 +3558,41 @@ NAME="REMOTELOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2602"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_load</B
+><TT
+CLASS="FUNCTION"
+>remote_load</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->prog</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>prog</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3165,6 +3629,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3177,22 +3642,29 @@ NAME="REMOTEOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2628"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_open</B
+><TT
+CLASS="FUNCTION"
+>remote_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->type</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3240,6 +3712,7 @@ CLASS="SYMBOL"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3252,22 +3725,29 @@ NAME="REMOTEPOPCONN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2649"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_pop_conn</B
+><TT
+CLASS="FUNCTION"
+>remote_pop_conn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3282,6 +3762,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3294,22 +3775,29 @@ NAME="REMOTEPUSHCONN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2663"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_push_conn</B
+><TT
+CLASS="FUNCTION"
+>remote_push_conn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3324,6 +3812,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3336,22 +3825,29 @@ NAME="REMOTERAWBINARY"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2677"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_binary</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_binary</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3366,6 +3862,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3378,22 +3875,29 @@ NAME="REMOTERAWCLOSE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2691"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_close</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_close</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3408,6 +3912,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3420,26 +3925,35 @@ NAME="REMOTERAWFILE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2705"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_file</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_file</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3465,6 +3979,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3477,26 +3992,35 @@ NAME="REMOTERAWLD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2725"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_ld</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_ld</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->prog</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>prog</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3522,6 +4046,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3534,30 +4059,41 @@ NAME="REMOTERAWLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2745"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_load</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_load</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->prog</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>prog</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3594,6 +4130,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3606,22 +4143,29 @@ NAME="REMOTERAWOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2771"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_open</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3636,6 +4180,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3648,26 +4193,35 @@ NAME="REMOTERAWSEND"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2785"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_send</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_send</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->string</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3693,6 +4247,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3705,26 +4260,35 @@ NAME="REMOTERAWSPAWN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2805"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_spawn</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_spawn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->commandline</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>commandline</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3750,6 +4314,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3762,26 +4327,35 @@ NAME="REMOTERAWTRANSMIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2825"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_transmit</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_transmit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3807,6 +4381,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3819,26 +4394,35 @@ NAME="REMOTERAWWAIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2845"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_raw_wait</B
+><TT
+CLASS="FUNCTION"
+>remote_raw_wait</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->timeout</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>timeout</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3864,6 +4448,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3876,22 +4461,29 @@ NAME="REMOTEREBOOT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2865"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_reboot</B
+><TT
+CLASS="FUNCTION"
+>remote_reboot</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3906,6 +4498,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3918,26 +4511,35 @@ NAME="REMOTESEND"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2879"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_send</B
+><TT
+CLASS="FUNCTION"
+>remote_send</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->string</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -3963,6 +4565,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -3975,30 +4578,41 @@ NAME="REMOTESPAWN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2899"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_spawn</B
+><TT
+CLASS="FUNCTION"
+>remote_spawn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->commandline</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>commandline</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4035,6 +4649,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4047,22 +4662,29 @@ NAME="REMOTESWAPCONN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2925"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_swap_conn</B
+><TT
+CLASS="FUNCTION"
+>remote_swap_conn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4077,6 +4699,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4089,26 +4712,35 @@ NAME="REMOTETRANSMIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2939"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_transmit</B
+><TT
+CLASS="FUNCTION"
+>remote_transmit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4134,6 +4766,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4146,30 +4779,41 @@ NAME="REMOTEUPLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2959"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_upload</B
+><TT
+CLASS="FUNCTION"
+>remote_upload</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->srcfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>srcfile</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->arg</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>arg</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4206,6 +4850,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4218,26 +4863,35 @@ NAME="REMOTEWAIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN2985"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->remote_wait</B
+><TT
+CLASS="FUNCTION"
+>remote_wait</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->timeout</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>timeout</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4263,6 +4917,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4275,22 +4930,29 @@ NAME="STANDARDCLOSE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3005"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_close</B
+><TT
+CLASS="FUNCTION"
+>standard_close</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4305,6 +4967,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4317,30 +4980,41 @@ NAME="STANDARDDOWNLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3019"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_download</B
+><TT
+CLASS="FUNCTION"
+>standard_download</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->destfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4377,6 +5051,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4389,26 +5064,35 @@ NAME="STANDARDEXEC"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3045"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_exec</B
+><TT
+CLASS="FUNCTION"
+>standard_exec</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4434,6 +5118,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4446,28 +5131,39 @@ NAME="STANDARDFILE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3065"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_file</B
+><TT
+CLASS="FUNCTION"
+>standard_file</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
->, <VAR
-CLASS="PDPARAM"
->op</VAR
->, <VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
+><TT
+CLASS="PARAMETER"
+><I
+>op</I
+></TT
+><TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4482,6 +5178,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4494,30 +5191,41 @@ NAME="STANDARDLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3081"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_load</B
+><TT
+CLASS="FUNCTION"
+>standard_load</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->prog</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>prog</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4554,6 +5262,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4566,22 +5275,29 @@ NAME="STANDARDREBOOT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3107"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_reboot</B
+><TT
+CLASS="FUNCTION"
+>standard_reboot</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4596,6 +5312,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4608,26 +5325,35 @@ NAME="STANDARDSEND"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3121"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_send</B
+><TT
+CLASS="FUNCTION"
+>standard_send</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->string</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>string</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4653,6 +5379,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4665,26 +5392,35 @@ NAME="STANDARDSPAWN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3141"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_spawn</B
+><TT
+CLASS="FUNCTION"
+>standard_spawn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->commandline</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>commandline</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4710,6 +5446,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4722,26 +5459,35 @@ NAME="STANDARDTRANSMIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3161"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_transmit</B
+><TT
+CLASS="FUNCTION"
+>standard_transmit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4767,6 +5513,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4779,22 +5526,29 @@ NAME="STANDARDUPLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3181"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_upload</B
+><TT
+CLASS="FUNCTION"
+>standard_upload</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest srcfile destfile</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest srcfile destfile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4831,6 +5585,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4843,26 +5598,35 @@ NAME="STANDARDWAIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3205"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->standard_wait</B
+><TT
+CLASS="FUNCTION"
+>standard_wait</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->timeout</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>timeout</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4888,6 +5652,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -4900,26 +5665,35 @@ NAME="UNIXCLEANFILENAME"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3225"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unix_clean_filename</B
+><TT
+CLASS="FUNCTION"
+>unix_clean_filename</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -4946,6 +5720,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -4968,37 +5743,49 @@ NAME="TELNET"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3248"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->telnet</B
+><TT
+CLASS="FUNCTION"
+>telnet</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->port</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>port</I
+></TT
  >);<P
  ></P
  ></DIV
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3254"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rlogin</B
+><TT
+CLASS="FUNCTION"
+>rlogin</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >);<P
  ></P
  ></DIV
@@ -5015,22 +5802,29 @@ NAME="RSH"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3262"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rsh</B
+><TT
+CLASS="FUNCTION"
+>rsh</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5083,6 +5877,7 @@ CLASS="SYMBOL"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5095,22 +5890,29 @@ NAME="TIP"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3283"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->tip</B
+><TT
+CLASS="FUNCTION"
+>tip</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->port</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>port</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5179,6 +5981,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5191,26 +5994,35 @@ NAME="KERMIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3309"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->kermit</B
+><TT
+CLASS="FUNCTION"
+>kermit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->port</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>port</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->bps</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>bps</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5284,6 +6096,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5296,26 +6109,35 @@ NAME="KERMITOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3339"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->kermit_open</B
+><TT
+CLASS="FUNCTION"
+>kermit_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5341,6 +6163,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5353,26 +6176,35 @@ NAME="KERMITCOMMAND"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3359"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->kermit_command</B
+><TT
+CLASS="FUNCTION"
+>kermit_command</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5398,6 +6230,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5410,22 +6243,29 @@ NAME="KERMITSEND"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3379"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->kermit_send</B
+><TT
+CLASS="FUNCTION"
+>kermit_send</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest string args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest string args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5462,6 +6302,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5474,30 +6315,41 @@ NAME="KERMITTRANSMIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3403"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->kermit_transmit</B
+><TT
+CLASS="FUNCTION"
+>kermit_transmit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5534,6 +6386,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5546,26 +6399,35 @@ NAME="TELNETOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3429"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->telnet_open</B
+><TT
+CLASS="FUNCTION"
+>telnet_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5591,6 +6453,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5603,22 +6466,29 @@ NAME="TELNETBINARY"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3449"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->telnet_binary</B
+><TT
+CLASS="FUNCTION"
+>telnet_binary</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5633,6 +6503,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5645,30 +6516,41 @@ NAME="TELNETTRANSMIT"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3463"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->telnet_transmit</B
+><TT
+CLASS="FUNCTION"
+>telnet_transmit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->file</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5705,6 +6587,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5717,22 +6600,29 @@ NAME="TIPOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3489"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->tip_open</B
+><TT
+CLASS="FUNCTION"
+>tip_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5747,6 +6637,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5759,22 +6650,29 @@ NAME="RLOGINOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3503"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rlogin_open</B
+><TT
+CLASS="FUNCTION"
+>rlogin_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->arg</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>arg</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5789,6 +6687,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5801,26 +6700,35 @@ NAME="RLOGINSPAWN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3517"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rlogin_spawn</B
+><TT
+CLASS="FUNCTION"
+>rlogin_spawn</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->dest</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>dest</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->cmdline</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>cmdline</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5846,6 +6754,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5858,22 +6767,29 @@ NAME="RSHOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3537"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rsh_open</B
+><TT
+CLASS="FUNCTION"
+>rsh_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->hostname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>hostname</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5888,6 +6804,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5900,30 +6817,41 @@ NAME="RSHDOWNLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3551"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rsh_download</B
+><TT
+CLASS="FUNCTION"
+>rsh_download</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->desthost</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>desthost</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->srcfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>srcfile</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->destfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -5960,6 +6888,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -5972,30 +6901,41 @@ NAME="RSHUPLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3577"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rsh_upload</B
+><TT
+CLASS="FUNCTION"
+>rsh_upload</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->desthost</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>desthost</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->srcfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>srcfile</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->destfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6032,6 +6972,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6044,30 +6985,41 @@ NAME="RSHEXEC"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3603"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->rsh_exec</B
+><TT
+CLASS="FUNCTION"
+>rsh_exec</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->boardname</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>boardname</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->cmd</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>cmd</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->args</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6104,6 +7056,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6116,22 +7069,29 @@ NAME="FTPOPEN"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3629"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->ftp_open</B
+><TT
+CLASS="FUNCTION"
+>ftp_open</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6146,6 +7106,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6158,30 +7119,41 @@ NAME="FTPUPLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3643"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->ftp_upload</B
+><TT
+CLASS="FUNCTION"
+>ftp_upload</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->remotefile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>remotefile</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->localfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>localfile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6218,6 +7190,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6230,30 +7203,41 @@ NAME="FTPDOWNLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3669"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->ftp_download</B
+><TT
+CLASS="FUNCTION"
+>ftp_download</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->localfile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>localfile</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->remotefile</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>remotefile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6290,6 +7274,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6302,22 +7287,29 @@ NAME="FTPCLOSE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3695"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->ftp_close</B
+><TT
+CLASS="FUNCTION"
+>ftp_close</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->host</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>host</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6332,6 +7324,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6344,26 +7337,35 @@ NAME="TIPDOWNLOAD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3709"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->tip_download</B
+><TT
+CLASS="FUNCTION"
+>tip_download</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->spawnid</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>spawnid</I
+></TT
  >
-              <VAR
-CLASS="PDPARAM"
->file</VAR
+              <TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6417,6 +7419,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -6439,34 +7442,47 @@ NAME="DEFAULTLINK"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3738"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->default_link</B
+><TT
+CLASS="FUNCTION"
+>default_link</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->board</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>board</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->objects</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>objects</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->destfile</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->flags</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>flags</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6514,6 +7530,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6526,30 +7543,41 @@ NAME="DEFAULTTARGETASSEMBLE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3770"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->default_target_assemble</B
+><TT
+CLASS="FUNCTION"
+>default_target_assemble</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->source</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>source</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->destfile</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->flags</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>flags</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6586,6 +7614,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6598,34 +7627,47 @@ NAME="DEFAULTTARGETCOMPILE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3796"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->default_target_compile</B
+><TT
+CLASS="FUNCTION"
+>default_target_compile</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->source</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>source</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->destfile</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->type</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->options</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>options</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6673,6 +7715,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6685,22 +7728,29 @@ NAME="POPCONFIG"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3828"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->pop_config</B
+><TT
+CLASS="FUNCTION"
+>pop_config</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->type</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6715,6 +7765,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6727,22 +7778,29 @@ NAME="PRUNEWARNINGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3842"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->prune_warnings</B
+><TT
+CLASS="FUNCTION"
+>prune_warnings</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->text</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>text</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6757,6 +7815,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6769,22 +7828,29 @@ NAME="PUSHBUILD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3856"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->push_build</B
+><TT
+CLASS="FUNCTION"
+>push_build</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->name</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6799,6 +7865,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6811,26 +7878,35 @@ NAME="PUSHCONFIG"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3870"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->push_config</B
+><TT
+CLASS="FUNCTION"
+>push_config</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->type</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->name</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6856,6 +7932,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6868,17 +7945,22 @@ NAME="REBOOTTARGET"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3890"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->reboot_target</B
+><TT
+CLASS="FUNCTION"
+>reboot_target</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -6895,22 +7977,29 @@ NAME="TARGETASSEMBLE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3898"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->target_assemble</B
+><TT
+CLASS="FUNCTION"
+>target_assemble</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->source destfile flags</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>source destfile flags</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -6947,6 +8036,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -6959,34 +8049,47 @@ NAME="TARGETCOMPILE"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3922"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->target_compile</B
+><TT
+CLASS="FUNCTION"
+>target_compile</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->source</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>source</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->destfile</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>destfile</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->type</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->options</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>options</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7035,6 +8138,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -7055,30 +8159,41 @@ NAME="BOARDINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3956"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->board_info</B
+><TT
+CLASS="FUNCTION"
+>board_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->machine</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>machine</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->op</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>op</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->args</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7115,6 +8230,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7127,26 +8243,35 @@ NAME="HOSTINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN3982"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->host_info</B
+><TT
+CLASS="FUNCTION"
+>host_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->op</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>op</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->args</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7172,6 +8297,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7184,26 +8310,35 @@ NAME="SETBOARDINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4002"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->set_board_info</B
+><TT
+CLASS="FUNCTION"
+>set_board_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->entry</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>entry</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->value</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>value</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7229,6 +8364,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7241,26 +8377,35 @@ NAME="SETCURRTARGETINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4022"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->set_currtarget_info</B
+><TT
+CLASS="FUNCTION"
+>set_currtarget_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->entry</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>entry</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->value</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>value</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7286,6 +8431,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7298,26 +8444,35 @@ NAME="TARGETINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4042"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->target_info</B
+><TT
+CLASS="FUNCTION"
+>target_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->op</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>op</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->args</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7343,6 +8498,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7355,22 +8511,29 @@ NAME="UNSETBOARDINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4062"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unset_board_info</B
+><TT
+CLASS="FUNCTION"
+>unset_board_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->entry</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>entry</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7385,6 +8548,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7397,22 +8561,29 @@ NAME="UNSETCURRTARGETINFO"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4076"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unset_currtarget_info</B
+><TT
+CLASS="FUNCTION"
+>unset_currtarget_info</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->entry</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>entry</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7427,6 +8598,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7451,22 +8623,29 @@ CLASS="SYMBOL"
           the global config file.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4093"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->push_target</B
+><TT
+CLASS="FUNCTION"
+>push_target</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->name</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7482,6 +8661,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7494,17 +8674,22 @@ NAME="POPTARGET"
  >This unsets the current target connection.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4107"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->pop_target</B
+><TT
+CLASS="FUNCTION"
+>pop_target</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -7522,17 +8707,22 @@ NAME="LISTTARGETS"
           architecture.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4115"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->list_targets</B
+><TT
+CLASS="FUNCTION"
+>list_targets</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -7562,22 +8752,29 @@ CLASS="SYMBOL"
           file.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4126"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->push_host</B
+><TT
+CLASS="FUNCTION"
+>push_host</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->name</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7592,6 +8789,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7604,17 +8802,22 @@ NAME="POPHOST"
  >This unsets the current host connection.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4140"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->pop_host</B
+><TT
+CLASS="FUNCTION"
+>pop_host</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -7654,22 +8857,29 @@ CLASS="COMMAND"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4153"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->compile</B
+><TT
+CLASS="FUNCTION"
+>compile</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7684,6 +8894,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7710,22 +8921,29 @@ CLASS="COMMAND"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4170"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->archive</B
+><TT
+CLASS="FUNCTION"
+>archive</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7740,6 +8958,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7757,22 +8976,29 @@ CLASS="COMMAND"
           are used in for the flags.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4185"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->ranlib</B
+><TT
+CLASS="FUNCTION"
+>ranlib</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7787,6 +9013,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -7815,22 +9042,29 @@ CLASS="COMMAND"
           running the tool to be tested, not a test case.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4201"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->execute_anywhere</B
+><TT
+CLASS="FUNCTION"
+>execute_anywhere</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->cmdline</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>cmdline</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -7846,6 +9080,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -7979,17 +9214,22 @@ CLASS="FUNCTION"
           arrangements to run the tool).</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4245"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->${tool}_start</B
+><TT
+CLASS="FUNCTION"
+>${tool}_start</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -8042,17 +9282,22 @@ CLASS="FUNCTION"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4260"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->${tool}_load</B
+><TT
+CLASS="FUNCTION"
+>${tool}_load</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -8083,17 +9328,22 @@ CLASS="FUNCTION"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4271"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->${tool}_exit</B
+><TT
+CLASS="FUNCTION"
+>${tool}_exit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -8117,17 +9367,22 @@ CLASS="SYMBOL"
           tool, and its version number.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4280"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->${tool}_version</B
+><TT
+CLASS="FUNCTION"
+>${tool}_version</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -8155,26 +9410,35 @@ NAME="GETDIRS"
         pattern. </P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4290"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->getdirs</B
+><TT
+CLASS="FUNCTION"
+>getdirs</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->rootdir</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>rootdir</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->pattern</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8217,6 +9481,7 @@ CLASS="EMPHASIS"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8241,26 +9506,35 @@ CLASS="EMPHASIS"
         the pattern, then a NULL string is returned.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4315"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find</B
+><TT
+CLASS="FUNCTION"
+>find</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->rootdir</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>rootdir</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->pattern</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8288,6 +9562,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8327,22 +9602,29 @@ CLASS="COMMAND"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4342"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->which</B
+><TT
+CLASS="FUNCTION"
+>which</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8358,6 +9640,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8398,30 +9681,41 @@ CLASS="OPTION"
  >.)</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4363"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->grep</B
+><TT
+CLASS="FUNCTION"
+>grep</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->filename</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>filename</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->regexp</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>regexp</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->--line</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>--line</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8464,6 +9758,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8486,26 +9781,35 @@ CLASS="EMPHASIS"
           pattern.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4392"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->prune</B
+><TT
+CLASS="FUNCTION"
+>prune</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->list</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>list</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->pattern</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8534,6 +9838,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8552,22 +9857,29 @@ CLASS="EMPHASIS"
           installed.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4413"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->slay</B
+><TT
+CLASS="FUNCTION"
+>slay</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->name</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8582,6 +9894,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8598,22 +9911,29 @@ CLASS="EMPHASIS"
           and converts it to an absolute path.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4428"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->absolute</B
+><TT
+CLASS="FUNCTION"
+>absolute</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->path</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>path</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8628,6 +9948,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8652,22 +9973,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4445"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->psource</B
+><TT
+CLASS="FUNCTION"
+>psource</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8683,6 +10011,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8710,12 +10039,11 @@ CLASS="EMPHASIS"
  CLASS="EMPHASIS"
  >runtests</I
  >
-         is a list of two elements.  The first is the pathname of the
-         testsuite expect script running.  The second is a copy of what was on
+         is a list of two elements.  The first is a copy of what was on
           the right side of the <I
  CLASS="EMPHASIS"
  >=</I
-> if
+> if   
           <TABLE
  BORDER="0"
  BGCOLOR="#E0E0E0"
@@ -8729,30 +10057,40 @@ CLASS="PROGRAMLISTING"
  ></TR
  ></TABLE
  >" was specified, or
-         an empty string if no such argument is present. This is used by tools
-         like compilers where each testcase is a file.</P
+         an empty string if no such argument is present. The second is the
+         pathname of the current testcase under consideration. This is used
+         by tools like compilers where each testcase is a file.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4466"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->runtest_file_p</B
+><TT
+CLASS="FUNCTION"
+>runtest_file_p</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->runtests</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>runtests</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->testcase</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>testcase</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8763,8 +10101,8 @@ CLASS="PARAMETER"
  ></DT
  ><DD
  ><P
->The pathname of the testsuite expect script
-           running</P
+>The list of patterns to compare against.
+              </P
  ></DD
  ><DT
  ><TT
@@ -8779,6 +10117,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8803,26 +10142,35 @@ CLASS="SYMBOL"
           the screen.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4489"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->diff</B
+><TT
+CLASS="FUNCTION"
+>diff</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->file_1</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>file_1</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->file_2</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>file_2</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8848,6 +10196,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8867,26 +10216,35 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4511"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->setenv</B
+><TT
+CLASS="FUNCTION"
+>setenv</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->val</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>val</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8912,6 +10270,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8928,22 +10287,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4532"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->unsetenv</B
+><TT
+CLASS="FUNCTION"
+>unsetenv</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -8959,6 +10325,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -8975,22 +10342,29 @@ CLASS="EMPHASIS"
           environment if it exists, otherwise it returns NULL.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4547"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->getenv</B
+><TT
+CLASS="FUNCTION"
+>getenv</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9006,6 +10380,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9028,26 +10403,35 @@ CLASS="EMPHASIS"
           date.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4563"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->prune_system_crud</B
+><TT
+CLASS="FUNCTION"
+>prune_system_crud</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->system</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>system</I
+></TT
  >
-           <VAR
-CLASS="PDPARAM"
->test</VAR
+           <TT
+CLASS="PARAMETER"
+><I
+>test</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9076,6 +10460,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -9103,22 +10488,29 @@ NAME="LIBGLOSSLINKFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4587"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->libgloss_link_flags</B
+><TT
+CLASS="FUNCTION"
+>libgloss_link_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9133,6 +10525,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9145,22 +10538,29 @@ NAME="LIBGLOSSINCLUDEFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4601"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->libgloss_include_flags</B
+><TT
+CLASS="FUNCTION"
+>libgloss_include_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9175,6 +10575,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9187,22 +10588,29 @@ NAME="NEWLIBLINKFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4615"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->newlib_link_flags</B
+><TT
+CLASS="FUNCTION"
+>newlib_link_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9217,6 +10625,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9229,22 +10638,29 @@ NAME="NEWLIBINCLUDEFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4629"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->newlib_include_flags</B
+><TT
+CLASS="FUNCTION"
+>newlib_include_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9259,6 +10675,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9271,22 +10688,29 @@ NAME="LIBIOINCLUDEFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4643"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->libio_include_flags</B
+><TT
+CLASS="FUNCTION"
+>libio_include_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9301,6 +10725,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9313,22 +10738,29 @@ NAME="LIBIOLINKFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4657"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->libio_link_flags</B
+><TT
+CLASS="FUNCTION"
+>libio_link_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9343,6 +10775,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9355,22 +10788,29 @@ NAME="GXXINCLUDEFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4671"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->g++_include_flags</B
+><TT
+CLASS="FUNCTION"
+>g++_include_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9385,6 +10825,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9397,22 +10838,29 @@ NAME="GXXLINKFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4685"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->g++_link_flags</B
+><TT
+CLASS="FUNCTION"
+>g++_link_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9427,6 +10875,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9439,22 +10888,29 @@ NAME="LIBSTDCXXINCLUDEFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4699"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->libstdc++_include_flags</B
+><TT
+CLASS="FUNCTION"
+>libstdc++_include_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9469,6 +10925,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9481,22 +10938,29 @@ NAME="LIBSTDCXXLINKFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4713"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->libstdc++_link_flags</B
+><TT
+CLASS="FUNCTION"
+>libstdc++_link_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9511,6 +10975,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9523,22 +10988,29 @@ NAME="GETMULTILIBS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4727"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->get_multilibs</B
+><TT
+CLASS="FUNCTION"
+>get_multilibs</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9553,6 +11025,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9565,22 +11038,29 @@ NAME="FINDBINUTILSPROG"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4741"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_binutils_prog</B
+><TT
+CLASS="FUNCTION"
+>find_binutils_prog</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->name</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>name</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9595,6 +11075,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9607,17 +11088,22 @@ NAME="FINDGCC"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4755"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_gcc</B
+><TT
+CLASS="FUNCTION"
+>find_gcc</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -9634,17 +11120,22 @@ NAME="FINDGCJ"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4763"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_gcj</B
+><TT
+CLASS="FUNCTION"
+>find_gcj</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -9661,17 +11152,22 @@ NAME="FINDGXX"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4771"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_g++</B
+><TT
+CLASS="FUNCTION"
+>find_g++</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -9688,17 +11184,22 @@ NAME="FINDG77"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4779"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_g77</B
+><TT
+CLASS="FUNCTION"
+>find_g77</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -9715,22 +11216,29 @@ NAME="PROCESSMULTILIBOPTIONS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4787"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->process_multilib_options</B
+><TT
+CLASS="FUNCTION"
+>process_multilib_options</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9745,6 +11253,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9757,22 +11266,29 @@ NAME="ADDMULTILIBOPTION"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4801"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->add_multilib_option</B
+><TT
+CLASS="FUNCTION"
+>add_multilib_option</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9787,6 +11303,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9799,17 +11316,22 @@ NAME="FINDGAS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4815"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_gas</B
+><TT
+CLASS="FUNCTION"
+>find_gas</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -9826,17 +11348,22 @@ NAME="FINDLD"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4823"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->find_ld</B
+><TT
+CLASS="FUNCTION"
+>find_ld</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
@@ -9853,22 +11380,29 @@ NAME="BUILDWRAPPER"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4831"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->build_wrapper</B
+><TT
+CLASS="FUNCTION"
+>build_wrapper</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->gluefile</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>gluefile</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9883,6 +11417,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9895,22 +11430,29 @@ NAME="WINSUPINCLUDEFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4845"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->winsup_include_flags</B
+><TT
+CLASS="FUNCTION"
+>winsup_include_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9925,6 +11467,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -9937,22 +11480,29 @@ NAME="WINSUPLINKFLAGS"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4859"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->winsup_link_flags</B
+><TT
+CLASS="FUNCTION"
+>winsup_link_flags</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -9968,6 +11518,7 @@ CLASS="PARAMETER"
  ></DL
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -9999,22 +11550,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4878"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->dumpvars</B
+><TT
+CLASS="FUNCTION"
+>dumpvars</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->vars</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>vars</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10029,6 +11587,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10046,22 +11605,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4893"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->dumplocals</B
+><TT
+CLASS="FUNCTION"
+>dumplocals</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10076,6 +11642,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10093,22 +11660,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4908"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->dumprocs</B
+><TT
+CLASS="FUNCTION"
+>dumprocs</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->pattern</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10124,6 +11698,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10141,22 +11716,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4923"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->dumpwatch</B
+><TT
+CLASS="FUNCTION"
+>dumpwatch</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->pattern</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>pattern</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10172,6 +11754,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10184,26 +11767,35 @@ NAME="WATCHARRAY"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4937"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->watcharray</B
+><TT
+CLASS="FUNCTION"
+>watcharray</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->element</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>element</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->type</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10219,6 +11811,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10231,26 +11824,35 @@ NAME="WATCHVAR"
  ></P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4952"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->watchvar</B
+><TT
+CLASS="FUNCTION"
+>watchvar</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >
-               <VAR
-CLASS="PDPARAM"
->type</VAR
+               <TT
+CLASS="PARAMETER"
+><I
+>type</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10265,6 +11867,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10285,22 +11888,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4969"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->watchunset</B
+><TT
+CLASS="FUNCTION"
+>watchunset</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->arg</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>arg</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10315,6 +11925,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10335,22 +11946,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN4985"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->watchwrite</B
+><TT
+CLASS="FUNCTION"
+>watchwrite</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10365,6 +11983,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10385,22 +12004,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5001"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->watchread</B
+><TT
+CLASS="FUNCTION"
+>watchread</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10415,6 +12041,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10431,22 +12058,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5016"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->watchdel</B
+><TT
+CLASS="FUNCTION"
+>watchdel</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->args</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>args</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10461,6 +12095,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10483,22 +12118,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5032"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->print</B
+><TT
+CLASS="FUNCTION"
+>print</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
->var</VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+>var</I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10513,6 +12155,7 @@ CLASS="PARAMETER"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT3"
  ><H3
@@ -10529,22 +12172,29 @@ CLASS="EMPHASIS"
  >.</P
  ><DIV
  CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5047"
+></A
  ><P
  ></P
  ><CODE
  CLASS="FUNCDEF"
-><B
-CLASS="FSFUNC"
->quit</B
+><TT
+CLASS="FUNCTION"
+>quit</TT
  ></CODE
->(<VAR
-CLASS="PDPARAM"
-></VAR
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
  >);<P
  ></P
  ></DIV
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -10561,6 +12211,7 @@ CLASS="PARAMETER"
  ></DIV
  ></DIV
  ></DIV
+></DIV
  ><DIV
  CLASS="NAVFOOTER"
  ><HR
@@ -10577,7 +12228,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="installation.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -10593,7 +12244,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="filemap.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/configfile.html b/doc/overview/configfile.html

index 9d75311..75db2d9 100644 (file)
--- a/doc/overview/configfile.html
+++ b/doc/overview/configfile.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Config File Values</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Extending DejaGnu"
  HREF="extending.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="releng.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 3. Customizing DejaGnu</TD
+>Customizing DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="extending.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -86,9 +94,7 @@ NAME="OPTIONDEFS"
  ><P
  >In the user editable second section of the <A
  HREF="configfile.html#PERSONAL"
-><I
->Personal Config File</I
-></A
+>Personal Config File</A
  > you can not only override the configuration
         variables captured in the first section, but also specify
         default values for all on the <B
@@ -119,21 +125,26 @@ CLASS="FILENAME"
  >site.exp</TT
  >.  <A
  HREF="runtest.html#INVOKING"
-><I
->Invoking Runtest</I
-></A
+>Invoking Runtest</A
  >, for
         explanations of the command-line options.</P
  ><P
  ><DIV
  CLASS="TABLE"
+><A
+NAME="AEN1008"
+></A
  ><P
  ><B
->Table 3-1. Tcl Variables For Command Line Options</B
+>Table 1. Tcl Variables For Command Line Options</B
  ></P
  ><TABLE
  BORDER="1"
+BGCOLOR="#E0E0E0"
+CELLSPACING="0"
+CELLPADDING="4"
  CLASS="CALSTABLE"
+><THEAD
  ><TR
  ><TH
  ALIGN="LEFT"
@@ -156,6 +167,8 @@ ALIGN="LEFT"
  VALIGN="TOP"
  >description</TH
  ></TR
+></THEAD
+><TBODY
  ><TR
  ><TD
  ALIGN="LEFT"
@@ -391,6 +404,7 @@ ALIGN="LEFT"
  VALIGN="TOP"
  >Email the output log to the specified address.</TD
  ></TR
+></TBODY
  ></TABLE
  ></DIV
  >
@@ -418,9 +432,12 @@ CLASS="FILENAME"
  > file looks like:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN1090"
+></A
  ><P
  ><B
->Example 3-12. Personal Config File</B
+>Example 12. Personal Config File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -481,7 +498,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="releng.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -497,7 +514,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="extending.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/cppunit.html b/doc/overview/cppunit.html

new file mode 100644 (file)

index 0000000..13ae6e6
--- /dev/null
+++ b/doc/overview/cppunit.html
@@ -0,0 +1,306 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>C++ Unit Testing API</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="UP"
+TITLE="Unit Testing API"
+HREF="unittestapi.html"><LINK
+REL="PREVIOUS"
+TITLE="Unit Testing API"
+HREF="unittestapi.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="unittestapi.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Unit Testing API</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+>&nbsp;</TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="CPPUNIT"
+>C++ Unit Testing API</A
+></H1
+><P
+>All of the methods that take a
+                 <TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+> parameter use a C char *
+                 or STL string, that is the message to be
+                 dislayed. There currently is no support for variable
+                 length arguments.</P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="PASSMETH"
+>Pass Method</A
+></H2
+><P
+>This prints a message for a successful test
+         completion.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5165"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>TestState::pass</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="FAILMETH"
+>Fail Method</A
+></H2
+><P
+>This prints a message for an unsuccessful test
+         completion.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5173"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>TestState::fail</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="UNTESTEDMETH"
+>Untested Method</A
+></H2
+><P
+>This prints a message for an test case that isn't run
+         for some technical reason.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5181"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>TestState::untested</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="UNRESOLVEDMETH"
+>Unresolved Method</A
+></H2
+><P
+>This prints a message for an test case that is run,
+         but there is no clear result. These output states require a
+         human to look over the results to determine what happened.
+         </P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5189"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>TestState::unresolved</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="TOTALSMETH"
+>Totals Method</A
+></H2
+><P
+>This prints out the total numbers of all the test
+         state outputs.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5197"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>TestState::totals</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="unittestapi.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Unit Testing API</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="unittestapi.html"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/customizing.html b/doc/overview/customizing.html

index 2ae04c4..b756ab0 100644 (file)
--- a/doc/overview/customizing.html
+++ b/doc/overview/customizing.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Customizing DejaGnu</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -15,6 +17,12 @@ REL="NEXT"
  TITLE="Global Config File"
  HREF="global.html"></HEAD
  ><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -35,7 +43,7 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="outputfiles.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
@@ -48,7 +56,7 @@ ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="global.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -60,42 +68,8 @@ CLASS="CHAPTER"
  ><H1
  ><A
  NAME="CUSTOMIZING"
->Chapter 3. Customizing DejaGnu</A
+>Customizing DejaGnu</A
  ></H1
-><DIV
-CLASS="TOC"
-><DL
-><DT
-><B
->Table of Contents</B
-></DT
-><DT
-><A
-HREF="customizing.html#LOCAL"
->Local Config File</A
-></DT
-><DT
-><A
-HREF="global.html"
->Global Config File</A
-></DT
-><DT
-><A
-HREF="boardconfig.html"
->Board Config File</A
-></DT
-><DT
-><A
-HREF="releng.html"
->Remote Host Testing</A
-></DT
-><DT
-><A
-HREF="configfile.html"
->Config File Values</A
-></DT
-></DL
-></DIV
  ><P
  >The site configuration file, <TT
  CLASS="FILENAME"
@@ -283,9 +257,12 @@ CLASS="COMMAND"
  >.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN896"
+></A
  ><P
  ><B
->Example 3-1. The first section starts with</B
+>Example 1. The first section starts with</B
  ></P
  ><TABLE
  BORDER="0"
@@ -320,9 +297,12 @@ CLASS="COMMAND"
        also be empty, if you do not wish to override any defaults.)</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN902"
+></A
  ><P
  ><B
->Example 3-2. The first section ends with this line</B
+>Example 2. The first section ends with this line</B
  ></P
  ><TABLE
  BORDER="0"
@@ -355,7 +335,7 @@ CLASS="SYMBOL"
  CLASS="SYMBOL"
  >target_triplet</SPAN
  >. All other variables are tool
-      dependant. ie for testing a compiler, the value for
+      dependant, i.e., for testing a compiler, the value for
        <SPAN
  CLASS="SYMBOL"
  >CC</SPAN
@@ -369,9 +349,12 @@ CLASS="PRODUCTNAME"
  > testing.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN912"
+></A
  ><P
  ><B
->Example 3-3. Local Config File</B
+>Example 3. Local Config File</B
  ></P
  ><TABLE
  BORDER="0"
@@ -427,7 +410,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="outputfiles.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -443,7 +426,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="global.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/debugging.html b/doc/overview/debugging.html

index 2c1f33b..7f857c8 100644 (file)
--- a/doc/overview/debugging.html
+++ b/doc/overview/debugging.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Debugging A Test Case</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Adding A Test Case To A Test Suite."
  HREF="adding.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="writing.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="adding.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -202,7 +210,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="writing.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -218,7 +226,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="adding.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/designgoals.html b/doc/overview/designgoals.html

index eea7d1a..c5024c5 100644 (file)
--- a/doc/overview/designgoals.html
+++ b/doc/overview/designgoals.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Design Goals</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="A POSIX conforming test framework"
  HREF="posix.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="new.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 1. Overview</TD
+>Overview</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="posix.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -101,7 +109,7 @@ STYLE="list-style-type: disc"
  ><LI
  STYLE="list-style-type: disc"
  ><P
->permited testing interactive programs, like
+>permitted testing interactive programs, like
        <B
  CLASS="COMMAND"
  >GDB</B
@@ -110,7 +118,7 @@ CLASS="COMMAND"
  ><LI
  STYLE="list-style-type: disc"
  ><P
->permited testing batch oriented programs, like
+>permitted testing batch oriented programs, like
        <B
  CLASS="COMMAND"
  >GCC</B
@@ -174,7 +182,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="new.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -190,7 +198,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="posix.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/djh.html b/doc/overview/djh.html

new file mode 100644 (file)

index 0000000..601833e
--- /dev/null
+++ b/doc/overview/djh.html
@@ -0,0 +1,147 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>The dejagnu.h Header File</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="UP"
+TITLE="Unit Testing"
+HREF="unit.html"><LINK
+REL="PREVIOUS"
+TITLE="Unit Testing"
+HREF="unit.html"><LINK
+REL="NEXT"
+TITLE="Reference"
+HREF="reference.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="unit.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Unit Testing</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="reference.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="DJH"
+>The dejagnu.h Header File</A
+></H1
+><P
+>DejaGnu uses a single header file to assist in unit
+      testing. As this file also produces it's one test state output,
+      it can be run standalone, which is very useful for testing on
+      embedded systems. This header file has a C and C++ API for the
+      test states, with simple totals, and standardized
+      output. Because the output has been standardized, DejaGnu can be
+      made to work with this test case, without writing almost any
+      Tcl. The library module, dejagnu.exp, will look for the output
+      messages, and then merge them into DejaGnu's.</P
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="unit.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="reference.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Unit Testing</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="unit.html"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Reference</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/extending.html b/doc/overview/extending.html

index 904f6af..c6ce943 100644 (file)
--- a/doc/overview/extending.html
+++ b/doc/overview/extending.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Extending DejaGnu</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -15,6 +17,12 @@ REL="NEXT"
  TITLE="Adding A New Tool"
  HREF="addtool.html"></HEAD
  ><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -35,7 +43,7 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="configfile.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
@@ -48,7 +56,7 @@ ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="addtool.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -60,68 +68,9 @@ CLASS="CHAPTER"
  ><H1
  ><A
  NAME="EXTENDING"
->Chapter 4. Extending DejaGnu</A
+>Extending DejaGnu</A
  ></H1
  ><DIV
-CLASS="TOC"
-><DL
-><DT
-><B
->Table of Contents</B
-></DT
-><DT
-><A
-HREF="extending.html#ADDSUITE"
->Adding A New Test Suite</A
-></DT
-><DT
-><A
-HREF="addtool.html"
->Adding A New Tool</A
-></DT
-><DT
-><A
-HREF="addtarget.html"
->Adding A New Target</A
-></DT
-><DT
-><A
-HREF="addboard.html"
->Adding A New Board</A
-></DT
-><DT
-><A
-HREF="boarddefs.html"
->Board Config File Values</A
-></DT
-><DT
-><A
-HREF="writing.html"
->Writing A Test Case</A
-></DT
-><DT
-><A
-HREF="debugging.html"
->Debugging A Test Case</A
-></DT
-><DT
-><A
-HREF="adding.html"
->Adding A Test Case To A Test Suite.</A
-></DT
-><DT
-><A
-HREF="hints.html"
->Hints On Writing A Test Case</A
-></DT
-><DT
-><A
-HREF="tvariables.html"
->Special variables used by test cases.</A
-></DT
-></DL
-></DIV
-><DIV
  CLASS="SECT1"
  ><H1
  CLASS="SECT1"
@@ -163,7 +112,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="configfile.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -179,7 +128,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="addtool.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/filemap.html b/doc/overview/filemap.html

index 6ea4a31..edde972 100644 (file)
--- a/doc/overview/filemap.html
+++ b/doc/overview/filemap.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >File Map</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -13,8 +15,17 @@ TITLE="Reference"
  HREF="reference.html"><LINK
  REL="PREVIOUS"
  TITLE="Builtin Procedures"
-HREF="builtins.html"></HEAD
+HREF="builtins.html"><LINK
+REL="NEXT"
+TITLE="Unit Testing API"
+HREF="unittestapi.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -35,18 +46,21 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="builtins.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 5. Reference</TD
+>Reference</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
->&nbsp;</TD
+><A
+HREF="unittestapi.html"
+>Next &#62;&#62;&#62;</A
+></TD
  ></TR
  ></TABLE
  ><HR
@@ -161,6 +175,10 @@ NAME="FILEMAP"
  ><P
  >lib/xsh.exp</P
  ></LI
+><LI
+><P
+>lib/dejagnu.exp</P
+></LI
  ></UL
  ></DIV
  ><DIV
@@ -179,7 +197,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="builtins.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -193,7 +211,10 @@ HREF="book1.html"
  WIDTH="33%"
  ALIGN="right"
  VALIGN="top"
->&nbsp;</TD
+><A
+HREF="unittestapi.html"
+>Next &#62;&#62;&#62;</A
+></TD
  ></TR
  ><TR
  ><TD
@@ -213,7 +234,7 @@ HREF="reference.html"
  WIDTH="33%"
  ALIGN="right"
  VALIGN="top"
->&nbsp;</TD
+>Unit Testing API</TD
  ></TR
  ></TABLE
  ></DIV
diff --git a/doc/overview/gettingup.html b/doc/overview/gettingup.html

new file mode 100644 (file)

index 0000000..bc3ec37
--- /dev/null
+++ b/doc/overview/gettingup.html
@@ -0,0 +1,247 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>Getting DejaGnu up and running</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="PREVIOUS"
+TITLE="A POSIX conforming test framework"
+HREF="posix.html"><LINK
+REL="NEXT"
+TITLE="Create a minimal project, e.g. calc"
+HREF="x227.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="posix.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="x227.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="GETTINGUP"
+>Getting DejaGnu up and running</A
+></H1
+><P
+>This chapter was originally written by Niklaus Giger (ngiger@mus.ch) because he lost a week to figure out how DejaGnu works and how to write a first test.</P
+><P
+>Follow these instructions as closely a possible in order get a good insight into how DejaGnu works, else you might run into a lot of subtle problems. You have been warned.</P
+><P
+>It should be no big problems installing DejaGnu using your package manager or from the source code. Under a Debian/GNU/Linux systems just type (as root) <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>apt-get dejagnu</PRE
+></TD
+></TR
+></TABLE
+>. These examples were run on a primary machine with a AMD K6 and a Mac Powerbook G3 serving as a remote target.</P
+><P
+> The tests for Windows were run under Windows NT using the actual cygwin version (1.3.x as of October 2001). It's target system was a PPC embedded system running vxWorks. </P
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN210"
+>Test your installation</A
+></H1
+><P
+>Create a new user called "dgt" (DejaGnuTest), which uses bash as it login shell. PS1 must be set to '\u:\w\$ ' in its ~/.bashrc. Login as this user, create an empty directory and change the working directory to it. e.g</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~$ mkdir ~/dejagnu.test
+dgt:~$ cd ~/dejagnu.test</PRE
+></TD
+></TR
+></TABLE
+><P
+>Now you are ready to test DejaGnu's main program called ruuntest. The expecteted output is shown</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN215"
+></A
+><P
+><B
+>Example 1. Runtest output in a empty directory</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ runtest 
+WARNING: Couldn't find the global config file. 
+WARNING: No tool specified Test 
+Run By dgt on Sun Nov 25 17:07:03 2001 Native configuration is i586-pc-linux-gnu
+=== tests ===
+Schedule of variations: unix
+Running target unix Using /usr/share/dejagnu/baseboards/unix.exp as board description file for target. 
+Using /usr/share/dejagnu/config/unix.exp as generic interface file for target. 
+ERROR: Couldn't find tool config file for unix.
+=== Summary ===</PRE
+></TD
+></TR
+></TABLE
+><P
+>We will show you later how to get rid of all the WARNING- and ERROR-messages. The files testrun.sum and testrun.log have been created, which do not interest us at this point. Let's remove them.</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>:~/dejagnu.test$ rm testrun.sum testrun.log </PRE
+></TD
+></TR
+></TABLE
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN220"
+>Windows</A
+></H2
+><P
+>On Windows systems DejaGnu is part of a port of a lot of Unix tools to the Windows OS, called cygwin. Cygwin may be downloaded and installed from a mirror of http://sources.redhat.com/cygwin/. All examples were also run on Windows NT. If nothing is said, you can assume that you should get the same output as on a Unix system.</P
+><P
+>You will need a telnet daemon if you want to use a WindowsNT box as a remote target. There seems to be a freeware telnet daemon at http://www.fictional.net/.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN224"
+>Getting the source code for the calc example</A
+></H2
+><P
+>If you are running a Debian distribution you can find the examples under /usr/share/doc/dejagnu/examples. 
+These examples seem to be missing in RedHat's RPM. 
+In this case download the sources of DejaGnu and adjust the pathes to the DejaGnu examples accordingly.</P
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="posix.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="x227.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>A POSIX conforming test framework</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Create a minimal project, e.g. calc</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/global.html b/doc/overview/global.html

index e3a988c..ce1f4cc 100644 (file)
--- a/doc/overview/global.html
+++ b/doc/overview/global.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Global Config File</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Board Config File"
  HREF="boardconfig.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="customizing.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 3. Customizing DejaGnu</TD
+>Customizing DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="boardconfig.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -87,9 +95,12 @@ CLASS="EMPHASIS"
        debugging protocol, we test on both of them in sequence.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN921"
+></A
  ><P
  ><B
->Example 3-4. Global Config file</B
+>Example 4. Global Config file</B
  ></P
  ><TABLE
  BORDER="0"
@@ -164,9 +175,7 @@ CLASS="EMPHASIS"
      symbolic names for other mips boards. Symbolic names are covered
      in the <A
  HREF="addboard.html"
-><I
->Adding A New Board</I
-></A
+>Adding A New Board</A
  > chapter. The more complicated
      example is the one for <I
  CLASS="EMPHASIS"
@@ -199,7 +208,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="customizing.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -215,7 +224,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="boardconfig.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/hints.html b/doc/overview/hints.html

index cac3d76..5dce09d 100644 (file)
--- a/doc/overview/hints.html
+++ b/doc/overview/hints.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Hints On Writing A Test Case</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Special variables used by test cases."
  HREF="tvariables.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="adding.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="tvariables.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -212,7 +220,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="adding.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -228,7 +236,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="tvariables.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/installation.html b/doc/overview/installation.html

index 0720d39..19c5c08 100644 (file)
--- a/doc/overview/installation.html
+++ b/doc/overview/installation.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Installation</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Builtin Procedures"
  HREF="builtins.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="reference.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 5. Reference</TD
+>Reference</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="builtins.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -108,7 +116,7 @@ WIDTH="100%"
  ><TD
  ><PRE
  CLASS="SCREEN"
->        ../dejagnu-1.4/configure
+>        ../dejagnu-1.4.3/configure
        </PRE
  ></TD
  ></TR
@@ -301,7 +309,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="reference.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -317,7 +325,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="builtins.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/new.html b/doc/overview/new.html

index 87e17b5..8f19cac 100644 (file)
--- a/doc/overview/new.html
+++ b/doc/overview/new.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >What's New In This Release</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Design Goals"
  HREF="designgoals.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="overview.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 1. Overview</TD
+>Overview</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="designgoals.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -93,9 +101,7 @@ CLASS="PRODUCTNAME"
         preferably with a target supported by
         <A
  HREF="builtins.html#LIBGLOSS"
-><I
->Libgloss</I
-></A
+>Libgloss</A
  >.</P
  ></LI
  ><LI
@@ -182,7 +188,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="overview.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -198,7 +204,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="designgoals.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/outputfiles.html b/doc/overview/outputfiles.html

index ff8e8bf..97980f4 100644 (file)
--- a/doc/overview/outputfiles.html
+++ b/doc/overview/outputfiles.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >The files DejaGnu produces.</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Customizing DejaGnu"
  HREF="customizing.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="runtest.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 2. Running Tests</TD
+>Running Tests</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="customizing.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -159,9 +167,12 @@ CLASS="OPTION"
        directory.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN780"
+></A
  ><P
  ><B
->Example 2-1. Here is a short sample summary log</B
+>Example 1. Here is a short sample summary log</B
  ></P
  ><TABLE
  BORDER="0"
@@ -225,9 +236,12 @@ CLASS="OPTION"
        directory.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN790"
+></A
  ><P
  ><B
->Example 2-2. Here is a brief example showing a detailed log for
+>Example 2. Here is a brief example showing a detailed log for
          <SPAN
  CLASS="PRODUCTNAME"
  >G++</SPAN
@@ -323,9 +337,12 @@ CLASS="PRODUCTNAME"
        pattern it compares with the tool output.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN805"
+></A
  ><P
  ><B
->Example 2-3. The log messages begin with a message of the form</B
+>Example 3. The log messages begin with a message of the form</B
  ></P
  ><TABLE
  BORDER="0"
@@ -387,9 +404,12 @@ CLASS="PRODUCTNAME"
        variables set to describe a successful match.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN820"
+></A
  ><P
  ><B
->Example 2-4. Here is an excerpt from the debugging log for a
+>Example 4. Here is an excerpt from the debugging log for a
          <SPAN
  CLASS="PRODUCTNAME"
  >GDB</SPAN
@@ -550,7 +570,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="runtest.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -566,7 +586,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="customizing.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/overview.html b/doc/overview/overview.html

index 1972cb9..e04da13 100644 (file)
--- a/doc/overview/overview.html
+++ b/doc/overview/overview.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Overview</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -15,6 +17,12 @@ REL="NEXT"
  TITLE="What's New In This Release"
  HREF="new.html"></HEAD
  ><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -35,7 +43,7 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="preface.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
@@ -48,7 +56,7 @@ ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="new.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -60,38 +68,9 @@ CLASS="CHAPTER"
  ><H1
  ><A
  NAME="OVERVIEW"
->Chapter 1. Overview</A
+>Overview</A
  ></H1
  ><DIV
-CLASS="TOC"
-><DL
-><DT
-><B
->Table of Contents</B
-></DT
-><DT
-><A
-HREF="overview.html#WHATIS"
->What is DejaGnu ?</A
-></DT
-><DT
-><A
-HREF="new.html"
->What's New In This Release</A
-></DT
-><DT
-><A
-HREF="designgoals.html"
->Design Goals</A
-></DT
-><DT
-><A
-HREF="posix.html"
->A POSIX conforming test framework</A
-></DT
-></DL
-></DIV
-><DIV
  CLASS="SECT1"
  ><H1
  CLASS="SECT1"
@@ -236,7 +215,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="preface.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -252,7 +231,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="new.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/posix.html b/doc/overview/posix.html

index 3f96d05..68895f7 100644 (file)
--- a/doc/overview/posix.html
+++ b/doc/overview/posix.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >A POSIX conforming test framework</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -15,9 +17,15 @@ REL="PREVIOUS"
  TITLE="Design Goals"
  HREF="designgoals.html"><LINK
  REL="NEXT"
-TITLE="Running Tests"
-HREF="runningtests.html"></HEAD
+TITLE="Getting DejaGnu up and running"
+HREF="gettingup.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="designgoals.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 1. Overview</TD
+>Overview</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
-HREF="runningtests.html"
->Next</A
+HREF="gettingup.html"
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -102,6 +110,8 @@ CLASS="FIRSTTERM"
        case:</P
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  >PASS</DT
@@ -198,6 +208,7 @@ CLASS="EMPHASIS"
  >:</P
  ></DD
  ></DL
+></DIV
  ><P
  ></P
  ><UL
@@ -248,6 +259,8 @@ STYLE="list-style-type: disc"
  ></UL
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  >UNTESTED</DT
@@ -257,12 +270,15 @@ STYLE="list-style-type: disc"
             when there is no real test case yet.</P
  ></DD
  ></DL
+></DIV
  ><P
  >The only remaining output message left is intended to test
           features that are specified by the applicable POSIX standard as
           conditional:</P
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  >UNSUPPORTED</DT
@@ -281,6 +297,7 @@ CLASS="EMPHASIS"
             monitor.</P
  ></DD
  ></DL
+></DIV
  ><P
  >DejaGnu uses the same output procedures to produce these messages
         for all test suites, and these procedures are already known to conform
@@ -319,7 +336,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="designgoals.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -334,8 +351,8 @@ WIDTH="33%"
  ALIGN="right"
  VALIGN="top"
  ><A
-HREF="runningtests.html"
->Next</A
+HREF="gettingup.html"
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
@@ -356,7 +373,7 @@ HREF="overview.html"
  WIDTH="33%"
  ALIGN="right"
  VALIGN="top"
->Running Tests</TD
+>Getting DejaGnu up and running</TD
  ></TR
  ></TABLE
  ></DIV
diff --git a/doc/overview/preface.html b/doc/overview/preface.html

index 7ffa9cc..2dd245f 100644 (file)
--- a/doc/overview/preface.html
+++ b/doc/overview/preface.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Abstract</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -15,6 +17,12 @@ REL="NEXT"
  TITLE="Overview"
  HREF="overview.html"></HEAD
  ><BODY
+CLASS="PREFACE"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -35,7 +43,7 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="book1.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
@@ -48,7 +56,7 @@ ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="overview.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -114,7 +122,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="book1.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -130,7 +138,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="overview.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/reference.html b/doc/overview/reference.html

index 9e4b9ca..d878d06 100644 (file)
--- a/doc/overview/reference.html
+++ b/doc/overview/reference.html
@@ -1,20 +1,28 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Reference</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
  REL="PREVIOUS"
-TITLE="Special variables used by test cases."
-HREF="tvariables.html"><LINK
+TITLE="The dejagnu.h Header File"
+HREF="djh.html"><LINK
  REL="NEXT"
  TITLE="Installation"
  HREF="installation.html"></HEAD
  ><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -34,8 +42,8 @@ WIDTH="10%"
  ALIGN="left"
  VALIGN="bottom"
  ><A
-HREF="tvariables.html"
->Prev</A
+HREF="djh.html"
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
@@ -48,7 +56,7 @@ ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="installation.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -60,38 +68,9 @@ CLASS="CHAPTER"
  ><H1
  ><A
  NAME="REFERENCE"
->Chapter 5. Reference</A
+>Reference</A
  ></H1
  ><DIV
-CLASS="TOC"
-><DL
-><DT
-><B
->Table of Contents</B
-></DT
-><DT
-><A
-HREF="reference.html#OBTAINING"
->Obtaining DejaGnu</A
-></DT
-><DT
-><A
-HREF="installation.html"
->Installation</A
-></DT
-><DT
-><A
-HREF="builtins.html"
->Builtin Procedures</A
-></DT
-><DT
-><A
-HREF="filemap.html"
->File Map</A
-></DT
-></DL
-></DIV
-><DIV
  CLASS="SECT1"
  ><H1
  CLASS="SECT1"
@@ -129,8 +108,8 @@ WIDTH="33%"
  ALIGN="left"
  VALIGN="top"
  ><A
-HREF="tvariables.html"
->Prev</A
+HREF="djh.html"
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -146,7 +125,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="installation.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
@@ -154,7 +133,7 @@ HREF="installation.html"
  WIDTH="33%"
  ALIGN="left"
  VALIGN="top"
->Special variables used by test cases.</TD
+>The dejagnu.h Header File</TD
  ><TD
  WIDTH="34%"
  ALIGN="center"
diff --git a/doc/overview/releng.html b/doc/overview/releng.html

index d1e2edd..e8531c4 100644 (file)
--- a/doc/overview/releng.html
+++ b/doc/overview/releng.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Remote Host Testing</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Config File Values"
  HREF="configfile.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="boardconfig.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 3. Customizing DejaGnu</TD
+>Customizing DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="configfile.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -68,14 +76,30 @@ NAME="RELENG"
  ></H1
  ><DIV
  CLASS="NOTE"
-><BLOCKQUOTE
+><P
+></P
+><TABLE
  CLASS="NOTE"
+WIDTH="100%"
+BORDER="0"
+><TR
+><TD
+WIDTH="25"
+ALIGN="CENTER"
+VALIGN="TOP"
+><IMG
+SRC="./stylesheet-images/note.gif"
+HSPACE="5"
+ALT="Note"></TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
  ><P
-><B
->Note: </B
  >Thanks to Dj Delorie for the original paper that
        this section is based on.</P
-></BLOCKQUOTE
+></TD
+></TR
+></TABLE
  ></DIV
  ><P
  >DejaGnu also supports running the tests on a remote
@@ -126,9 +150,12 @@ TARGET="_top"
        releng's area in SV to your machine:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN965"
+></A
  ><P
  ><B
->Example 3-6. Remote host setup</B
+>Example 6. Remote host setup</B
  ></P
  ><TABLE
  BORDER="0"
@@ -163,9 +190,12 @@ CLASS="FILENAME"
        boards directory:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN971"
+></A
  ><P
  ><B
->Example 3-7. Add The Board Directory</B
+>Example 7. Add The Board Directory</B
  ></P
  ><TABLE
  BORDER="0"
@@ -189,9 +219,12 @@ CLASS="PROGRAMLISTING"
         the PC), do something like this:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN975"
+></A
  ><P
  ><B
->Example 3-8. Setup Cross Remote Testing</B
+>Example 8. Setup Cross Remote Testing</B
  ></P
  ><TABLE
  BORDER="0"
@@ -212,9 +245,12 @@ CLASS="PROGRAMLISTING"
         gcc.exe in your PATH on the PC), do this:</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN979"
+></A
  ><P
  ><B
->Example 3-9. Setup Native Remote Testing</B
+>Example 9. Setup Native Remote Testing</B
  ></P
  ><TABLE
  BORDER="0"
@@ -243,9 +279,12 @@ CLASS="COMMAND"
         the installation you want to test.</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN984"
+></A
  ><P
  ><B
->Example 3-10. Run Test Remotely</B
+>Example 10. Run Test Remotely</B
  ></P
  ><TABLE
  BORDER="0"
@@ -268,9 +307,12 @@ CLASS="PROGRAMLISTING"
         MkTestDir created):</P
  ><DIV
  CLASS="EXAMPLE"
+><A
+NAME="AEN988"
+></A
  ><P
  ><B
->Example 3-11. Run a Test Remotely</B
+>Example 11. Run a Test Remotely</B
  ></P
  ><TABLE
  BORDER="0"
@@ -308,7 +350,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="boardconfig.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -324,7 +366,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="configfile.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/runningtests.html b/doc/overview/runningtests.html

index a78cf8c..3bd812f 100644 (file)
--- a/doc/overview/runningtests.html
+++ b/doc/overview/runningtests.html
@@ -1,20 +1,28 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Running Tests</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
  REL="PREVIOUS"
-TITLE="A POSIX conforming test framework"
-HREF="posix.html"><LINK
+TITLE="A first remote test"
+HREF="x319.html"><LINK
  REL="NEXT"
  TITLE="Runtest"
  HREF="runtest.html"></HEAD
  ><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -34,8 +42,8 @@ WIDTH="10%"
  ALIGN="left"
  VALIGN="bottom"
  ><A
-HREF="posix.html"
->Prev</A
+HREF="x319.html"
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
@@ -48,7 +56,7 @@ ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="runtest.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -60,32 +68,8 @@ CLASS="CHAPTER"
  ><H1
  ><A
  NAME="RUNNINGTESTS"
->Chapter 2. Running Tests</A
+>Running Tests</A
  ></H1
-><DIV
-CLASS="TOC"
-><DL
-><DT
-><B
->Table of Contents</B
-></DT
-><DT
-><A
-HREF="runningtests.html#MAKECHECK"
->Make check</A
-></DT
-><DT
-><A
-HREF="runtest.html"
->Runtest</A
-></DT
-><DT
-><A
-HREF="outputfiles.html"
->The files DejaGnu produces.</A
-></DT
-></DL
-></DIV
  ><P
  >There are two ways to execute a test suite. The most
      common way is when there is existing support in the
@@ -107,9 +91,7 @@ CLASS="COMMAND"
  > directcly from the command line requires
      either all the correct options, or the <A
  HREF="customizing.html#LOCAL"
-><I
->Local Config File</I
-></A
+>Local Config File</A
  > must be setup
      correctly.</P
  ><DIV
@@ -213,8 +195,8 @@ WIDTH="33%"
  ALIGN="left"
  VALIGN="top"
  ><A
-HREF="posix.html"
->Prev</A
+HREF="x319.html"
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -230,7 +212,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="runtest.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
@@ -238,7 +220,7 @@ HREF="runtest.html"
  WIDTH="33%"
  ALIGN="left"
  VALIGN="top"
->A POSIX conforming test framework</TD
+>A first remote test</TD
  ><TD
  WIDTH="34%"
  ALIGN="center"
diff --git a/doc/overview/runtest.html b/doc/overview/runtest.html

index 73fbb57..b3a8a00 100644 (file)
--- a/doc/overview/runtest.html
+++ b/doc/overview/runtest.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Runtest</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="The files DejaGnu produces."
  HREF="outputfiles.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="runningtests.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 2. Running Tests</TD
+>Running Tests</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="outputfiles.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -107,14 +115,14 @@ CLASS="FILENAME"
  > flags the outcome of each
         test as one of these cases. <A
  HREF="posix.html"
-><I
->A POSIX Conforming Test Framework</I
-></A
+>A POSIX Conforming Test Framework</A
  > for a
         discussion of how POSIX specifies the meanings of these
         cases.</P
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  >PASS</DT
@@ -189,10 +197,13 @@ CLASS="EMPHASIS"
            does not include a required subroutine.</P
  ></DD
  ></DL
+></DIV
  ><P
  >runtest may also display the following messages:</P
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  >ERROR</DT
@@ -232,6 +243,7 @@ CLASS="EMPHASIS"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -249,6 +261,8 @@ CLASS="FILENAME"
        abbreviated to the shortest unique string.</P
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  ><TT
@@ -952,6 +966,7 @@ CLASS="FILENAME"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="SECT2"
  ><H2
@@ -1096,7 +1111,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="runningtests.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -1112,7 +1127,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="outputfiles.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/tvariables.html b/doc/overview/tvariables.html

index ee28884..6b19f90 100644 (file)
--- a/doc/overview/tvariables.html
+++ b/doc/overview/tvariables.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Special variables used by test cases.</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -15,9 +17,15 @@ REL="PREVIOUS"
  TITLE="Hints On Writing A Test Case"
  HREF="hints.html"><LINK
  REL="NEXT"
-TITLE="Reference"
-HREF="reference.html"></HEAD
+TITLE="Unit Testing"
+HREF="unit.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="hints.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
-HREF="reference.html"
->Next</A
+HREF="unit.html"
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -77,6 +85,8 @@ CLASS="FILENAME"
        but they should never be changed.</P
  ><P
  ></P
+><DIV
+CLASS="VARIABLELIST"
  ><DL
  ><DT
  >$prms_id</DT
@@ -142,6 +152,7 @@ CLASS="FUNCTION"
  ></DD
  ></DL
  ></DIV
+></DIV
  ><DIV
  CLASS="NAVFOOTER"
  ><HR
@@ -158,7 +169,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="hints.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -173,8 +184,8 @@ WIDTH="33%"
  ALIGN="right"
  VALIGN="top"
  ><A
-HREF="reference.html"
->Next</A
+HREF="unit.html"
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
@@ -195,7 +206,7 @@ HREF="extending.html"
  WIDTH="33%"
  ALIGN="right"
  VALIGN="top"
->Reference</TD
+>Unit Testing</TD
  ></TR
  ></TABLE
  ></DIV
diff --git a/doc/overview/unit.html b/doc/overview/unit.html

new file mode 100644 (file)

index 0000000..55864cd
--- /dev/null
+++ b/doc/overview/unit.html
@@ -0,0 +1,153 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>Unit Testing</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="PREVIOUS"
+TITLE="Special variables used by test cases."
+HREF="tvariables.html"><LINK
+REL="NEXT"
+TITLE="The dejagnu.h Header File"
+HREF="djh.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="tvariables.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="djh.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="UNIT"
+>Unit Testing</A
+></H1
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="UNITTEST"
+>What Is Unit Testing ?</A
+></H1
+><P
+>Most regression testing as done by DejaGnu is system
+      testing. This is the complete application is tested all at
+      once. Unit testing is for testing single files, or small
+      libraries. In this case, each file is linked with a test case in
+      C or C++, and each function or class and method is tested in
+      series, with the test case having to check private data or
+      global variables to see if the function or method worked.</P
+><P
+>This works particularly well for testing APIs and at level
+      where it is easier to debug them, than by needing to trace through
+      the entire appication. Also if there is a specification for the
+      API to be tested, the testcase can also function as a compliance
+      test.</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="tvariables.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="djh.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Special variables used by test cases.</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>The dejagnu.h Header File</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/unittestapi.html b/doc/overview/unittestapi.html

new file mode 100644 (file)

index 0000000..f81a32e
--- /dev/null
+++ b/doc/overview/unittestapi.html
@@ -0,0 +1,316 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>Unit Testing API</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="PREVIOUS"
+TITLE="File Map"
+HREF="filemap.html"><LINK
+REL="NEXT"
+TITLE="C++ Unit Testing API"
+HREF="cppunit.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="filemap.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="cppunit.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="UNITTESTAPI"
+>Unit Testing API</A
+></H1
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="CUNIT"
+>C Unit Testing API</A
+></H1
+><P
+>All of the functions that take a
+    <TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+> parameter use a C char * that is
+    the message to be dislayed. There currently is no support for
+    variable length arguments.</P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="PASSFUNC"
+>Pass Function</A
+></H2
+><P
+>This prints a message for a successful test
+         completion.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5121"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>pass</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="FAILFUNC"
+>Fail Function</A
+></H2
+><P
+>This prints a message for an unsuccessful test
+         completion.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5129"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>fail</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="UNTESTEDFUNC"
+>Untested Function</A
+></H2
+><P
+>This prints a message for an test case that isn't run
+         for some technical reason.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5137"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>untested</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="UNRESOLVEDFUNC"
+>Unresolved Function</A
+></H2
+><P
+>This prints a message for an test case that is run,
+         but there is no clear result. These output states require a
+         human to look over the results to determine what happened.
+         </P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5145"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>unresolved</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+>msg</I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="TOTALSFUNC"
+>Totals Function</A
+></H2
+><P
+>This prints out the total numbers of all the test
+         state outputs.</P
+><DIV
+CLASS="FUNCSYNOPSIS"
+><A
+NAME="AEN5153"
+></A
+><P
+></P
+><CODE
+CLASS="FUNCDEF"
+><TT
+CLASS="FUNCTION"
+>totals</TT
+></CODE
+>(<TT
+CLASS="PARAMETER"
+><I
+></I
+></TT
+>);<P
+></P
+></DIV
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="filemap.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="cppunit.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>File Map</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>C++ Unit Testing API</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/writing.html b/doc/overview/writing.html

index 17e09ed..30c464a 100644 (file)
--- a/doc/overview/writing.html
+++ b/doc/overview/writing.html
@@ -1,10 +1,12 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
  <HTML
  ><HEAD
  ><TITLE
  >Writing A Test Case</TITLE
  ><META
  NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
  REL="HOME"
  TITLE="DejaGnu"
  HREF="book1.html"><LINK
@@ -18,6 +20,12 @@ REL="NEXT"
  TITLE="Debugging A Test Case"
  HREF="debugging.html"></HEAD
  ><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
  ><DIV
  CLASS="NAVHEADER"
  ><TABLE
@@ -38,20 +46,20 @@ ALIGN="left"
  VALIGN="bottom"
  ><A
  HREF="boarddefs.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="80%"
  ALIGN="center"
  VALIGN="bottom"
->Chapter 4. Extending DejaGnu</TD
+>Extending DejaGnu</TD
  ><TD
  WIDTH="10%"
  ALIGN="right"
  VALIGN="bottom"
  ><A
  HREF="debugging.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ></TABLE
@@ -156,7 +164,7 @@ ALIGN="left"
  VALIGN="top"
  ><A
  HREF="boarddefs.html"
->Prev</A
+>&#60;&#60;&#60; Previous</A
  ></TD
  ><TD
  WIDTH="34%"
@@ -172,7 +180,7 @@ ALIGN="right"
  VALIGN="top"
  ><A
  HREF="debugging.html"
->Next</A
+>Next &#62;&#62;&#62;</A
  ></TD
  ></TR
  ><TR
diff --git a/doc/overview/x227.html b/doc/overview/x227.html

new file mode 100644 (file)

index 0000000..014b820
--- /dev/null
+++ b/doc/overview/x227.html
@@ -0,0 +1,456 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>Create a minimal project, e.g. calc</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="UP"
+TITLE="Getting DejaGnu up and running"
+HREF="gettingup.html"><LINK
+REL="PREVIOUS"
+TITLE="Getting DejaGnu up and running"
+HREF="gettingup.html"><LINK
+REL="NEXT"
+TITLE="Our first automated tests"
+HREF="x276.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="gettingup.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Getting DejaGnu up and running</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="x276.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN227"
+>Create a minimal project, e.g. calc</A
+></H1
+><P
+>In this section you will to start a small project, 
+using the sample application calc, which is part of your DejaGnu distribution</P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN230"
+>A simple project without the GNU autotools</A
+></H2
+><P
+>The runtest program can be run standalone. All the autoconf/automake support is just cause those programs are commonly used for other GNU applications. The key to running runtest standalone is having the local site.exp file setup correctly, which automake does.</P
+><P
+>The generated site.exp should like like:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set tool calc 
+set srcdir . 
+set objdir /home/dgt/dejagnu.test</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN235"
+>Using autoconf/autoheader/automake</A
+></H2
+><P
+>We have to prepare some input file in order to run autocon and automake. There is book &#8220;GNU autoconf, automake and libtool&#8221; by Garry V. Vaughan, et al. NewRider, ISBN 1-57870-190-2 which describes this process thoroughly.</P
+><P
+>From the calc example distributed with the DejaGnu documentation you should copy the program file itself (calc.c) and some additional files, which you might examine a little bit close to derive their meanings.</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ cp -r /usr/share/doc/dejagnu/examples/calc/\
+{configure.in,Makefile.am,calc.c,testsuite} .</PRE
+></TD
+></TR
+></TABLE
+><P
+>In Makemake.am note the presence of the AUTOMAKE_OPTIONS = dejagnu. This option is needed.</P
+><P
+>Run aclocal to generate aclocal.m4, which is a collection of macros needed by configure.in</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ aclocal</PRE
+></TD
+></TR
+></TABLE
+><P
+>autoconf is another part of the auto-tools. 
+Run it to generate configure based on information contained in configure.in.</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ autoconf</PRE
+></TD
+></TR
+></TABLE
+><P
+>autoheader is another part of the auto-tools. 
+Run it to generate calc.h.in. </P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ autoheader</PRE
+></TD
+></TR
+></TABLE
+><P
+>The Makefile.am of this example was developed as port of the DejaGnu 
+distribution. 
+Adapt Makefile.am for this test. Replace the line 
+&#8220;#noinst_PROGRAMS = calc&#8221; to 
+&#8220;bin_PROGRAMS = calc&#8221;. 
+Change the RUNTESTDEFAULTFLAGS from
+&#8220;$$srcdir/testsuite&#8221; to 
+&#8220;./testsuite&#8221;.</P
+><P
+>Running automake at this point contains a series of warning in its output as shown in the following example:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN249"
+></A
+><P
+><B
+>Example 2. Sample output of automake with missing files</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ automake --add-missing
+automake: configure.in: installing `./install-sh' 
+automake: configure.in: installing `./mkinstalldirs' 
+automake: configure.in: installing `./missing' 
+automake: Makefile.am: installing `./INSTALL' 
+automake: Makefile.am: required file `./NEWS' not found 
+automake: Makefile.am: required file `./README' not found 
+automake: Makefile.am: installing `./COPYING' 
+automake: Makefile.am: required file `./AUTHORS' not found 
+automake: Makefile.am: required file `./ChangeLog' not found 
+configure.in: 4: required file `./calc.h.in' not found 
+Makefile.am:6: required directory ./doc does not exist</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Create a empty directory doc and empty files 
+INSTALL, NEWS, README, AUTHORS, ChangeLog and COPYING. 
+The default COPYING will point to the GNU Public License (GPL).
+In a real project it would be time to add some meaningfull text in each file.</P
+><P
+>Adapt calc to your environment by calling configure.</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN254"
+></A
+><P
+><B
+>Example 3. Sample output of configure</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ ./configure 
+creating cache ./config.cache 
+checking whether to enable maintainer-specific portions of Makefiles... no 
+checking for a BSD compatible install... /usr/bin/install -c 
+checking whether build environment is sane... yes 
+checking whether make sets ${MAKE}... yes 
+checking for working aclocal... found 
+checking for working autoconf... found 
+checking for working automake... found 
+checking for working autoheader... found 
+checking for working makeinfo... found 
+checking for gcc... gcc checking whether the C compiler (gcc ) works... yes 
+checking whether the C compiler (gcc ) is a cross-compiler... no 
+checking whether we are using GNU C... yes
+checking whether gcc accepts -g... yes 
+checking for a BSD compatible install... /usr/bin/install -c 
+checking how to run the C preprocessor... gcc -E 
+checking for stdlib.h... yes 
+checking for strcmp... yes 
+updating cache ./config.cache 
+creating ./config.status 
+creating Makefile creating calc.h</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>If you are familiar with GNU software, 
+this output should not contain any surprise to you. 
+Any errors should be easy to fix for such a simple program.</P
+><P
+>Build the calc executable:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN259"
+></A
+><P
+><B
+>Example 4. Sample output building calc</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ make 
+gcc -DHAVE_CONFIG_H -I. -I. -I. -g -O2 -c calc.c 
+gcc -g -O2 -o calc calc.o</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>You prepared a few files and then called some commands. 
+Respecting the right order assures a automatic and correctly compiled calc program. The following example resumes the correct order.</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN263"
+></A
+><P
+><B
+>Example 5. Creating the calc program using the GNU autotools</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ aclocal
+dgt:~/dejagnu.test$ autoconf
+dgt:~/dejagnu.test$ autoheader
+dgt:~/dejagnu.test$ automake --add-missing
+dgt:~/dejagnu.test$ ./configure
+dgt:~/dejagnu.test$ make&#13;</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Play with calc and verify whether it works correctly.
+A sample session might look like this:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ ./calc 
+calc: version 
+Version: 1.1 
+calc:<I
+CLASS="EMPHASIS"
+> </I
+>add 3 4 
+7 
+calc: multiply 3 4<I
+CLASS="EMPHASIS"
+> </I
+>
+12 
+calc: multiply 2 4<I
+CLASS="EMPHASIS"
+> </I
+>
+12 
+calc: quit&#13;</PRE
+></TD
+></TR
+></TABLE
+><P
+>Look at the intentional bug that 2 times 4 equals 12.</P
+><P
+>The tests run by DejaGnu need a file called site.exp, 
+which is automatically generated if we call &#8220;make site.exp&#8221;. 
+This was the purpose of the &#8220;AUTOMAKE_OPTIONS = dejagnu&#8221; in Makefile.am.</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN273"
+></A
+><P
+><B
+>Example 6. Sample output generating a site.exp</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt: make site.exp 
+dgt:~/dejagnu.test$ make site.exp 
+Making a new site.exp file...</PRE
+></TD
+></TR
+></TABLE
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="gettingup.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="x276.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Getting DejaGnu up and running</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="gettingup.html"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Our first automated tests</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/x276.html b/doc/overview/x276.html

new file mode 100644 (file)

index 0000000..ca3a1d3
--- /dev/null
+++ b/doc/overview/x276.html
@@ -0,0 +1,440 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>Our first automated tests</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="UP"
+TITLE="Getting DejaGnu up and running"
+HREF="gettingup.html"><LINK
+REL="PREVIOUS"
+TITLE="Create a minimal project, e.g. calc"
+HREF="x227.html"><LINK
+REL="NEXT"
+TITLE="A first remote test"
+HREF="x319.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x227.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Getting DejaGnu up and running</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="x319.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN276"
+>Our first automated tests</A
+></H1
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN278"
+>Running the test for the calc example</A
+></H2
+><P
+>Now we are ready to call the automated tests </P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN281"
+></A
+><P
+><B
+>Example 7. Sample output of runtest in a configured directory</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ make check 
+make check-DEJAGNU 
+make[1]: Entering directory `/home/dgt/dejagnu.test' srcdir=`cd . &#38;&#38; pwd`; export srcdir; \ 
+EXPECT=expect; export EXPECT; \ runtest=runtest; \ 
+if /bin/sh -c "$runtest --version" &#62; /dev/null 2&#62;&#38;1; then \
+$runtest --tool calc CALC=`pwd`/calc --srcdir ./testsuite ; \ 
+else echo "WARNING: could not find \`runtest'" 1&#62;&#38;2; :;\ 
+fi 
+WARNING: Couldn't find the global config file. 
+WARNING: Couldn't find tool init file 
+Test Run By dgt on Sun Nov 25 21:42:21 2001 
+Native configuration is i586-pc-linux-gnu
+
+       === calc tests ===
+
+Schedule of variations: 
+   unix
+
+Running target unix 
+Using /usr/share/dejagnu/baseboards/unix.exp as board description file for target. 
+Using /usr/share/dejagnu/config/unix.exp as generic interface file for target. 
+Using ./testsuite/config/unix.exp as tool-and-target-specific interface file.
+Running ./testsuite/calc.test/calc.exp ... 
+FAIL: multiply2 (bad match)
+
+=== calc Summary ===
+
+# of expected passes 5 
+# of unexpected failures 1 
+/home/Dgt/dejagnu.test/calc version Version: 1.1
+make[1]: *** [check-DEJAGNU] Fehler 1 
+make[1]: Leaving directory `/home/Dgt/dejagnu.test' make: *** [check-am] Fehler 2</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Did you see the  line &#8220;FAIL:&#8220;? The test cases for calc catch the bug in the calc.c file. Fix the error in calc.c later as the following examples assume a unchanged calc.c.</P
+><P
+>Examine the output files calc.sum and calc.log. 
+Try to understand the testcases written in ~/dejagnu.test/testsuite/calc.test/calc.exp.
+To understand Expect you might take a look at the book "Exploring Expect",
+which is an excellent resource for learning and using Expect. (Pub: O'Reilly, ISBN 1-56592-090-2) 
+The book contains hundreds of examples and also includes a tutorial on Tcl. 
+Exploring Expect is 602 pages long. </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN286"
+>The various config files or how to avoid warnings</A
+></H2
+><P
+>DejaGnu may be customized by each user. It first searches for a file called ~/.dejagnurc. Create the file ~/.dejagnurc and insert the following line:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>puts "I am ~/.dejagnurc"</PRE
+></TD
+></TR
+></TABLE
+><P
+>Rerun make check. Test whether the output contains "I am ~/.dejagnurc". 
+Create ~/my_dejagnu.exp and insert the following line:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>puts "I am ~/my_dejagnu.exp"</PRE
+></TD
+></TR
+></TABLE
+><P
+>In a Bash-Shell enter</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ export DEJAGNU=~/my_dejagnu.exp</PRE
+></TD
+></TR
+></TABLE
+><P
+>Run &#8220;make check&#8221; again. The output should not contain 
+&#8220;WARNING: Couldn't find the global config file.&#8221;. 
+Create the sub-directory lib. Create the file &#8220;calc.exp&#8221; in it and insert the following line:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>puts "I am lib/calc.exp"</PRE
+></TD
+></TR
+></TABLE
+><P
+>The last warning &#8220;WARNING: Couldn't find tool init file&#8221; 
+should not be part of the output of make check. 
+Create the directory &#732;/boards. Create the file &#732;/boards/standard.exp and insert the following line:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>puts "I am boards/standard.exp"</PRE
+></TD
+></TR
+></TABLE
+><P
+>If the variable DEJAGNU is still not empty then the (abbreviated) output of &#8220;make check&#8221; should look like this:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN299"
+></A
+><P
+><B
+>Example 8. Sample output of runtest with the usual configuration files</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ make check 
+&#60;...&#62;
+fi 
+I am ~/.dejagnurc 
+I am ~/my_dejagnu.exp 
+I am lib/calc.exp 
+Test Run By dgt on Sun Nov 25 22:19:14 2001 
+Native configuration is i586-pc-linux-gnu
+
+     === calc tests ===
+Using /home/Dgt/boards/standard.exp as standard board description\
+file for build. 
+I am ~/boards/standard.exp 
+Using /home/Dgt/boards/standard.exp as standard board description\
+ file for host. 
+I am ~/boards/standard.exp 
+
+Schedule of variations: 
+  unix
+
+Running target unix 
+Using /home/Dgt/boards/standard.exp as standard board description\
+ file for target. 
+I am ~/boards/standard.exp 
+Using /usr/share/dejagnu/baseboards/unix.exp as board description file\
+for target. 
+&#60;...&#62;</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>It is up to you to decide when and where to use any of the above
+mentioned config files for customizing. 
+This chapters showed you where and in which order the different config 
+files are run.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN303"
+>When trouble strikes</A
+></H2
+><P
+>Calling runtest with the '-v'-flag shows you in even more details which files are searched in which order. Passing it several times gives more and more details. </P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN306"
+></A
+><P
+><B
+>Example 9. Displaying details about runtest execution</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>runtest -v -v -v --tool calc CALC=`pwd`/calc --srcdir ./testsuite</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Calling runtest with the '--debug'-flag logs a lot of details to dbg.log where you can analyse it afterwards. </P
+><P
+>In all test cases you can temporary adjust the verbosity of information by adding the following Tcl-command:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set verbose 9</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN312"
+>Testing &#8220;Hello world&#8221; locally</A
+></H2
+><P
+>This test checks, whether the built-in shell command &#8220;echo Hello world&#8221;
+ will really write &#8220;Hello world&#8221; on the console. 
+Create the file ~/dejagnu.test/testsuite/calc.test/local_echo.exp. 
+It should contain the following lines</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN315"
+></A
+><P
+><B
+>Example 10. A first (local) test case</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set test "Local Hello World" 
+send "echo Hello World" 
+expect { 
+   -re "Hello World"  { pass "$test" } 
+}</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Run runtest again and verify the output &#8220;calc.log&#8221;</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x227.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="x319.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Create a minimal project, e.g. calc</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="gettingup.html"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>A first remote test</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
diff --git a/doc/overview/x319.html b/doc/overview/x319.html

new file mode 100644 (file)

index 0000000..9958b9a
--- /dev/null
+++ b/doc/overview/x319.html
@@ -0,0 +1,632 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<HTML
+><HEAD
+><TITLE
+>A first remote test</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
+REL="HOME"
+TITLE="DejaGnu"
+HREF="book1.html"><LINK
+REL="UP"
+TITLE="Getting DejaGnu up and running"
+HREF="gettingup.html"><LINK
+REL="PREVIOUS"
+TITLE="Our first automated tests"
+HREF="x276.html"><LINK
+REL="NEXT"
+TITLE="Running Tests"
+HREF="runningtests.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>DejaGnu: The GNU Testing Framework</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x276.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Getting DejaGnu up and running</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="runningtests.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN319"
+>A first remote test</A
+></H1
+><P
+>Testing remote targets is a lot trickier especially if you are using an
+ embedded target
+which has no built in support for things like a compiler, ftp server or a Bash-shell. 
+Before you can test calc on a remote target you have to acquire a few basics skills.</P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN322"
+>Setup telnet to your own host</A
+></H2
+><P
+>The easiest remote host is usually the host you are working on. 
+In this example we will use telnet to login in your own workstation. 
+For security reason you should never have a telnet deamon running on 
+machine connected on the internet, as password and usernames are transmitted
+ in clear text. 
+We assume you know how to setup your machine for a telnet daemon.</P
+><P
+>Next try whether you may login in your own host by issuing the 
+command &#8220;telnet localhost.1&#8221;. In order to be able to 
+distinguish between a normal session an a telnet login add the following lines to /home/dgt/.bashrc.</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>if [ "$REMOTEHOST" ]
+then 
+   PS1='remote:\w\$ ' 
+fi</PRE
+></TD
+></TR
+></TABLE
+><P
+>Now on the machine a &#8220;remote&#8221; login looks like this:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN328"
+></A
+><P
+><B
+>Example 11. Sample log of a telnet login to localhost</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>dgt:~/dejagnu.test$ telnet localhost
+Trying 127.0.0.1... 
+Connected to 127.0.0.1. 
+Escape character is '^]'. 
+Debian GNU/Linux testing/unstable Linux 
+K6Linux login: dgt
+Password: 
+Last login: Sun Nov 25 22:46:34 2001 from localhost on pts/4 
+Linux K6Linux 2.4.14 #1 Fre Nov 16 19:28:25 CET 2001 i586 unknown 
+No mail. 
+remote:~$ exit
+logout 
+Connection closed by foreign host.</PRE
+></TD
+></TR
+></TABLE
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN331"
+>A test case for login via telnet</A
+></H2
+><P
+>In order to define a correct setup we have add a line containing 
+&#8220;set target unix&#8221; either to ~/.dejagnurc or to ~/my_dejagnu.exp. 
+In ~/boards/standard.exp add the following four lines to define a few patterns for the DejaGnu telnet login procedure.</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN334"
+></A
+><P
+><B
+>Example 12. Defining a remote target board</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set_board_info shell_prompt    "remote:" 
+set_board_info telnet_username "dgt" 
+set_board_info telnet_password "top_secret" 
+set_board_info hostname        "localhost"&#13;</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>As DejaGnu will be parsing the telnet session output for some well 
+known pattern the output there are a lot of things that can go wrong. 
+If you have any problems verify your setup:</P
+><P
+></P
+><UL
+><LI
+><P
+>Is <TT
+CLASS="FILENAME"
+>/etc/motd</TT
+> empty?</P
+></LI
+><LI
+><P
+>Is <TT
+CLASS="FILENAME"
+>/etc/issue.net</TT
+> empty?</P
+></LI
+><LI
+><P
+>Exists a empty <TT
+CLASS="FILENAME"
+>~/.hushlogin</TT
+>?</P
+></LI
+><LI
+><P
+>The LANG environment variable must be either empty or set to &#8220;C&#8221;. </P
+></LI
+></UL
+><P
+>To test the login via telnet write a sample test case. 
+Create the file ~/dejagnu.test/testsuite/calc.test/remote_echo.exp and 
+add the following few lines:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN351"
+></A
+><P
+><B
+>Example 13. DejaGnu script for logging in into a remote target</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>puts "this is remote_echo.exp target for $target "
+target_info $target 
+#set verbose 9 
+set shell_id [remote_open $target] 
+set test "Remote login to $target" 
+#set verbose 0
+puts "Spawn id for remote shell is $shell_id"
+if { $shell_id &#62; 0 } { 
+   pass "$test" 
+} else { 
+   fail "Remote open to $target" 
+}</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>In the runtest output you should find something like:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>Running ./testsuite/calc.test/local_echo.exp ... 
+Running ./testsuite/calc.test/remote_echoo.exp ... 
+this is remote_echo.exp target is unix 
+Spawn id for remote shell is exp7</PRE
+></TD
+></TR
+></TABLE
+><P
+>Have again a look at calc.log to get a feeling how DejaGnu and expect
+parse the input. </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN357"
+>Remote testing &#8220;Hello world&#8221;</A
+></H2
+><P
+>Next you will transform the above &#8220;hello world&#8221; example to 
+its remote equivalent. 
+This can be done by adding the following lines to our file remote_echo.exp.</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN360"
+></A
+><P
+><B
+>Example 14. A first (local) remote "Hello world" test</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set test "Remote_send Hello World" 
+set status [remote_send $target "echo \"Hello World\"\n" ]
+pass "$test"
+set test "Remote_expect Hello World" 
+remote_expect $target 5 { 
+   -re "Hello World"  { pass "$test" } 
+}</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Call make check. The output should contain
+&#8220;# of expected passes 9&#8221; and &#8220;# of unexcpected failures 1&#8221;.</P
+><P
+>Have a look at the procedures in /usr/share/dejagnu/remote.exp to have an overview of the offered procedures and their features. </P
+><P
+>Now setup a real target. 
+In the following example we assume as target a PowerBook running Debian. 
+As above add a test user "dgt", install telnet and FTP servers. 
+In order to distinguish it from the host add the line 
+<TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>PS1='test:&#62;'</PRE
+></TD
+></TR
+></TABLE
+> to /home/dgt/.bash_profile. 
+Also add a corresponding entry "powerbook" to /etc/hosts and verify that you 
+are able to ping, telnet and ftp to the target "powerbook".</P
+><P
+>In order to let runtest run its test on the "powerbook" target change the following lines in ~/boards/standard.exp:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN368"
+></A
+><P
+><B
+>Example 15. Board definition for a remote target</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set_board_info protocol        "telnet"
+set_board_info telnet_username "dgt"
+set_board_info telnet_password "top_secret"
+set_board_info shell_prompt    "test:&#62; "
+set_board_info hostname        "powerbook"</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Now call runtest again with the same arguments and verify whether all went okay by taking a close look at calc.log.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN372"
+>Transferring files from/to the target</A
+></H2
+><P
+>A simple procedure like this will do the job for you:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN375"
+></A
+><P
+><B
+>Example 16. Test script to transfer a file to a remote target</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set test "Remote_download"
+puts "Running Remote_download"
+# set verbose 9
+set remfile /home/dgt/dejagnu2
+
+set status [remote_download $target /home/dgt/.dejagnurc $remfile]
+if { "$status" == "" } {
+     fail "Remote download to $remfile on $target"
+} else {
+   pass "$test"
+}
+
+puts "status of remote_download ist $status"
+# set verbose 0</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>After running runtest again, check whether the file dejagnu2 exists on the target. 
+
+This example will only work if the rcp command works with your target.
+
+If you have a working FTP-server on the target you can use it by adding the 
+following lines to ~/boards/standard.exp:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN379"
+></A
+><P
+><B
+>Example 17. Defining a board to use FTP as file transport</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>set_board_info file_transfer   "ftp"
+set_board_info ftp_username    "dgt"
+set_board_info ftp_password    "1234"</PRE
+></TD
+></TR
+></TABLE
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN382"
+>Preparing for crosscompilation</A
+></H2
+><P
+>For crosscompiling you need working binutils, gcc and a base library like
+libc or glib for your target. 
+It is beyond the scope of this document to describe how to get it working. 
+The following examples assume a cross compiler for PowerPC which is called linux-powerpc-gcc.</P
+><P
+>Add AC_CANONICAL_TARGET in dejagnu.test/configure.in at the following location. Copy config.guess from /usr/share/automake to dejagnu.test.</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>AM_CONFIG_HEADER(calc.h)
+AC_CANONICAL_TARGET([]) 
+AM_INIT_AUTOMAKE(calc, 1.1)</PRE
+></TD
+></TR
+></TABLE
+><P
+>You need to run automake 2.5 or later. 
+Depending on your installation calling autoconf2.5 instead of autoconf is not needed. 
+The sequence to regenerate all files is:</P
+><DIV
+CLASS="EXAMPLE"
+><A
+NAME="AEN388"
+></A
+><P
+><B
+>Example 18. Using autotools for cross development</B
+></P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>$ autoconf2.5
+$ autoheader
+$ automake
+$ ./configure --host=powerpc-linux --target=powerpc-linux 
+configure: WARNING: If you wanted to set the --build type, don't use --host.
+    If a cross compiler is detected then cross compile mode will be used.
+checking build system type... ./config.guess: ./config.guess: No such file or directory
+configure: error: cannot guess build type; you must specify one
+$ cp /usr/share/automake/config.guess .
+$ ./configure --host=powerpc-linux --target=powerpc-linux 
+configure: WARNING: If you wanted to set the --build type, don't use --host.
+If a cross compiler is detected then cross compile mode will be used. \
+checking build system type... i586-pc-linux-gnu
+checking host system type... powerpc-unknown-linux-gnu
+&#60;...&#62;
+checking whether we are cross compiling... yes
+&#60;...&#62;
+Configuration:
+Source code location: .
+C Compiler: powerpc-linux-gcc
+C Compiler flags: -g -O2&#13;</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Everything should be ready to recompile for the target:</P
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>$ make
+powerpc-linux-gcc -DHAVE_CONFIG_H -I. -I. -I. -g -O2 -c calc.c 
+powerpc-linux-gcc -g -O2 -o calc calc.o&#13;</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN393"
+>Remote testing of calc</A
+></H2
+><P
+>Not yet written, as I have problem getting libc6-dev-powerpc to work. Probably I first have to build my cross compiler. </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN396"
+>Using WindowsNT as host and vxWorks as target</A
+></H2
+><P
+>A more thorough walk-through will be written in a few weeks.</P
+><P
+>In order to test the vxWorks as a target I changed boards/standards.exp to reflect my settings (IP, username, password). Then I reconfigured vxWorks to include a FTP and telnet server (using the same username/password combination ad in boards/standard.exp).</P
+><P
+>With this setup and some minor modification (e.g. replacing echo by printf) in my test cases I could test my vxWorks system. It sure does not seem to be a correct setup by DejaGnu standard. For instance, it still loading /usr/share/dejagnu/baseboards/unix.exp instead of vxWorks. In any case I found that (at least under WindowsNT) I did not find out how the command line would let me override settings in my personal config files.</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x276.html"
+>&#60;&#60;&#60; Previous</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="book1.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="runningtests.html"
+>Next &#62;&#62;&#62;</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Our first automated tests</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="gettingup.html"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Running Tests</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
+\ No newline at end of file
author	Rob Savoye <rob@welcomehome.org>
	Sat, 31 Aug 2002 05:44:56 +0000 (05:44 +0000)
committer	Rob Savoye <rob@welcomehome.org>
	Sat, 31 Aug 2002 05:44:56 +0000 (05:44 +0000)
doc/overview/addboard.html		patch \| blob \| history
doc/overview/adding.html		patch \| blob \| history
doc/overview/addtarget.html		patch \| blob \| history
doc/overview/addtool.html		patch \| blob \| history
doc/overview/boardconfig.html		patch \| blob \| history
doc/overview/boarddefs.html		patch \| blob \| history
doc/overview/book1.html		patch \| blob \| history
doc/overview/builtins.html		patch \| blob \| history
doc/overview/configfile.html		patch \| blob \| history
doc/overview/cppunit.html	[new file with mode: 0644]	patch \| blob
doc/overview/customizing.html		patch \| blob \| history
doc/overview/debugging.html		patch \| blob \| history
doc/overview/designgoals.html		patch \| blob \| history
doc/overview/djh.html	[new file with mode: 0644]	patch \| blob
doc/overview/extending.html		patch \| blob \| history
doc/overview/filemap.html		patch \| blob \| history
doc/overview/gettingup.html	[new file with mode: 0644]	patch \| blob
doc/overview/global.html		patch \| blob \| history
doc/overview/hints.html		patch \| blob \| history
doc/overview/installation.html		patch \| blob \| history
doc/overview/new.html		patch \| blob \| history
doc/overview/outputfiles.html		patch \| blob \| history
doc/overview/overview.html		patch \| blob \| history
doc/overview/posix.html		patch \| blob \| history
doc/overview/preface.html		patch \| blob \| history
doc/overview/reference.html		patch \| blob \| history
doc/overview/releng.html		patch \| blob \| history
doc/overview/runningtests.html		patch \| blob \| history
doc/overview/runtest.html		patch \| blob \| history
doc/overview/tvariables.html		patch \| blob \| history
doc/overview/unit.html	[new file with mode: 0644]	patch \| blob
doc/overview/unittestapi.html	[new file with mode: 0644]	patch \| blob
doc/overview/writing.html		patch \| blob \| history
doc/overview/x227.html	[new file with mode: 0644]	patch \| blob
doc/overview/x276.html	[new file with mode: 0644]	patch \| blob
doc/overview/x319.html	[new file with mode: 0644]	patch \| blob