From: Robert D. <rob...@us...> - 2007-07-23 02:07:27
|
Update of /cvsroot/maxima/maxima/doc/info In directory sc8-pr-cvs16.sourceforge.net:/tmp/cvs-serv10263/doc/info Modified Files: Input.texi Log Message: Revise with_stdout to accept a stream as well as a filename. * src/macsys.lisp: revise with_stdout code * doc/info/Input.texi: revise with_stdout documentation Index: Input.texi =================================================================== RCS file: /cvsroot/maxima/maxima/doc/info/Input.texi,v retrieving revision 1.59 retrieving revision 1.60 diff -u -d -r1.59 -r1.60 --- Input.texi 30 Jun 2007 19:10:41 -0000 1.59 +++ Input.texi 23 Jul 2007 02:07:23 -0000 1.60 @@ -1913,15 +1913,16 @@ @end defvr -@deffn {Function} with_stdout (@var{filename}, @var{expr_1}, @var{expr_2}, @var{expr_3}, ...) -Opens @var{filename} and then evaluates @var{expr_1}, @var{expr_2}, @var{expr_3}, .... -The values of the arguments are not stored in @var{filename}, -but any printed output generated by evaluating the arguments -(from @code{print}, @code{display}, @code{disp}, or @code{grind}, for example) -goes to @var{filename} instead of the console. +@deffn {Function} with_stdout (@var{f}, @var{expr_1}, @var{expr_2}, @var{expr_3}, ...) +@deffnx {Function} with_stdout (@var{s}, @var{expr_1}, @var{expr_2}, @var{expr_3}, ...) +Evaluates @var{expr_1}, @var{expr_2}, @var{expr_3}, ... +and writes any output thus generated to a file @var{f} or output stream @var{s}. +The evaluated expressions are not written to the output. +Output may be generated by @code{print}, @code{display}, @code{grind}, +among other functions. The global flag @code{file_output_append} governs -whether @code{with_stdout} appends or truncates the output file. +whether @code{with_stdout} appends or truncates the output file @var{f}. When @code{file_output_append} is @code{true}, @code{with_stdout} appends to the output file. Otherwise, @code{with_stdout} truncates the output file. |