diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/dejagnu.texi | 419 |
1 files changed, 209 insertions, 210 deletions
diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi index 8ee5953..d6f6881 100644 --- a/doc/dejagnu.texi +++ b/doc/dejagnu.texi @@ -53,7 +53,7 @@ Free Documentation License''. * Customizing DejaGnu:: * Extending DejaGnu:: * Unit testing:: -* Reference:: +* Built-in Procedures:: * GNU Free Documentation License:: * Concept Index:: * Procedure Index:: @@ -104,7 +104,13 @@ Unit testing Reference -* Builtin Procedures:: +* Built-in Procedures:: + +Indices + +* Concept Index:: +* Procedure Index:: +* Variable Index:: @end detailmenu @end menu @@ -2173,7 +2179,7 @@ The output from the last command. This is an internal variable set by Expect. More information can be found in the Expect manual. @end table -@node Unit testing, Reference, Extending DejaGnu, Top +@node Unit testing, Built-in Procedures, Extending DejaGnu, Top @chapter Unit testing @menu @@ -2311,15 +2317,8 @@ outputs. @end itemize -@node Reference, GNU Free Documentation License, Unit testing, Top -@appendix Framework reference - -@menu -* Builtin Procedures:: -@end menu - -@node Builtin Procedures, , , Reference -@section Builtin Procedures +@node Built-in Procedures, GNU Free Documentation License, Unit testing, Top +@appendix Built-in Procedures DejaGnu provides these Tcl procedures. @@ -2335,8 +2334,8 @@ DejaGnu provides these Tcl procedures. * Debugging Procedures:: @end menu -@node Core Internal Procedures, Procedures For Remote Communication, , Builtin Procedures -@subsection Core Internal Procedures +@node Core Internal Procedures, Procedures For Remote Communication, , Built-in Procedures +@section Core Internal Procedures @menu * open_logs Procedure: open_logs procedure @@ -2371,7 +2370,7 @@ DejaGnu provides these Tcl procedures. @end menu @node open_logs procedure, close_logs procedure, , Core Internal Procedures -@subsubsection open_logs Procedure +@subsubheading open_logs Procedure @findex open_logs Open the output logs. @@ -2381,7 +2380,7 @@ Open the output logs. @end quotation @node close_logs procedure, isbuild procedure, open_logs procedure, Core Internal Procedures -@subsubsection close_logs Procedure +@subsubheading close_logs Procedure @findex close_logs Close the output logs. @@ -2391,7 +2390,7 @@ Close the output logs. @end quotation @node isbuild procedure, isremote procedure, close_logs procedure, Core Internal Procedures -@subsubsection isbuild Procedure +@subsubheading isbuild Procedure @findex isbuild Tests for a particular build host environment. If the currently @@ -2407,7 +2406,7 @@ an empty pattern, this procedure returns the build system triplet. @end quotation @node isremote procedure, is_remote procedure, isbuild procedure, Core Internal Procedures -@subsubsection isremote Procedure +@subsubheading isremote Procedure @findex isremote Is @i{board} remote? Return a non-zero value, if so. @@ -2419,7 +2418,7 @@ Is @i{board} remote? Return a non-zero value, if so. This procedure is to be used instead of @code{is_remote}. @node is_remote procedure, is3way procedure, isremote procedure, Core Internal Procedures -@subsubsection is_remote Procedure +@subsubheading is_remote Procedure @findex is_remote Is @i{board} remote? Return a non-zero value, if so. @@ -2431,7 +2430,7 @@ Is @i{board} remote? Return a non-zero value, if so. Note that this procedure is now depreciated. Use @code{isremote} instead. @node is3way procedure, ishost procedure, is_remote procedure, Core Internal Procedures -@subsubsection is3way Procedure +@subsubheading is3way Procedure @findex is3way Tests for a Canadian cross. This is when the tests will be run on a @@ -2443,7 +2442,7 @@ result is @emph{1}; otherwise @emph{0}. @end quotation @node ishost procedure, istarget procedure, is3way procedure, Core Internal Procedures -@subsubsection ishost Procedure +@subsubheading ishost Procedure @findex ishost Tests for a particular host environment. If the currently configured @@ -2459,7 +2458,7 @@ procedure returns the host triplet. @end quotation @node istarget procedure, isnative procedure, ishost procedure, Core Internal Procedures -@subsubsection istarget Procedure +@subsubheading istarget Procedure @findex istarget Tests for a particular target environment. If the currently configured @@ -2475,7 +2474,7 @@ this procedure returns the target triplet. @end quotation @node isnative procedure, log_and_exit procedure, istarget procedure, Core Internal Procedures -@subsubsection isnative Procedure +@subsubheading isnative Procedure @findex isnative This procedure returns @emph{1} if the current configuration has the @@ -2487,7 +2486,7 @@ returns @emph{0}. @end quotation @node log_and_exit procedure, log_summary procedure, isnative procedure, Core Internal Procedures -@subsubsection log_and_exit Procedure +@subsubheading log_and_exit Procedure @findex log_and_exit @quotation @@ -2498,7 +2497,7 @@ This procedure writes out the end of the test log and terminates @code{runtest}. @node log_summary procedure, setup_xfail procedure, log_and_exit procedure, Core Internal Procedures -@subsubsection log_summary Procedure +@subsubheading log_summary Procedure @findex log_summary @quotation @@ -2510,7 +2509,7 @@ This procedure writes out the end of the test log and terminates @code{runtest}. @end table @node setup_xfail procedure, pass procedure, log_summary procedure, Core Internal Procedures -@subsubsection setup_xfail Procedure +@subsubheading setup_xfail Procedure @findex setup_xfail Declares that the test is expected to fail on a particular set of @@ -2553,7 +2552,7 @@ The optional bugid, used to tie this test case to a bug tracking system. @end table @node pass procedure, fail procedure, setup_xfail procedure, Core Internal Procedures -@subsubsection pass Procedure +@subsubheading pass Procedure @findex pass Declares a test to have passed. @code{pass} writes in the log files a @@ -2565,7 +2564,7 @@ expected), appending the @code{message} argument. @end quotation @node fail procedure, xpass procedure, pass procedure, Core Internal Procedures -@subsubsection fail Procedure +@subsubheading fail Procedure @findex fail Declares a test to have failed. @code{fail} writes in the log files a @@ -2577,7 +2576,7 @@ expected), appending the @code{message} argument. @end quotation @node xpass procedure, xfail procedure, fail procedure, Core Internal Procedures -@subsubsection xpass Procedure +@subsubheading xpass Procedure @findex xpass Declares a test to have passed when it was expected to fail. @@ -2590,7 +2589,7 @@ Declares a test to have passed when it was expected to fail. @end quotation @node xfail procedure, set_warning_threshold procedure, xpass procedure, Core Internal Procedures -@subsubsection xfail Procedure +@subsubheading xfail Procedure @findex xfail Declares a test to have expectedly failed. @code{xfail} writes in the @@ -2602,7 +2601,7 @@ success was expected), appending the @code{message} argument. @end quotation @node set_warning_threshold procedure, get_warning_threshold procedure, xfail procedure, Core Internal Procedures -@subsubsection set_warning_threshold Procedure +@subsubheading set_warning_threshold Procedure @findex set_warning_threshold Sets the value of @code{warning_threshold}. A value of @emph{0} disables @@ -2620,7 +2619,7 @@ This is the value of the new warning threshold. @end table @node get_warning_threshold procedure, warning procedure, set_warning_threshold procedure, Core Internal Procedures -@subsubsection get_warning_threshold Procedure +@subsubheading get_warning_threshold Procedure @findex get_warning_threshold Returns the current value of @code{@{warning_threshold}. The default @@ -2632,7 +2631,7 @@ be called before becoming @emph{UNRESOLVED}. @end quotation @node warning procedure, perror procedure, get_warning_threshold procedure, Core Internal Procedures -@subsubsection warning Procedure +@subsubheading warning Procedure @findex warning Declares detection of a minor error in the test case @@ -2668,7 +2667,7 @@ flips the output over to @emph{UNRESOLVED} state. @end table @node perror procedure, note procedure, warning procedure, Core Internal Procedures -@subsubsection perror Procedure +@subsubheading perror Procedure @findex perror Declares a severe error in the testing framework itself. @code{perror} @@ -2699,7 +2698,7 @@ flips the output over to @emph{UNRESOLVED} state. @end table @node note procedure, untested procedure, perror procedure, Core Internal Procedures -@subsubsection note Procedure +@subsubheading note Procedure @findex note Appends an informational message to the log file. @code{note} writes in @@ -2715,7 +2714,7 @@ needed in the log file regardless of the verbosity level use @node untested procedure, unresolved procedure, note procedure, Core Internal Procedures -@subsubsection untested Procedure +@subsubheading untested Procedure @findex untested Declares a test was not run. @code{untested} writes in the log file a @@ -2729,7 +2728,7 @@ role is to record that a test does not yet exist for some feature. @node unresolved procedure, unsupported procedure, untested procedure, Core Internal Procedures -@subsubsection unresolved Procedure +@subsubheading unresolved Procedure @findex unresolved Declares a test to have an unresolved outcome. @code{unresolved} writes @@ -2744,7 +2743,7 @@ if it passed or failed (and to improve the test case). @node unsupported procedure, transform procedure, unresolved procedure, Core Internal Procedures -@subsubsection unsupported Procedure +@subsubheading unsupported Procedure @findex unsupported Declares that a test case depends on some facility that does not exist @@ -2758,7 +2757,7 @@ argument. @node transform procedure, check_conditional_xfail procedure, unsupported procedure, Core Internal Procedures -@subsubsection transform Procedure +@subsubheading transform Procedure @findex transform Generates a string for the name of a tool as it was configured and @@ -2779,7 +2778,7 @@ The name of the cross-development program to transform. @end table @node check_conditional_xfail procedure, clear_xfail procedure, transform procedure, Core Internal Procedures -@subsubsection check_conditional_xfail Procedure +@subsubheading check_conditional_xfail Procedure @findex check_conditional_xfail This procedure adds a conditional xfail, based on compiler options used @@ -2848,7 +2847,7 @@ of each other, so a "-Wall -v" matches either "-Wall -v" or "-v regular expressions are also permitted. @node clear_xfail procedure, verbose procedure, check_conditional_xfail procedure, Core Internal Procedures -@subsubsection clear_xfail Procedure +@subsubheading clear_xfail Procedure @findex clear_xfail Cancel an expected failure (previously declared with @code{setup_xfail}) @@ -2868,7 +2867,7 @@ The system triplets to clear. @end table @node verbose procedure, load_lib procedure, clear_xfail procedure, Core Internal Procedures -@subsubsection verbose Procedure +@subsubheading verbose Procedure @findex verbose Test cases can use this procedure to issue helpful messages depending on @@ -2909,7 +2908,7 @@ The specified log level. The default level is 1. @end table @node load_lib procedure, , verbose procedure, Core Internal Procedures -@subsubsection load_lib Procedure +@subsubheading load_lib Procedure @findex load_lib @code{load_lib} loads a DejaGnu library file by searching the default @@ -2944,8 +2943,8 @@ lappend libdirs $srcdir/../../gcc/testsuite/lib load_lib foo.exp @end example -@node Procedures For Remote Communication, connprocs, Core Internal Procedures, Builtin Procedures -@subsection Procedures For Remote Communication +@node Procedures For Remote Communication, connprocs, Core Internal Procedures, Built-in Procedures +@section Procedures For Remote Communication @file{lib/remote.exp} defines procedures for establishing and managing communications. Each of these procedures tries to establish the @@ -3010,7 +3009,7 @@ line, then the target is rebooted before the connection is made. @end menu @node call_remote procedure, check_for_board_status procedure, , Procedures For Remote Communication -@subsubsection call_remote Procedure +@subsubheading call_remote Procedure @findex call_remote @quotation @@ -3027,7 +3026,7 @@ line, then the target is rebooted before the connection is made. @end table @node check_for_board_status procedure, file_on_build procedure, call_remote procedure, Procedures For Remote Communication -@subsubsection check_for_board_status Procedure +@subsubheading check_for_board_status Procedure @findex check_for_board_status @quotation @@ -3040,7 +3039,7 @@ line, then the target is rebooted before the connection is made. @end table @node file_on_build procedure, file_on_host procedure, check_for_board_status procedure, Procedures For Remote Communication -@subsubsection file_on_build Procedure +@subsubheading file_on_build Procedure @findex file_on_build @quotation @@ -3056,7 +3055,7 @@ line, then the target is rebooted before the connection is made. @end table @node file_on_host procedure, local_exec procedure, file_on_build procedure, Procedures For Remote Communication -@subsubsection file_on_host Procedure +@subsubheading file_on_host Procedure @findex file_on_host @quotation @@ -3072,7 +3071,7 @@ line, then the target is rebooted before the connection is made. @end table @node local_exec procedure, remote_binary procedure, file_on_host procedure, Procedures For Remote Communication -@subsubsection local_exec Procedure +@subsubheading local_exec Procedure @findex local_exec @quotation @@ -3089,7 +3088,7 @@ line, then the target is rebooted before the connection is made. @end table @node remote_binary procedure, remote_close procedure, local_exec procedure, Procedures For Remote Communication -@subsubsection remote_binary Procedure +@subsubheading remote_binary Procedure @findex remote_binary @quotation @@ -3101,7 +3100,7 @@ line, then the target is rebooted before the connection is made. @end table @node remote_close procedure, remote_download procedure, remote_binary procedure, Procedures For Remote Communication -@subsubsection remote_close Procedure +@subsubheading remote_close Procedure @findex remote_close @quotation @@ -3118,7 +3117,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_download procedure, remote_exec procedure, remote_close procedure, Procedures For Remote Communication -@subsubsection remote_download Procedure +@subsubheading remote_download Procedure @findex remote_download @quotation @@ -3134,7 +3133,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_exec procedure, remote_expect procedure, remote_download procedure, Procedures For Remote Communication -@subsubsection remote_exec Procedure +@subsubheading remote_exec Procedure @findex remote_exec @quotation @@ -3150,7 +3149,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_expect procedure, remote_file procedure, remote_exec procedure, Procedures For Remote Communication -@subsubsection remote_expect Procedure +@subsubheading remote_expect Procedure @findex remote_expect @quotation @@ -3166,7 +3165,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_file procedure, remote_ld procedure, remote_expect procedure, Procedures For Remote Communication -@subsubsection remote_file Procedure +@subsubheading remote_file Procedure @findex remote_file @quotation @@ -3182,7 +3181,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_ld procedure, remote_load procedure, remote_file procedure, Procedures For Remote Communication -@subsubsection remote_ld Procedure +@subsubheading remote_ld Procedure @findex remote_ld @quotation @@ -3196,7 +3195,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_load procedure, remote_open procedure, remote_ld procedure, Procedures For Remote Communication -@subsubsection remote_load Procedure +@subsubheading remote_load Procedure @findex remote_load @quotation @@ -3212,7 +3211,7 @@ parameter can be left off if the @code{fileid} field in the @end table @node remote_open procedure, remote_pop_conn procedure, remote_load procedure, Procedures For Remote Communication -@subsubsection remote_open Procedure +@subsubheading remote_open Procedure @findex remote_open @quotation @@ -3233,7 +3232,7 @@ in the @code{target_info} array. @end table @node remote_pop_conn procedure, remote_push_conn procedure, remote_open procedure, Procedures For Remote Communication -@subsubsection remote_pop_conn Procedure +@subsubheading remote_pop_conn Procedure @findex remote_pop_conn @quotation @@ -3245,7 +3244,7 @@ in the @code{target_info} array. @end table @node remote_push_conn procedure, remote_raw_binary procedure, remote_pop_conn procedure, Procedures For Remote Communication -@subsubsection remote_push_conn Procedure +@subsubheading remote_push_conn Procedure @findex remote_push_conn @quotation @@ -3257,7 +3256,7 @@ in the @code{target_info} array. @end table @node remote_raw_binary procedure, remote_raw_close procedure, remote_push_conn procedure, Procedures For Remote Communication -@subsubsection remote_raw_binary Procedure +@subsubheading remote_raw_binary Procedure @findex remote_raw_binary @quotation @@ -3269,7 +3268,7 @@ in the @code{target_info} array. @end table @node remote_raw_close procedure, remote_raw_file procedure, remote_raw_binary procedure, Procedures For Remote Communication -@subsubsection remote_raw_close Procedure +@subsubheading remote_raw_close Procedure @findex remote_raw_close @quotation @@ -3281,7 +3280,7 @@ in the @code{target_info} array. @end table @node remote_raw_file procedure, remote_raw_ld procedure, remote_raw_close procedure, Procedures For Remote Communication -@subsubsection remote_raw_file Procedure +@subsubheading remote_raw_file Procedure @findex remote_raw_file @quotation @@ -3296,7 +3295,7 @@ in the @code{target_info} array. @end table @node remote_raw_ld procedure, remote_raw_load procedure, remote_raw_file procedure, Procedures For Remote Communication -@subsubsection remote_raw_ld Procedure +@subsubheading remote_raw_ld Procedure @findex remote_raw_ld @quotation @@ -3310,7 +3309,7 @@ in the @code{target_info} array. @end table @node remote_raw_load procedure, remote_raw_open procedure, remote_raw_ld procedure, Procedures For Remote Communication -@subsubsection remote_raw_load Procedure +@subsubheading remote_raw_load Procedure @findex remote_raw_load @quotation @@ -3326,7 +3325,7 @@ in the @code{target_info} array. @end table @node remote_raw_open procedure, remote_raw_send procedure, remote_raw_load procedure, Procedures For Remote Communication -@subsubsection remote_raw_open Procedure +@subsubheading remote_raw_open Procedure @findex remote_raw_open @quotation @@ -3338,7 +3337,7 @@ in the @code{target_info} array. @end table @node remote_raw_send procedure, remote_raw_spawn procedure, remote_raw_open procedure, Procedures For Remote Communication -@subsubsection remote_raw_send Procedure +@subsubheading remote_raw_send Procedure @findex remote_raw_send @quotation @@ -3353,7 +3352,7 @@ in the @code{target_info} array. @end table @node remote_raw_spawn procedure, remote_raw_transmit procedure, remote_raw_send procedure, Procedures For Remote Communication -@subsubsection remote_raw_spawn Procedure +@subsubheading remote_raw_spawn Procedure @findex remote_raw_spawn @quotation @@ -3367,7 +3366,7 @@ in the @code{target_info} array. @end table @node remote_raw_transmit procedure, remote_raw_wait procedure, remote_raw_spawn procedure, Procedures For Remote Communication -@subsubsection remote_raw_transmit Procedure +@subsubheading remote_raw_transmit Procedure @findex remote_raw_transmit @quotation @@ -3381,7 +3380,7 @@ in the @code{target_info} array. @end table @node remote_raw_wait procedure, remote_reboot procedure, remote_raw_transmit procedure, Procedures For Remote Communication -@subsubsection remote_raw_wait Procedure +@subsubheading remote_raw_wait Procedure @findex remote_raw_wait @quotation @@ -3395,7 +3394,7 @@ in the @code{target_info} array. @end table @node remote_reboot procedure, remote_send procedure, remote_raw_wait procedure, Procedures For Remote Communication -@subsubsection remote_reboot Procedure +@subsubheading remote_reboot Procedure @findex remote_reboot Return value of this function depends on actual implementation @@ -3412,7 +3411,7 @@ on success and @emph{0} on failure. @end table @node remote_send procedure, remote_spawn procedure, remote_reboot procedure, Procedures For Remote Communication -@subsubsection remote_send Procedure +@subsubheading remote_send Procedure @findex remote_send @quotation @@ -3426,7 +3425,7 @@ on success and @emph{0} on failure. @end table @node remote_spawn procedure, remote_swap_conn procedure, remote_send procedure, Procedures For Remote Communication -@subsubsection remote_spawn Procedure +@subsubheading remote_spawn Procedure @findex remote_spawn @quotation @@ -3442,7 +3441,7 @@ on success and @emph{0} on failure. @end table @node remote_swap_conn procedure, remote_transmit procedure, remote_spawn procedure, Procedures For Remote Communication -@subsubsection remote_swap_conn Procedure +@subsubheading remote_swap_conn Procedure @findex remote_swap_conn @quotation @@ -3454,7 +3453,7 @@ on success and @emph{0} on failure. @end table @node remote_transmit procedure, remote_upload procedure, remote_swap_conn procedure, Procedures For Remote Communication -@subsubsection remote_transmit Procedure +@subsubheading remote_transmit Procedure @findex remote_transmit @quotation @@ -3468,7 +3467,7 @@ on success and @emph{0} on failure. @end table @node remote_upload procedure, remote_wait procedure, remote_transmit procedure, Procedures For Remote Communication -@subsubsection remote_upload Procedure +@subsubheading remote_upload Procedure @findex remote_upload @quotation @@ -3484,7 +3483,7 @@ on success and @emph{0} on failure. @end table @node remote_wait procedure, standard_close procedure, remote_upload procedure, Procedures For Remote Communication -@subsubsection remote_wait Procedure +@subsubheading remote_wait Procedure @findex remote_wait @quotation @@ -3498,7 +3497,7 @@ on success and @emph{0} on failure. @end table @node standard_close procedure, standard_download procedure, remote_wait procedure, Procedures For Remote Communication -@subsubsection standard_close Procedure +@subsubheading standard_close Procedure @findex standard_close @quotation @@ -3510,7 +3509,7 @@ on success and @emph{0} on failure. @end table @node standard_download procedure, standard_exec procedure, standard_close procedure, Procedures For Remote Communication -@subsubsection standard_download Procedure +@subsubheading standard_download Procedure @findex standard_download @quotation @@ -3526,7 +3525,7 @@ on success and @emph{0} on failure. @end table @node standard_exec procedure, standard_file procedure, standard_download procedure, Procedures For Remote Communication -@subsubsection standard_exec Procedure +@subsubheading standard_exec Procedure @findex standard_exec @quotation @@ -3540,7 +3539,7 @@ on success and @emph{0} on failure. @end table @node standard_file procedure, standard_load procedure, standard_exec procedure, Procedures For Remote Communication -@subsubsection standard_file Procedure +@subsubheading standard_file Procedure @findex standard_file @quotation @@ -3554,7 +3553,7 @@ on success and @emph{0} on failure. @end table @node standard_load procedure, standard_reboot procedure, standard_file procedure, Procedures For Remote Communication -@subsubsection standard_load Procedure +@subsubheading standard_load Procedure @findex standard_load @quotation @@ -3570,7 +3569,7 @@ on success and @emph{0} on failure. @end table @node standard_reboot procedure, standard_send procedure, standard_load procedure, Procedures For Remote Communication -@subsubsection standard_reboot Procedure +@subsubheading standard_reboot Procedure @findex standard_reboot It looks like that this procedure is never called, instead @@ -3587,7 +3586,7 @@ imported by @code{runtest}. @end table @node standard_send procedure, standard_spawn procedure, standard_reboot procedure, Procedures For Remote Communication -@subsubsection standard_send Procedure +@subsubheading standard_send Procedure @findex standard_send @quotation @@ -3601,7 +3600,7 @@ imported by @code{runtest}. @end table @node standard_spawn procedure, standard_transmit procedure, standard_send procedure, Procedures For Remote Communication -@subsubsection standard_spawn Procedure +@subsubheading standard_spawn Procedure @findex standard_spawn @quotation @@ -3615,7 +3614,7 @@ imported by @code{runtest}. @end table @node standard_transmit procedure, standard_upload procedure, standard_spawn procedure, Procedures For Remote Communication -@subsubsection standard_transmit Procedure +@subsubheading standard_transmit Procedure @findex standard_transmit @quotation @@ -3629,7 +3628,7 @@ imported by @code{runtest}. @end table @node standard_upload procedure, standard_wait procedure, standard_transmit procedure, Procedures For Remote Communication -@subsubsection standard_upload Procedure +@subsubheading standard_upload Procedure @findex standard_upload @quotation @@ -3643,7 +3642,7 @@ imported by @code{runtest}. @end table @node standard_wait procedure, unix_clean_filename procedure, standard_upload procedure, Procedures For Remote Communication -@subsubsection standard_wait Procedure +@subsubheading standard_wait Procedure @findex standard_wait @quotation @@ -3657,7 +3656,7 @@ imported by @code{runtest}. @end table @node unix_clean_filename procedure, , standard_wait procedure, Procedures For Remote Communication -@subsubsection unix_clean_filename Procedure +@subsubheading unix_clean_filename Procedure @findex unix_clean_filename @quotation @@ -3670,8 +3669,8 @@ imported by @code{runtest}. @item @code{file} @end table -@node connprocs, Procedures For Target Boards, Procedures For Remote Communication, Builtin Procedures -@subsection Procedures For Using Utilities to Connect +@node connprocs, Procedures For Target Boards, Procedures For Remote Communication, Built-in Procedures +@section Procedures For Using Utilities to Connect @menu * telnet Procedure: telnet procedure @@ -3704,7 +3703,7 @@ imported by @code{runtest}. @end menu @node telnet procedure, rsh procedure, , connprocs -@subsubsection telnet Procedure +@subsubheading telnet Procedure @findex telnet @quotation @@ -3717,7 +3716,7 @@ imported by @code{runtest}. @end quotation @node rsh procedure, tip procedure, telnet procedure, connprocs -@subsubsection rsh Procedure +@subsubheading rsh Procedure @findex rsh @quotation @@ -3738,7 +3737,7 @@ the config array is used for all information. @end table @node tip procedure, kermit procedure, rsh procedure, connprocs -@subsubsection tip Procedure +@subsubheading tip Procedure @findex tip @quotation @@ -3759,7 +3758,7 @@ information. the config array is used for all information. @end table @node kermit procedure, kermit_open procedure, tip procedure, connprocs -@subsubsection kermit Procedure +@subsubheading kermit Procedure @findex kermit @quotation @@ -3782,7 +3781,7 @@ all information. @end table @node kermit_open procedure, kermit_command procedure, kermit procedure, connprocs -@subsubsection kermit_open Procedure +@subsubheading kermit_open Procedure @findex kermit_open @quotation @@ -3796,7 +3795,7 @@ all information. @end table @node kermit_command procedure, kermit_send procedure, kermit_open procedure, connprocs -@subsubsection kermit_command Procedure +@subsubheading kermit_command Procedure @findex kermit_command @quotation @@ -3810,7 +3809,7 @@ all information. @end table @node kermit_send procedure, kermit_transmit procedure, kermit_command procedure, connprocs -@subsubsection kermit_send Procedure +@subsubheading kermit_send Procedure @findex kermit_send @quotation @@ -3824,7 +3823,7 @@ all information. @end table @node kermit_transmit procedure, telnet_open procedure, kermit_send procedure, connprocs -@subsubsection kermit_transmit Procedure +@subsubheading kermit_transmit Procedure @findex kermit_transmit @quotation @@ -3840,7 +3839,7 @@ all information. @end table @node telnet_open procedure, telnet_binary procedure, kermit_transmit procedure, connprocs -@subsubsection telnet_open Procedure +@subsubheading telnet_open Procedure @findex telnet_open @quotation @@ -3854,7 +3853,7 @@ all information. @end table @node telnet_binary procedure, telnet_transmit procedure, telnet_open procedure, connprocs -@subsubsection telnet_binary Procedure +@subsubheading telnet_binary Procedure @findex telnet_binary @quotation @@ -3866,7 +3865,7 @@ all information. @end table @node telnet_transmit procedure, tip_open procedure, telnet_binary procedure, connprocs -@subsubsection telnet_transmit Procedure +@subsubheading telnet_transmit Procedure @findex telnet_transmit @quotation @@ -3882,7 +3881,7 @@ all information. @end table @node tip_open procedure, rlogin_open procedure, telnet_transmit procedure, connprocs -@subsubsection tip_open Procedure +@subsubheading tip_open Procedure @findex tip_open @quotation @@ -3894,7 +3893,7 @@ all information. @end table @node rlogin_open procedure, rlogin_spawn procedure, tip_open procedure, connprocs -@subsubsection rlogin_open Procedure +@subsubheading rlogin_open Procedure @findex rlogin_open @quotation @@ -3906,7 +3905,7 @@ all information. @end table @node rlogin_spawn procedure, rsh_open procedure, rlogin_open procedure, connprocs -@subsubsection rlogin_spawn Procedure +@subsubheading rlogin_spawn Procedure @findex rlogin_spawn @quotation @@ -3920,7 +3919,7 @@ all information. @end table @node rsh_open procedure, rsh_download procedure, rlogin_spawn procedure, connprocs -@subsubsection rsh_open Procedure +@subsubheading rsh_open Procedure @findex rsh_open @quotation @@ -3932,7 +3931,7 @@ all information. @end table @node rsh_download procedure, rsh_upload procedure, rsh_open procedure, connprocs -@subsubsection rsh_download Procedure +@subsubheading rsh_download Procedure @findex rsh_download @quotation @@ -3948,7 +3947,7 @@ all information. @end table @node rsh_upload procedure, rsh_exec procedure, rsh_download procedure, connprocs -@subsubsection rsh_upload Procedure +@subsubheading rsh_upload Procedure @findex rsh_upload @quotation @@ -3964,7 +3963,7 @@ all information. @end table @node rsh_exec procedure, ssh_close procedure, rsh_upload procedure, connprocs -@subsubsection rsh_exec Procedure +@subsubheading rsh_exec Procedure @findex rsh_exec @quotation @@ -3980,7 +3979,7 @@ all information. @end table @node ssh_close procedure, ssh_exec procedure, rsh_exec procedure, connprocs -@subsubsection ssh_close procedure +@subsubheading ssh_close procedure @findex ssh_close @quotation @@ -3992,7 +3991,7 @@ all information. @end table @node ssh_exec procedure, ssh_download procedure, ssh_close procedure, connprocs -@subsubsection ssh_exec procedure +@subsubheading ssh_exec procedure @findex ssh_exec @quotation @@ -4008,7 +4007,7 @@ all information. @end table @node ssh_download procedure, ssh_upload procedure, ssh_exec procedure, connprocs -@subsubsection ssh_download procedure +@subsubheading ssh_download procedure @findex ssh_download @quotation @@ -4022,7 +4021,7 @@ all information. @end table @node ssh_upload procedure, ftp_open procedure, ssh_download procedure, connprocs -@subsubsection ssh_upload procedure +@subsubheading ssh_upload procedure @findex ssh_upload @quotation @@ -4036,7 +4035,7 @@ all information. @end table @node ftp_open procedure, ftp_upload procedure, ssh_upload procedure, connprocs -@subsubsection ftp_open Procedure +@subsubheading ftp_open Procedure @findex ftp_open @quotation @@ -4049,7 +4048,7 @@ all information. @end table @node ftp_upload procedure, ftp_download procedure, ftp_open procedure, connprocs -@subsubsection ftp_upload Procedure +@subsubheading ftp_upload Procedure @findex ftp_upload @quotation @@ -4065,7 +4064,7 @@ all information. @end table @node ftp_download procedure, ftp_close procedure, ftp_upload procedure, connprocs -@subsubsection ftp_download Procedure +@subsubheading ftp_download Procedure @findex ftp_download @quotation @@ -4081,7 +4080,7 @@ all information. @end table @node ftp_close procedure, tip_download procedure, ftp_download procedure, connprocs -@subsubsection ftp_close Procedure +@subsubheading ftp_close Procedure @findex ftp_close @quotation @@ -4093,7 +4092,7 @@ all information. @end table @node tip_download procedure, , ftp_close procedure, connprocs -@subsubsection tip_download Procedure +@subsubheading tip_download Procedure @findex tip_download @quotation @@ -4114,8 +4113,8 @@ occurs, @emph{0} otherwise. This is the filename to download. @end table -@node Procedures For Target Boards, target database library file, connprocs, Builtin Procedures -@subsection Procedures For Target Boards +@node Procedures For Target Boards, target database library file, connprocs, Built-in Procedures +@section Procedures For Target Boards @menu * default_link Procedure: default_link procedure @@ -4131,7 +4130,7 @@ This is the filename to download. @end menu @node default_link procedure, default_target_assemble procedure, , Procedures For Target Boards -@subsubsection default_link Procedure +@subsubheading default_link Procedure @findex default_link @quotation @@ -4149,7 +4148,7 @@ This is the filename to download. @end table @node default_target_assemble procedure, default_target_compile procedure, default_link procedure, Procedures For Target Boards -@subsubsection default_target_assemble Procedure +@subsubheading default_target_assemble Procedure @findex default_target_assemble @quotation @@ -4165,7 +4164,7 @@ This is the filename to download. @end table @node default_target_compile procedure, pop_config procedure, default_target_assemble procedure, Procedures For Target Boards -@subsubsection default_target_compile Procedure +@subsubheading default_target_compile Procedure @findex default_target_compile @quotation @@ -4183,7 +4182,7 @@ This is the filename to download. @end table @node pop_config procedure, prune_warnings procedure, default_target_compile procedure, Procedures For Target Boards -@subsubsection pop_config Procedure +@subsubheading pop_config Procedure @findex pop_config @quotation @@ -4195,7 +4194,7 @@ This is the filename to download. @end table @node prune_warnings procedure, push_build procedure, pop_config procedure, Procedures For Target Boards -@subsubsection prune_warnings Procedure +@subsubheading prune_warnings Procedure @findex prune_warnings @quotation @@ -4207,7 +4206,7 @@ This is the filename to download. @end table @node push_build procedure, push_config procedure, prune_warnings procedure, Procedures For Target Boards -@subsubsection push_build Procedure +@subsubheading push_build Procedure @findex push_build @quotation @@ -4219,7 +4218,7 @@ This is the filename to download. @end table @node push_config procedure, reboot_target procedure, push_build procedure, Procedures For Target Boards -@subsubsection push_config Procedure +@subsubheading push_config Procedure @findex push_config @quotation @@ -4234,7 +4233,7 @@ This is the filename to download. @end table @node reboot_target procedure, target_assemble procedure, push_config procedure, Procedures For Target Boards -@subsubsection reboot_target Procedure +@subsubheading reboot_target Procedure @findex reboot_target Reboot the target. @@ -4244,7 +4243,7 @@ Reboot the target. @end quotation @node target_assemble procedure, target_compile procedure, reboot_target procedure, Procedures For Target Boards -@subsubsection target_assemble Procedure +@subsubheading target_assemble Procedure @findex target_assemble @quotation @@ -4258,7 +4257,7 @@ Reboot the target. @end table @node target_compile procedure, , target_assemble procedure, Procedures For Target Boards -@subsubsection target_compile Procedure +@subsubheading target_compile Procedure @findex target_compile @quotation @@ -4275,8 +4274,8 @@ Reboot the target. @item @code{options} @end table -@node target database library file, platform dependent procedures, Procedures For Target Boards, Builtin Procedures -@subsection Target Database Procedures +@node target database library file, platform dependent procedures, Procedures For Target Boards, Built-in Procedures +@section Target Database Procedures @menu * board_info Procedure: board_info procedure @@ -4299,7 +4298,7 @@ Reboot the target. @end menu @node board_info procedure, host_info procedure, , target database library file -@subsubsection board_info Procedure +@subsubheading board_info Procedure @findex board_info @quotation @@ -4315,7 +4314,7 @@ Reboot the target. @end table @node host_info procedure, set_board_info procedure, board_info procedure, target database library file -@subsubsection host_info Procedure +@subsubheading host_info Procedure @findex host_info @quotation @@ -4329,7 +4328,7 @@ Reboot the target. @end table @node set_board_info procedure, add_board_info procedure, host_info procedure, target database library file -@subsubsection set_board_info Procedure +@subsubheading set_board_info Procedure @findex set_board_info This checks if @code{board_info} array's field @emph{entry} has been set @@ -4350,7 +4349,7 @@ The value to set the field to. @end table @node add_board_info procedure, set_currtarget_info procedure, set_board_info procedure, target database library file -@subsubsection add_board_info Procedure +@subsubheading add_board_info Procedure @findex add_board_info This treats @code{board_info} array's field @@ -4372,7 +4371,7 @@ The value to add to the field. @end table @node set_currtarget_info procedure, target_info procedure, add_board_info procedure, target database library file -@subsubsection set_currtarget_info Procedure +@subsubheading set_currtarget_info Procedure @findex set_currtarget_info @quotation @@ -4386,7 +4385,7 @@ The value to add to the field. @end table @node target_info procedure, unset_board_info procedure, set_currtarget_info procedure, target database library file -@subsubsection target_info Procedure +@subsubheading target_info Procedure @findex target_info @quotation @@ -4400,7 +4399,7 @@ The value to add to the field. @end table @node unset_board_info procedure, unset_currtarget_info procedure, target_info procedure, target database library file -@subsubsection unset_board_info Procedure +@subsubheading unset_board_info Procedure @findex unset_board_info This checks if @code{board_info} array's field @emph{entry} has been set @@ -4416,7 +4415,7 @@ The name of a @code{board_info} field to operate on. @end table @node unset_currtarget_info procedure, push_target procedure, unset_board_info procedure, target database library file -@subsubsection unset_currtarget_info Procedure +@subsubheading unset_currtarget_info Procedure @findex unset_currtarget_info @quotation @@ -4428,7 +4427,7 @@ The name of a @code{board_info} field to operate on. @end table @node push_target procedure, pop_target procedure, unset_currtarget_info procedure, target database library file -@subsubsection push_target Procedure +@subsubheading push_target Procedure @findex push_target This makes the target named @emph{name} be the current target @@ -4445,7 +4444,7 @@ The name of the target to make current connection. @end table @node pop_target procedure, list_targets procedure, push_target procedure, target database library file -@subsubsection pop_target Procedure +@subsubheading pop_target Procedure @findex pop_target This unsets the current target connection. @@ -4455,7 +4454,7 @@ This unsets the current target connection. @end quotation @node list_targets procedure, push_host procedure, pop_target procedure, target database library file -@subsubsection list_targets Procedure +@subsubheading list_targets Procedure @findex list_targets This lists all the supported targets for this architecture. @@ -4465,7 +4464,7 @@ This lists all the supported targets for this architecture. @end quotation @node push_host procedure, pop_host procedure, list_targets procedure, target database library file -@subsubsection push_host Procedure +@subsubheading push_host Procedure @findex push_host This makes the host named @emph{name} be the current remote host @@ -4481,7 +4480,7 @@ connection. The value of @emph{name} is an index into the @end table @node pop_host procedure, compile procedure, push_host procedure, target database library file -@subsubsection pop_host Procedure +@subsubheading pop_host Procedure @findex pop_host This unsets the current host connection. @@ -4491,7 +4490,7 @@ This unsets the current host connection. @end quotation @node compile procedure, archive procedure, pop_host procedure, target database library file -@subsubsection compile Procedure +@subsubheading compile Procedure @findex compile This invokes the compiler as set by CC to compile the file @file{file}. @@ -4511,7 +4510,7 @@ compiler is run on the remote host using @code{execute_anywhere}. @end table @node archive procedure, ranlib procedure, compile procedure, target database library file -@subsubsection archive Procedure +@subsubheading archive Procedure @findex archive This produces an archive file. Any parameters passed to @code{archive} @@ -4529,7 +4528,7 @@ on the remote host using @code{execute_anywhere}. @end table @node ranlib procedure, execute_anywhere procedure, archive procedure, target database library file -@subsubsection ranlib Procedure +@subsubheading ranlib Procedure @findex ranlib This generates an index for the archive file for systems that aren't @@ -4545,7 +4544,7 @@ flags. @end table @node execute_anywhere procedure, , ranlib procedure, target database library file -@subsubsection execute_anywhere Procedure +@subsubheading execute_anywhere Procedure @findex execute_anywhere This executes the @emph{cmdline} on the proper host. This should be used @@ -4567,8 +4566,8 @@ running the tool to be tested, not a test case. @item @code{cmdline} @end table -@node platform dependent procedures, Utility Procedures, target database library file, Builtin Procedures -@subsection Platform Dependent Procedures +@node platform dependent procedures, Utility Procedures, target database library file, Built-in Procedures +@section Platform Dependent Procedures Each combination of target and tool requires some target-dependent procedures. The names of these procedures have a common form: the tool @@ -4598,7 +4597,7 @@ was a communication error. @end menu @node $@{tool@}_start procedure, $@{tool@}_load procedure, , platform dependent procedures -@subsubsection $@{tool@}_start Procedure +@subsubheading $@{tool@}_start Procedure @findex $@{tool@}_start Starts a particular tool. For an interactive tool, @@ -4623,7 +4622,7 @@ tool). @end quotation @node $@{tool@}_load procedure, $@{tool@}_exit procedure, $@{tool@}_start procedure, platform dependent procedures -@subsubsection $@{tool@}_load Procedure +@subsubheading $@{tool@}_load Procedure @findex $@{tool@}_load Loads something into a tool. For an interactive tool, this conditions @@ -4642,7 +4641,7 @@ or file downloading. Test scripts call @code{$@{tool@}_load}. @end quotation @node $@{tool@}_exit procedure, $@{tool@}_version procedure, $@{tool@}_load procedure, platform dependent procedures -@subsubsection $@{tool@}_exit Procedure +@subsubheading $@{tool@}_exit Procedure @findex $@{tool@}_exit Cleans up (if necessary) before DejaGnu exits. For interactive tools, @@ -4655,7 +4654,7 @@ tests. @code{runtest} calls @code{$@{tool@}_exit}. @end quotation @node $@{tool@}_version procedure, , $@{tool@}_exit procedure, platform dependent procedures -@subsubsection $@{tool@}_version Procedure +@subsubheading $@{tool@}_version Procedure @findex $@{tool@}_version Prints the version label and number for @code{$@{tool@}}. This is @@ -4667,8 +4666,8 @@ tool, and its version number. @t{@b{$@{tool@}_version}} @end quotation -@node Utility Procedures, Libgloss, platform dependent procedures, Builtin Procedures -@subsection Utility Procedures +@node Utility Procedures, Libgloss, platform dependent procedures, Built-in Procedures +@section Utility Procedures @menu * getdirs Procedure: getdirs procedure @@ -4685,7 +4684,7 @@ tool, and its version number. @end menu @node getdirs procedure, find procedure, , Utility Procedures -@subsubsection getdirs Procedure +@subsubheading getdirs Procedure @findex getdirs Returns a list of all the subdirectories in a single directory that @@ -4714,7 +4713,7 @@ returned. @end table @node find procedure, which procedure, getdirs procedure, Utility Procedures -@subsubsection find Procedure +@subsubheading find Procedure @findex find Search for files whose names match @emph{ pattern } (using shell wildcard @@ -4739,7 +4738,7 @@ A csh "glob" style regular expression representing the files to find. @end table @node which procedure, grep procedure, find procedure, Utility Procedures -@subsubsection which Procedure +@subsubheading which Procedure @findex which Searches the execution path for an executable file @emph{binary}, like @@ -4759,7 +4758,7 @@ The executable program or shell script to look for. @end table @node grep procedure, prune procedure, which procedure, Utility Procedures -@subsubsection grep Procedure +@subsubheading grep Procedure @findex grep Search the file called @file{filename} (a fully specified path) for @@ -4792,7 +4791,7 @@ Prefix each line with the line number where the regexp matches. @end table @node prune procedure, runtest_file_p procedure, grep procedure, Utility Procedures -@subsubsection prune Procedure +@subsubheading prune Procedure @findex prune This procedure is deprecated and will be removed in the next release of @@ -4800,7 +4799,7 @@ DejaGnu. If a testsuite uses this procedure, a copy of the procedure should be made and placed in the lib directory of the testsuite. @node runtest_file_p procedure, diff procedure, prune procedure, Utility Procedures -@subsubsection runtest_file_p Procedure +@subsubheading runtest_file_p Procedure @findex runtest_file_p Search @emph{runtest}s for @emph{testcase} and return @emph{1} if found, @@ -4830,7 +4829,7 @@ The test case filename. @end table @node diff procedure, setenv procedure, runtest_file_p procedure, Utility Procedures -@subsubsection diff Procedure +@subsubheading diff Procedure @findex diff Compares the two files and returns a @emph{1} if they match, or a @@ -4852,7 +4851,7 @@ Second file to compare. @end table @node setenv procedure, unsetenv procedure, diff procedure, Utility Procedures -@subsubsection setenv Procedure +@subsubheading setenv Procedure @findex setenv Sets the environment variable @emph{var} to the value @emph{val}. @@ -4872,7 +4871,7 @@ The value to set the variable to. @end table @node unsetenv procedure, getenv procedure, setenv procedure, Utility Procedures -@subsubsection unsetenv Procedure +@subsubheading unsetenv Procedure @findex unsetenv Unsets the environment variable @@ -4889,7 +4888,7 @@ The environment variable to unset. @end table @node getenv procedure, prune_system_crud procedure, unsetenv procedure, Utility Procedures -@subsubsection getenv Procedure +@subsubheading getenv Procedure @findex getenv Returns the value of the envrionment variable @emph{var} if it is @@ -4906,7 +4905,7 @@ The environment variable to get the value of. @end table @node prune_system_crud procedure, , getenv procedure, Utility Procedures -@subsubsection prune_system_crud Procedure +@subsubheading prune_system_crud Procedure @findex prune_system_crud For system @emph{system}, delete text the host or target operating @@ -4927,8 +4926,8 @@ The system error messages to look for to screen out. The Tcl variable containing the text. @end table -@node Libgloss, Debugging Procedures, Utility Procedures, Builtin Procedures -@subsection Libgloss, a free board support package (BSP) +@node Libgloss, Debugging Procedures, Utility Procedures, Built-in Procedures +@section Libgloss, a free board support package (BSP) Libgloss is a free @dfn{BSP} (Board Support Package) commonly used with GCC and G++ to produce a fully linked executable image for an embedded @@ -4962,7 +4961,7 @@ systems. @end menu @node libgloss_link_flags procedure, libgloss_include_flags procedure, , Libgloss -@subsubsection libgloss_link_flags Procedure +@subsubheading libgloss_link_flags Procedure @findex libgloss_link_flags @quotation @@ -4974,7 +4973,7 @@ systems. @end table @node libgloss_include_flags procedure, newlib_link_flags procedure, libgloss_link_flags procedure, Libgloss -@subsubsection libgloss_include_flags Procedure +@subsubheading libgloss_include_flags Procedure @findex libgloss_include_flags @quotation @@ -4986,7 +4985,7 @@ systems. @end table @node newlib_link_flags procedure, newlib_include_flags procedure, libgloss_include_flags procedure, Libgloss -@subsubsection newlib_link_flags Procedure +@subsubheading newlib_link_flags Procedure @findex newlib_link_flags @quotation @@ -4998,7 +4997,7 @@ systems. @end table @node newlib_include_flags procedure, libio_include_flags procedure, newlib_link_flags procedure, Libgloss -@subsubsection newlib_include_flags Procedure +@subsubheading newlib_include_flags Procedure @findex newlib_include_flags @quotation @@ -5010,7 +5009,7 @@ systems. @end table @node libio_include_flags procedure, libio_link_flags procedure, newlib_include_flags procedure, Libgloss -@subsubsection libio_include_flags Procedure +@subsubheading libio_include_flags Procedure @findex libio_include_flags @quotation @@ -5022,7 +5021,7 @@ systems. @end table @node libio_link_flags procedure, g++_include_flags procedure, libio_include_flags procedure, Libgloss -@subsubsection libio_link_flags Procedure +@subsubheading libio_link_flags Procedure @findex libio_link_flags @quotation @@ -5034,7 +5033,7 @@ systems. @end table @node g++_include_flags procedure, g++_link_flags procedure, libio_link_flags procedure, Libgloss -@subsubsection g++_include_flags Procedure +@subsubheading g++_include_flags Procedure @findex g++_include_flags @quotation @@ -5046,7 +5045,7 @@ systems. @end table @node g++_link_flags procedure, libstdc++_include_flags procedure, g++_include_flags procedure, Libgloss -@subsubsection g++_link_flags Procedure +@subsubheading g++_link_flags Procedure @findex g++_link_flags @quotation @@ -5058,7 +5057,7 @@ systems. @end table @node libstdc++_include_flags procedure, libstdc++_link_flags procedure, g++_link_flags procedure, Libgloss -@subsubsection libstdc++_include_flags Procedure +@subsubheading libstdc++_include_flags Procedure @findex libstdc++_include_flags @quotation @@ -5070,7 +5069,7 @@ systems. @end table @node libstdc++_link_flags procedure, get_multilibs procedure, libstdc++_include_flags procedure, Libgloss -@subsubsection libstdc++_link_flags Procedure +@subsubheading libstdc++_link_flags Procedure @findex libstdc++_link_flags @quotation @@ -5082,7 +5081,7 @@ systems. @end table @node get_multilibs procedure, find_binutils_prog procedure, libstdc++_link_flags procedure, Libgloss -@subsubsection get_multilibs Procedure +@subsubheading get_multilibs Procedure @findex get_multilibs @quotation @@ -5094,7 +5093,7 @@ systems. @end table @node find_binutils_prog procedure, find_gcc procedure, get_multilibs procedure, Libgloss -@subsubsection find_binutils_prog Procedure +@subsubheading find_binutils_prog Procedure @findex find_binutils_prog @quotation @@ -5106,7 +5105,7 @@ systems. @end table @node find_gcc procedure, find_gcj procedure, find_binutils_prog procedure, Libgloss -@subsubsection find_gcc Procedure +@subsubheading find_gcc Procedure @findex find_gcc @quotation @@ -5114,7 +5113,7 @@ systems. @end quotation @node find_gcj procedure, find_g++ procedure, find_gcc procedure, Libgloss -@subsubsection find_gcj Procedure +@subsubheading find_gcj Procedure @findex find_gcj @quotation @@ -5122,7 +5121,7 @@ systems. @end quotation @node find_g++ procedure, find_g77 procedure, find_gcj procedure, Libgloss -@subsubsection find_g++ Procedure +@subsubheading find_g++ Procedure @findex find_g++ @quotation @@ -5130,7 +5129,7 @@ systems. @end quotation @node find_g77 procedure, find_gfortran procedure, find_g++ procedure, Libgloss -@subsubsection find_g77 Procedure +@subsubheading find_g77 Procedure @findex find_g77 @quotation @@ -5138,7 +5137,7 @@ systems. @end quotation @node find_gfortran procedure, process_multilib_options procedure, find_g77 procedure, Libgloss -@subsubsection find_gfortran Procedure +@subsubheading find_gfortran Procedure @findex find_gfortran @quotation @@ -5146,7 +5145,7 @@ systems. @end quotation @node process_multilib_options procedure, add_multilib_option procedure, find_gfortran procedure, Libgloss -@subsubsection process_multilib_options Procedure +@subsubheading process_multilib_options Procedure @findex process_multilib_options @quotation @@ -5158,7 +5157,7 @@ systems. @end table @node add_multilib_option procedure, find_gas procedure, process_multilib_options procedure, Libgloss -@subsubsection add_multilib_option Procedure +@subsubheading add_multilib_option Procedure @findex add_multilib_option @quotation @@ -5170,7 +5169,7 @@ systems. @end table @node find_gas procedure, find_ld procedure, add_multilib_option procedure, Libgloss -@subsubsection find_gas Procedure +@subsubheading find_gas Procedure @findex find_gas @quotation @@ -5178,7 +5177,7 @@ systems. @end quotation @node find_ld procedure, build_wrapper procedure, find_gas procedure, Libgloss -@subsubsection find_ld Procedure +@subsubheading find_ld Procedure @findex find_ld @quotation @@ -5186,7 +5185,7 @@ systems. @end quotation @node build_wrapper procedure, winsup_include_flags procedure, find_ld procedure, Libgloss -@subsubsection build_wrapper Procedure +@subsubheading build_wrapper Procedure @findex build_wrapper @quotation @@ -5198,7 +5197,7 @@ systems. @end table @node winsup_include_flags procedure, winsup_link_flags procedure, build_wrapper procedure, Libgloss -@subsubsection winsup_include_flags Procedure +@subsubheading winsup_include_flags Procedure @findex winsup_include_flags @quotation @@ -5210,7 +5209,7 @@ systems. @end table @node winsup_link_flags procedure, , winsup_include_flags procedure, Libgloss -@subsubsection winsup_link_flags Procedure +@subsubheading winsup_link_flags Procedure @findex winsup_link_flags @quotation @@ -5221,8 +5220,8 @@ systems. @item @code{args} @end table -@node Debugging Procedures, , Libgloss, Builtin Procedures -@subsection Procedures for debugging your scripts +@node Debugging Procedures, , Libgloss, Built-in Procedures +@section Procedures for debugging your scripts @file{lib/debugger.exp} defines the following procedures: @@ -5242,7 +5241,7 @@ systems. @end menu @node dumpvars procedure, dumplocals procedure, , Debugging Procedures -@subsubsection dumpvars Procedure +@subsubheading dumpvars Procedure @findex dumpvars This takes a csh style regular expression (glob rules) and prints the @@ -5259,7 +5258,7 @@ The variables to dump. @end table @node dumplocals procedure, dumprocs procedure, dumpvars procedure, Debugging Procedures -@subsubsection dumplocals Procedure +@subsubheading dumplocals Procedure @findex dumplocals This takes a csh style regular expression (glob rules) and prints the @@ -5275,7 +5274,7 @@ values of the local variable names that match. It is abbreviated as @end table @node dumprocs procedure, dumpwatch procedure, dumplocals procedure, Debugging Procedures -@subsubsection dumprocs Procedure +@subsubheading dumprocs Procedure @findex dumprocs This takes a csh style regular expression (glob rules) and prints the @@ -5292,7 +5291,7 @@ for. @end table @node dumpwatch procedure, watcharray procedure, dumprocs procedure, Debugging Procedures -@subsubsection dumpwatch Procedure +@subsubheading dumpwatch Procedure @findex dumpwatch This takes a csh style regular expression (glob rules) and prints all @@ -5308,7 +5307,7 @@ The csh "glob" style pattern to look for. @end table @node watcharray procedure, watchvar procedure, dumpwatch procedure, Debugging Procedures -@subsubsection watcharray Procedure +@subsubheading watcharray Procedure @findex watcharray @quotation @@ -5322,7 +5321,7 @@ The csh "glob" style pattern to look for. @end table @node watchvar procedure, watchunset procedure, watcharray procedure, Debugging Procedures -@subsubsection watchvar Procedure +@subsubheading watchvar Procedure @findex watchvar @quotation @@ -5335,7 +5334,7 @@ The csh "glob" style pattern to look for. @end table @node watchunset procedure, watchwrite procedure, watchvar procedure, Debugging Procedures -@subsubsection watchunset Procedure +@subsubheading watchunset Procedure @findex watchunset This breaks program execution when the variable @code{var} is unset. It @@ -5350,7 +5349,7 @@ is abbreviated as @emph{wu}. @end table @node watchwrite procedure, watchread procedure, watchunset procedure, Debugging Procedures -@subsubsection watchwrite Procedure +@subsubheading watchwrite Procedure @findex watchwrite This breaks program execution when the variable @code{var} is @@ -5366,7 +5365,7 @@ The variable to watch. @end table @node watchread procedure, watchdel procedure, watchwrite procedure, Debugging Procedures -@subsubsection watchread Procedure +@subsubheading watchread Procedure @findex watchread This breaks program execution when the variable @code{var} is read. It @@ -5382,7 +5381,7 @@ The variable to watch. @end table @node watchdel procedure, print procedure, watchread procedure, Debugging Procedures -@subsubsection watchdel Procedure +@subsubheading watchdel Procedure @findex watchdel This deletes a watchpoint from the watch list. It is abbreviated as @@ -5397,7 +5396,7 @@ This deletes a watchpoint from the watch list. It is abbreviated as @end table @node print procedure, quit procedure, watchdel procedure, Debugging Procedures -@subsubsection print Procedure +@subsubheading print Procedure @findex print This prints the value of the variable @code{var}. It is abbreviated as @@ -5412,7 +5411,7 @@ This prints the value of the variable @code{var}. It is abbreviated as @end table @node quit procedure, , print procedure, Debugging Procedures -@subsubsection quit Procedure +@subsubheading quit Procedure @findex quit This makes runtest exit. It is abbreviated as @emph{q}. @@ -5425,7 +5424,7 @@ This makes runtest exit. It is abbreviated as @emph{q}. @item @code{} @end table -@node GNU Free Documentation License, Concept Index, Reference, Top +@node GNU Free Documentation License, Concept Index, Built-in Procedures, Top @appendix GNU Free Documentation License @include fdl.texi |