Browse Source

* doc/ref.xml (Utility Procedures): Note that the following

procedures are deprecated: absolute, psource, prune, slay.
	* NEWS: Likewise.
	* doc/dejagnu.texi: Regenerate.
origin
Ben Elliston 21 years ago
parent
commit
20b1ef7e5d
  1. 7
      ChangeLog
  2. 5
      NEWS
  3. 85
      doc/dejagnu.texi
  4. 98
      doc/ref.xml

7
ChangeLog

@ -1,3 +1,10 @@
2005-12-31 Ben Elliston <bje@gnu.org>
* 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 <bje@gnu.org>
* Makefile.am (doc/dejagnu.texi): Don't use shell redirection, in

5
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:

85
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

98
doc/ref.xml

@ -3665,100 +3665,34 @@
<sect4 id="prune" xreflabel="prune procedure">
<title>Prune Procedure</title>
<para>Remove elements of the Tcl list <emphasis>list</emphasis>.
Elements are fields delimited by spaces. The result is a copy of
list, without any elements that match <emphasis>pattern</emphasis>.
You can use the common shell wildcard characters to specify the
pattern.</para>
<funcsynopsis role="tcl">
<funcprototype>
<funcdef><function>prune</function></funcdef>
<paramdef><parameter>list</parameter>
<parameter>pattern</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<variablelist>
<varlistentry>
<term><parameter>list</parameter></term>
<listitem><para>A Tcl list containing the original data. Commonly
this is the output of a batch executed command, like running a
compiler.</para></listitem>
</varlistentry>
<varlistentry>
<term><parameter>pattern</parameter></term>
<listitem><para>The csh shell "glob" style pattern to search
for.</para></listitem>
</varlistentry>
</variablelist>
<para>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.</para>
</sect4>
<sect4 id="slay" xreflabel="slay procedure">
<title>Slay Procedure</title>
<para>This look in the process table for <emphasis>name</emphasis>
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.</para>
<funcsynopsis role="tcl">
<funcprototype>
<funcdef><function>slay</function></funcdef>
<paramdef><parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<variablelist>
<varlistentry>
<term><parameter>name</parameter></term>
<listitem><para>The name of the program to kill.</para></listitem>
</varlistentry>
</variablelist>
<para>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.</para>
</sect4>
<sect4 id="absolute" xreflabel="absolute procedure">
<title>Absolute Procedure</title>
<para>This procedure takes the relative <emphasis>path</emphasis>,
and converts it to an absolute path.</para>
<funcsynopsis role="tcl">
<funcprototype>
<funcdef><function>absolute</function></funcdef>
<paramdef><parameter>path</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<variablelist>
<varlistentry>
<term><parameter>path</parameter></term>
<listitem><para>The path to convert.</para></listitem>
</varlistentry>
</variablelist>
<para>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.</para>
</sect4>
<sect4 id="psource" xreflabel="psource procedure">
<title>Psource Procedure</title>
<para>This sources the file <emphasis>filename</emphasis>, and traps
all errors. It also ignores all extraneous output. If there was an
error it returns a <emphasis>1</emphasis>, otherwise it returns a
<emphasis>0</emphasis>.</para>
<funcsynopsis role="tcl">
<funcprototype>
<funcdef><function>psource</function></funcdef>
<paramdef><parameter>file</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem><para>The filename to Tcl script to
source.</para></listitem>
</varlistentry>
</variablelist>
<para>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.</para>
</sect4>
<sect4 id="runtestfilep" xreflabel="runtest_file_p procedure">

Loading…
Cancel
Save