From 96f301c72e7ca9ec7be0d1453f89fa8e6d49ee85 Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Tue, 18 Feb 2014 07:33:00 -0800 Subject: * stream.c (open_tail): Fix 2013-12-02 regression: seek_to_end_p argument being ignored, with the behavior being no initial seek to the end. * txr.1: Clarified the behavior of the seek-to-end-p option. --- txr.1 | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) (limited to 'txr.1') diff --git a/txr.1 b/txr.1 index a9a6d9ab..518fdc20 100644 --- a/txr.1 +++ b/txr.1 @@ -11628,9 +11628,16 @@ the same conventions as the mode argument of the C language fopen function. The mode string determines whether the stream is an input stream or output stream. Note that the "b" mode is not supported. Whether a stream is text or binary depends on which operations -are invoked on it. The argument is a boolean whcih -determines whether the initial read/write position is at the -start of the file, or just past the end. +are invoked on it. + +The argument is a boolean which determines whether the initial +read/write position is at the start of the file, or just past the end. This +argument only makes a difference if the file exists at the time open-tail is +called. If the file does not exist, and is later created, then the tail stream +will follow that file from the beginning. In other words, +controls whether the tail stream reads all the existing data in the file, if +any, or whether it reads only newly added data from approximately the time the +stream is created. A tail stream has special semantics with regard to reading at the end of file. A tail stream never reports an end-of-file condition; instead -- cgit v1.2.3