~ubuntu-branches/ubuntu/intrepid/dejagnu/intrepid : revision 4

30

<emphasis>autoconf</emphasis> to configure itself. For more info on using

31

autoconf, read the GNU autoconf manual. To configure, execute the

32

<filename>configure</filename> program, no other options are

33

required. For an example, to configure in a seperate tree for objects,

33

required. For an example, to configure in a separate tree for objects,

34

execute the configure script from the source tree like this:</para>

35

36

74

eg$ make install

75

</screen>

76

77

<para><emphasis>make install</emphasis>does thes things for

77

<para><emphasis>make install</emphasis>does these things for

78

&dj;:</para>

79

80

205

<title>is3way Procedure</title>

206

207

<para>Tests for a canadian cross. This is when the tests will be run

208

on a remotly hosted cross compiler. If it is a canadian cross, then

208

on a remotely hosted cross compiler. If it is a canadian cross, then

209

the result is <emphasis>1</emphasis>; otherwise the result is

210

211

402

403

<warning><para>Warning you must clear the expected failure after

404

using setup_xfail in a test case. Any call to <function>pass

405

</function>or <function>fail</function>l clears the expected failure

405

</function>or <function>fail</function> clears the expected failure

406

implicitly; if the test has some other outcome, e.g. an error, you

407

can call <function>clear_xfail</function> to clear the expected

408

failure explicitly. Otherwise, the expected-failure declaration

424

</varlistentry>

425

426

<term><parameter>bugid</parameter></term>

427

<listitem><para>The optional bugid, used to tie it this test case

427

<listitem><para>The optional bugid, used to tie this test case

428

to a bug tracking system.</para></listitem>

429

</varlistentry>

430

</variablelist>

636

</varlistentry>

637

638

<term><parameter>number</parameter></term>

639

<listitem><para>The optional number to set the error counter. Thius

639

<listitem><para>The optional number to set the error counter. This

640

is only used to fake out the counter when using the

641

<function>xfail</function> procedure to control when it flips the

642

output over to <emphasis>UNRESOLVED</emphasis>

678

</varlistentry>

679

680

<term><parameter>number</parameter></term>

681

<listitem><para>The optional number to set the error counter. Thius

681

<listitem><para>The optional number to set the error counter. This

682

is only used to fake out the counter when using the

683

<function>xfail</function> procedure to control when it flips the

684

output over to <emphasis>UNRESOLVED</emphasis>

922

923

<para>What this does is it matches only for these two targets if

924

"-Wall -v" or "-O3" is set, but neither "-O1" or "-Map" is set. For

925

a set to match, the options specified are searched for independantly

925

a set to match, the options specified are searched for independently

926

of each other, so a "-Wall -v" matches either "-Wall -v" or "-v

927

-Wall". A space seperates the options in the string. Glob-style

927

-Wall". A space separates the options in the string. Glob-style

928

regular expressions are also permitted.</para>

929

930

</sect4>

2055

2056

</varlistentry>

2057

2058

<term><parameter>commndline</parameter></term>

2058

<term><parameter>commandline</parameter></term>

2059

2060

</varlistentry>

2061

</variablelist>

2236

<parameter>netport</parameter> field in the

2237

<symbol>target_info</symbol> array is used. (was

2238

<symbol>$netport</symbol>) This value has two parts,

2239

the hostname and the port number, seperated by a

2239

the hostname and the port number, separated by a

2240

<emphasis>:</emphasis>. If host or target is used in

2241

the <symbol>hostname</symbol> field, than the

2242

config array is used for all information.</para></listitem>

2781

2782

2783

<listitem><para>This is the filename to

2784

downlaod.</para></listitem>

2784

download.</para></listitem>

2785

</varlistentry>

2786

</variablelist>

2787

</sect4>

3403

</sect4>

3404

3405

</sect3>

3406

3407

<title>Platform Dependant Procedures</title>

3406

3407

<title>Platform Dependent Procedures</title>

3408

3409

<para>Each combination of target and tool requires some

3410

target-dependent procedures. The names of these procedures have

3558

<emphasis>*</emphasis>. You may use the common shell

3559

wildcard characters in the pattern. If no directories

3560

match the pattern, then a NULL string is

3561

returned</para></listitem>

3561

returned.</para></listitem>

3562

</varlistentry>

3563

</variablelist>

3564

</sect4>

3589

</varlistentry>

3590

3591

<term><parameter>pattern</parameter></term>

3592

<listitem><para>A csh "glob" style regular expression reprsenting

3592

<listitem><para>A csh "glob" style regular expression representing

3593

the files to find.</para></listitem>

3594

</varlistentry>

3595

</variablelist>

3599

<title>Which Procedure</title>

3600

3601

<para>Searches the execution path for an executable file

3602

<emphasis>binary</emphasis>, like the the BSD <command>which</command>

3602

<emphasis>binary</emphasis>, like the BSD <command>which</command>

3603

utility. This procedure uses the shell environment variable

3604

<emphasis>PATH</emphasis>. It returns <emphasis>0</emphasis> if the

3605

binary is not in the path, or if there is no <emphasis>PATH</emphasis>

4470

4471

<title>Watchdel Procedure</title>

4472

4473

<para>This deletes a the watchpoint from the watch list. It is

4473

<para>This deletes a watchpoint from the watch list. It is

4474

abbreviated as <emphasis>wd</emphasis>.</para>

4475

4476

4577

4578

<para>All of the functions that take a

4579

<parameter>msg</parameter> parameter use a C char * that is

4580

the message to be dislayed. There currently is no support for

4580

the message to be displayed. There currently is no support for

4581

variable length arguments.</para>

4582

4583

4663

<para>All of the methods that take a

4664

<parameter>msg</parameter> parameter use a C char *

4665

or STL string, that is the message to be

4666

dislayed. There currently is no support for variable

4666

displayed. There currently is no support for variable

4667

length arguments.</para>

4668

4669