Re: guile.info: Reading

[Gary Houston]

> From: Alex Schroeder <address@hidden>
> Date: Mon, 24 Sep 2001 15:07:13 +0200
> 
> The documentation for drain-input is confusing -- or I am easily
> confused being a Scheme newbie.  :)
> 
>  - primitive: drain-input port
>      Drain PORT's read buffers (including any pushed-back characters)
>      and return the content as a single string.

You are not the first.  Would the following description be any
clearer?

This procedure clears a port's input and push-back buffers, similar to
the way that force-output clears the output buffer. The contents of
the buffers are returned as a single string. Draining the buffers may
be useful, for example, for cleanly finishing buffered I/O so that the
file descriptor can be used directly for further input.