doc: describe how kernel inotify support affects tail -f
authorJim Meyering <meyering@redhat.com>
Mon, 23 May 2011 14:09:42 +0000 (16:09 +0200)
committerJim Meyering <meyering@redhat.com>
Mon, 23 May 2011 14:09:52 +0000 (16:09 +0200)
* doc/coreutils.texi (tail invocation) [-f]: Mention how inotify
kernel support makes a difference.
Prompted by http://bugzilla.redhat.com/662900

doc/coreutils.texi

index 289c0ba..dfaf4c9 100644 (file)
@@ -2830,6 +2830,11 @@ no @var{file} operand is specified and standard input is a FIFO or a pipe.
 Likewise, the @option{-f} option has no effect for any
 operand specified as @samp{-}, when standard input is a FIFO or a pipe.
 
+With kernel inotify support, output is asynchronous and generally very prompt.
+Otherwise, @command{tail} sleeps for one second between checks---
+use @option{--sleep-interval=@var{N}} to change that default---which can
+make the output appear slightly less responsive or bursty.
+
 @item -F
 @opindex -F
 This option is the same as @option{--follow=name --retry}.  That is, tail