summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2011-05-24 06:44:24 +0200
committerJim Meyering <meyering@redhat.com>2011-05-24 12:04:54 +0200
commit64ceb14984cbeb5d73a19a2ee1cc1c718f46a4de (patch)
treec6981e7065cc0066d6b43f6000307bd60963b5c9
parent0a8d30534b4285eec464a684694c0f0dc3810f1e (diff)
downloadcoreutils-64ceb14984cbeb5d73a19a2ee1cc1c718f46a4de.tar.xz
doc: improve tail -f vs. inotify description and advice
* doc/coreutils.texi (tail invocation): Adjust, and add an example.
-rw-r--r--doc/coreutils.texi9
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index fa7e015f1..c091b7fea 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2830,10 +2830,17 @@ 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.
+With kernel inotify support, output is triggered by file changes
+and is 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.
+When using tail without inotify support, you can make it more responsive
+by using a sub-second sleep interval, e.g., via an alias like this:
+
+@example
+alias tail='tail -s.1'
+@end example
@item -F
@opindex -F