summaryrefslogtreecommitdiffstats
path: root/lineio.txi
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2017-02-20 00:05:29 -0800
committerBryan Newbold <bnewbold@robocracy.org>2017-02-20 00:05:29 -0800
commit8466d8cfa486fb30d1755c4261b781135083787b (patch)
treec8c12c67246f543c3cc4f64d1c07e003cb1d45ae /lineio.txi
parent87b82b5822ca54228cfa6df29be3ad9d4bc47d16 (diff)
downloadslib-8466d8cfa486fb30d1755c4261b781135083787b.tar.gz
slib-8466d8cfa486fb30d1755c4261b781135083787b.zip
Import Upstream version 3a1upstream/3a1
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