From 20b1ef7e5d91fac21aa7c1cd8735693652b96c83 Mon Sep 17 00:00:00 2001 From: Ben Elliston Date: Sat, 31 Dec 2005 02:43:37 +0000 Subject: [PATCH] * doc/ref.xml (Utility Procedures): Note that the following procedures are deprecated: absolute, psource, prune, slay. * NEWS: Likewise. * doc/dejagnu.texi: Regenerate. --- ChangeLog | 7 ++++ NEWS | 5 +++ doc/dejagnu.texi | 85 +++++++++-------------------------------- doc/ref.xml | 98 ++++++++---------------------------------------- 4 files changed, 45 insertions(+), 150 deletions(-) diff --git a/ChangeLog b/ChangeLog index ccbf97d..2440636 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2005-12-31 Ben Elliston + + * doc/ref.xml (Utility Procedures): Note that the following + procedures are deprecated: absolute, psource, prune, slay. + * NEWS: Likewise. + * doc/dejagnu.texi: Regenerate. + 2005-12-24 Ben Elliston * Makefile.am (doc/dejagnu.texi): Don't use shell redirection, in diff --git a/NEWS b/NEWS index dd622d6..5fc6fad 100644 --- a/NEWS +++ b/NEWS @@ -17,6 +17,11 @@ Changes since 1.4.4: 6. The runtest program now gracefully handles the possibility of the expect binary vanishing after DejaGnu has been installed (for example, by the user altering their PATH). +7. The user-visible utility procedures `absolute', `prune', `psource' + and `slay' are deprecated and will be removed in the next release. + If a testsuite uses any of these procedures, a copy of the + procedure should be made and placed in the lib directory of the + testsuite. Changes since 1.4.2: diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi index c282b34..3f64e52 100644 --- a/doc/dejagnu.texi +++ b/doc/dejagnu.texi @@ -1,5 +1,5 @@ \input texinfo -@setfilename dejagnu.info +@setfilename untitled.info @documentencoding us-ascii @direntry * DejaGnu: . ??? @@ -6353,85 +6353,34 @@ regexp matches. @node prune procedure, slay procedure, grep procedure, Utility Procedures @subsubsection Prune Procedure -Remove elements of the Tcl list @i{list}. -Elements are fields delimited by spaces. The result is a copy of -list, without any elements that match @i{pattern}. -You can use the common shell wildcard characters to specify the -pattern. - -@quotation - -@t{@b{prune}(@i{list} -@i{pattern});} -@end quotation - -@table @asis - -@item @code{list} -A Tcl list containing the original data. Commonly -this is the output of a batch executed command, like running a -compiler. - -@item @code{pattern} -The csh shell "glob" style pattern to search -for. -@end table +This procedure is deprecated and will be removed in +the next release of 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 slay procedure, absolute procedure, prune procedure, Utility Procedures @subsubsection Slay Procedure -This look in the process table for @i{name} -and send it a unix SIGINT, killing the process. This will only work -under Windows if you have Cygwin or another Unix subsystem for Windows -installed. - -@quotation - -@t{@b{slay}(@i{name});} -@end quotation - -@table @asis - -@item @code{name} -The name of the program to kill. -@end table +This procedure is deprecated and will be removed in +the next release of 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 absolute procedure, psource procedure, slay procedure, Utility Procedures @subsubsection Absolute Procedure -This procedure takes the relative @i{path}, -and converts it to an absolute path. - -@quotation - -@t{@b{absolute}(@i{path});} -@end quotation - -@table @asis - -@item @code{path} -The path to convert. -@end table +This procedure is deprecated and will be removed in +the next release of 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 psource procedure, runtest_file_p procedure, absolute procedure, Utility Procedures @subsubsection Psource Procedure -This sources the file @i{filename}, and traps -all errors. It also ignores all extraneous output. If there was an -error it returns a @i{1}, otherwise it returns a -@i{0}. - -@quotation - -@t{@b{psource}(@i{file});} -@end quotation - -@table @asis - -@item @code{filename} -The filename to Tcl script to -source. -@end table +This procedure is deprecated and will be removed in +the next release of 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, psource procedure, Utility Procedures @subsubsection Runtest_file_p Procedure diff --git a/doc/ref.xml b/doc/ref.xml index e603d04..fd8239e 100644 --- a/doc/ref.xml +++ b/doc/ref.xml @@ -3665,100 +3665,34 @@ Prune Procedure - - Remove elements of the Tcl list list. - Elements are fields delimited by spaces. The result is a copy of - list, without any elements that match pattern. - You can use the common shell wildcard characters to specify the - pattern. - - - - prune - list - pattern - - - - - list - A Tcl list containing the original data. Commonly - this is the output of a batch executed command, like running a - compiler. - - - pattern - The csh shell "glob" style pattern to search - for. - - - + This procedure is deprecated and will be removed in + the next release of DejaGnu. If a testsuite uses this + procedure, a copy of the procedure should be made and placed + in the lib directory of the testsuite. Slay Procedure - - This look in the process table for name - and send it a unix SIGINT, killing the process. This will only work - under Windows if you have Cygwin or another Unix subsystem for Windows - installed. - - - - slay - name - - - - - name - The name of the program to kill. - - - + This procedure is deprecated and will be removed in + the next release of DejaGnu. If a testsuite uses this + procedure, a copy of the procedure should be made and placed + in the lib directory of the testsuite. Absolute Procedure - - This procedure takes the relative path, - and converts it to an absolute path. - - - - absolute - path - - - - - path - The path to convert. - - + This procedure is deprecated and will be removed in + the next release of DejaGnu. If a testsuite uses this + procedure, a copy of the procedure should be made and placed + in the lib directory of the testsuite. Psource Procedure - - This sources the file filename, and traps - all errors. It also ignores all extraneous output. If there was an - error it returns a 1, otherwise it returns a - 0. - - - - psource - file - - - - - filename - The filename to Tcl script to - source. - - + This procedure is deprecated and will be removed in + the next release of DejaGnu. If a testsuite uses this + procedure, a copy of the procedure should be made and placed + in the lib directory of the testsuite.