From dfbd0b4bbda05a28baabde9e0487afe6063b2e9b Mon Sep 17 00:00:00 2001 From: Jacob Bachmeyer Date: Thu, 21 May 2020 16:27:48 -0600 Subject: Explicitly list optional arguments instead of simply copying the Tcl argument list for the remote_exec procedure. --- ChangeLog | 6 ++++++ doc/dejagnu.texi | 29 ++++++++++++++++++----------- 2 files changed, 24 insertions(+), 11 deletions(-) diff --git a/ChangeLog b/ChangeLog index 3c836da..257066f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,11 @@ 2020-05-20 Jacob Bachmeyer + * doc/dejagnu.texi (remote_exec procedure): Explicitly list + optional arguments instead of simply copying the Tcl argument list + or the remote_exec procedure. + +2020-05-20 Jacob Bachmeyer + * testsuite/runtest.libs/default_procs.tcl: Set sum_file to empty string instead of opening a temporary file named .tmp. * testsuite/runtest.libs/libs.exp: No longer need to remove .tmp. diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi index 92383b2..4247f52 100644 --- a/doc/dejagnu.texi +++ b/doc/dejagnu.texi @@ -3460,7 +3460,8 @@ program. This may be an empty string if output from the program was redirected. @quotation -@t{@b{remote_exec} @i{hostname} @i{program} @i{args}} +@t{ @b{remote_exec} @i{hostname} @i{program} +?@i{options}? ?@i{input}? ?@i{output}? ?@i{timeout}?} @end quotation @table @asis @@ -3468,19 +3469,25 @@ redirected. Name of the host to execute the command on. @item @code{program} -Command -@item @code{args} -There are four optional arguments: +Command to execute. -@enumerate -@item arguments to pass to the program; -@item an input filename to feed to stanard input of the command; -@item an output filename where the output from the command should be written; and -@item timeout value in seconds. -@end enumerate +@item @code{options} +Arguments to pass to the program. + +@item @code{input} +Input filename to feed to standard input of the command. + +@item @code{output} +Output filename where the output from the command should be written. + +@item @code{timeout} +Timeout value in seconds. @end table +All of the optional positional arguments accept an empty string as a +neutral value. + @node remote_expect procedure, remote_file procedure, remote_exec procedure, Procedures For Remote Communication @subsubheading remote_expect Procedure @findex remote_expect @@ -5666,4 +5673,4 @@ This makes @code{runtest} exit. Abbreviation: @kbd{q}. @c LocalWords: subdirectory prepend prepended testsuite filename Expect's svn @c LocalWords: DejaGnu CVS RCS SCCS prepending subcommands Tcl Awk Readline -@c LocalWords: POSIX KFAIL KPASS XFAIL XPASS +@c LocalWords: POSIX KFAIL KPASS XFAIL XPASS hostname -- cgit v1.1