summaryrefslogtreecommitdiffstats
path: root/lineio.txi
diff options
context:
space:
mode:
Diffstat (limited to 'lineio.txi')
-rw-r--r--lineio.txi19
1 files changed, 10 insertions, 9 deletions
diff --git a/lineio.txi b/lineio.txi
index 34d42d5..22a1774 100644
--- a/lineio.txi
+++ b/lineio.txi
@@ -11,10 +11,10 @@ omitted, in which case it defaults to the value returned by
@code{current-input-port}.
@end defun
-@defun read-line! string
+@deffn {Procedure} read-line! string
-@defunx read-line! string port
+@deffnx {Procedure} read-line! string port
Fills @var{string} with characters up to, but not including a newline or end
of file, updating the @var{port} to point to the last character read
or following the newline if it was read. If no characters are
@@ -23,7 +23,7 @@ of file was found, the number of characters read is returned.
Otherwise, @code{#f} is returned. The @var{port} argument may be
omitted, in which case it defaults to the value returned by
@code{current-input-port}.
-@end defun
+@end deffn
@defun write-line string
@@ -32,14 +32,15 @@ omitted, in which case it defaults to the value returned by
Writes @var{string} followed by a newline to the given @var{port} and returns
an unspecified value. The @var{Port} argument may be omitted, in
which case it defaults to the value returned by
-@code{current-input-port}.@refill
+@code{current-input-port}.
@end defun
-@defun display-file path
+@defun system->line command tmp
-@defunx display-file path port
-Displays the contents of the file named by @var{path} to @var{port}. The
-@var{port} argument may be ommited, in which case it defaults to the
-value returned by @code{current-output-port}.
+@defunx system->line command
+@var{command} must be a string. The string @var{tmp}, if supplied, is a path to use as
+a temporary file. @code{system->line} calls @code{system} with @var{command} as argument,
+redirecting stdout to file @var{tmp}. @code{system->line} returns a string containing the
+first line of output from @var{tmp}.
@end defun