* doc/ref.xml: Likewise.
* doc/dejagnu.texi: Regenerate.
Signed-off-by: Ben Elliston <bje@gnu.org>
2013-06-15 Bernhard Reutner-Fischer <aldot@gcc.gnu.org>
+ * doc/user.xml: Fix rendering errors around programlisting.
+ * doc/ref.xml: Likewise.
+ * doc/dejagnu.texi: Regenerate.
+
+2013-06-15 Bernhard Reutner-Fischer <aldot@gcc.gnu.org>
+
* doc/user.xml: Fix spacing before productname.
* doc/dejagnu.texi: Regenerate.
apt-get install dejagnu
@end example
-@noindent
These examples were run on a primary machine with a AMD K6 and a Mac
Powerbook G3 serving as a remote target.
PS1='test:>'
@end example
-@noindent
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".
@file{site.exp}. @ref{Invoking Runtest}, for
explanations of the command-line options.
-
@strong{Tcl Variables For Command Line Options}
@multitable @columnfractions 0.2 0.2 0.2 0.2 0.2
parameters are the field name, followed by the value to set the field
to.
-
@strong{Common Board Info Fields}
@multitable @columnfractions 0.333333333333333 0.333333333333333 0.333333333333333
purpose is esoteric. These are listed with sample values as a guide to
better guessing if you need to change any of these.
-
@strong{Board Info Fields For GCC & GDB}
@multitable @columnfractions 0.333333333333333 0.333333333333333 0.333333333333333
the tool of interest to see which (if any) is most suitable.
Adding a GCC test can be very simple: just add the C code
-to any directory beginning with @file{gcc}. and it
-runs on the next
+to any directory beginning with @file{gcc} and it
+runs on the next:
@example
-runtest --tool
- gcc
+runtest --tool gcc
@end example
-@noindent
-.
-
To add a test to GDB, first add any source code you will
need to the test directory. Then you can either create a new
expect file, or add your test to an existing one (any
Always escape punctuation, such as @emph{(}
or @emph{"}, in your patterns; for example, write
@emph{\(}. If you forget to escape punctuation,
-you will usually see an error message like
+you will usually see an error message like:
@example
-extra
- characters after close-quote.
+extra characters after close-quote
@end example
If you have trouble understanding why a pattern does not
exclude. This makes a result be a @emph{FAIL}, even if
the included options are found. To set the conditional, set
the variable @code{compiler_conditional_xfail_data} to the
-fields
+fields
@example
-"[message string] [targets list] [includes
- list] [excludes list]"
+
+ "[message string] [targets list] [includes list] [excludes list]"
+
@end example
-@noindent
(descriptions below). This is
the checked at pass/fail decision time, so there is no need to call
the procedure yourself, unless you wish to know if it gets
@emph{testcase} and return @emph{1} if
found, @emph{0} if not. @emph{runtests}
is a list of two elements. The first is a copy of what was on
-the right side of the @emph{=} if
+the right side of the @emph{=} if
@example
foo.exp="..."
@end example
-@noindent
-" was specified, or
+was specified, or
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.
exclude. This makes a result be a <emphasis>FAIL</emphasis>, even if
the included options are found. To set the conditional, set
the variable <symbol>compiler_conditional_xfail_data</symbol> to the
- fields <programlisting>"[message string] [targets list] [includes
- list] [excludes list]"</programlisting> (descriptions below). This is
+ fields</para>
+ <programlisting>
+ "[message string] [targets list] [includes list] [excludes list]"
+ </programlisting>
+ <para> (descriptions below). This is
the checked at pass/fail decision time, so there is no need to call
the procedure yourself, unless you wish to know if it gets
triggered. After a pass/fail, the variable is reset, so it doesn't
<emphasis>testcase</emphasis> and return <emphasis>1</emphasis> if
found, <emphasis>0</emphasis> if not. <emphasis>runtests</emphasis>
is a list of two elements. The first is a copy of what was on
- the right side of the <emphasis>=</emphasis> if
- <programlisting>foo.exp="..."</programlisting>" was specified, or
+ the right side of the <emphasis>=</emphasis> if</para>
+ <programlisting>foo.exp="..."</programlisting>
+ <para>was specified, or
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.</para>
<para>It should be no big problems installing &dj; using your package
manager or from the source code. On the Debian GNU/Linux system just
-run (as root):
+run (as root):</para>
<programlisting>apt-get install dejagnu</programlisting>
-
+<para>
These examples were run on a primary machine with a AMD K6 and a Mac
Powerbook G3 serving as a remote target.</para>
<para>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
-<programlisting>PS1='test:>'</programlisting> to /home/dgt/.bash_profile.
+In order to distinguish it from the host add the line</para>
+<programlisting>PS1='test:>'</programlisting>
+<para> 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".</para>
<filename>site.exp</filename>. <xref linkend="invoking"/>, for
explanations of the command-line options.</para>
- <para><table frame="all" rowsep="0" colsep="0">
+ <table frame="all" rowsep="0" colsep="0">
<title>Tcl Variables For Command Line Options</title>
<tgroup cols="5" align="char" rowsep="1" colsep="0">
</tbody>
</tgroup>
- </table>
- </para>
+ </table>
</sect3>
parameters are the field name, followed by the value to set the field
to.</para>
- <para><table frame="all" rowsep="0" colsep="0">
+ <table frame="all" rowsep="0" colsep="0">
<title>Common Board Info Fields</title>
<tgroup cols="3" align="char" rowsep="1" colsep="0">
</tbody>
</tgroup>
- </table>
- </para>
+ </table>
<para>These fields are used by the GCC and GDB tests, and are mostly
only useful to somewhat trying to debug a new board file for one of
purpose is esoteric. These are listed with sample values as a guide to
better guessing if you need to change any of these.</para>
- <para><table frame="all" rowsep="0" colsep="0">
+ <table frame="all" rowsep="0" colsep="0">
<title>Board Info Fields For GCC & GDB</title>
<tgroup cols="3" align="char" rowsep="1" colsep="0">
</tbody>
</tgroup>
- </table>
- </para>
+ </table>
</sect2>
the tool of interest to see which (if any) is most suitable.</para>
<para>Adding a GCC test can be very simple: just add the C code
- to any directory beginning with <filename>gcc</filename>. and it
- runs on the next <programlisting>runtest --tool
- gcc</programlisting>.</para>
+ to any directory beginning with <filename>gcc</filename> and it
+ runs on the next: </para>
+ <programlisting>runtest --tool gcc</programlisting>
<para>To add a test to GDB, first add any source code you will
need to the test directory. Then you can either create a new
<para>Always escape punctuation, such as <emphasis>(</emphasis>
or <emphasis>"</emphasis>, in your patterns; for example, write
<emphasis>\(</emphasis>. If you forget to escape punctuation,
- you will usually see an error message like <programlisting>extra
- characters after close-quote.</programlisting></para>
+ you will usually see an error message like:</para>
+ <programlisting>extra characters after close-quote</programlisting>
<para>If you have trouble understanding why a pattern does not
match the program output, try using the <option>--debug</option>