doc: provide an example for prefixing all tail output lines

* doc/coreutils.texi (tail invocation): Provide an example using awk
to convert tail ==> file <== headers to file: prefixes on each line.
Suggested by Stephen Shirley.

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 7918aec6ab133e91ed927e1a2d78d9b4663dc714..88e16503d06445efdfd80ecb4a0bd20c9e1445cf 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2839,14 +2839,22 @@ tail [@var{option}]@dots{} [@var{file}]@dots{}
 @end example
 
 If more than one @var{file} is specified, @command{tail} prints a
-one-line header consisting of:
+one-line header before the output for each @var{file}, consisting of:
 
 @example
 ==> @var{file name} <==
 @end example
 
-@noindent
-before the output for each @var{file}.
+For further processing of tail output, it can be useful to convert the
+file headers to line prefixes, which can be done like:
+
+@example
+tail @dots{} |
+awk '
+  /^==> .* <==$/ @{prefix=substr($0,5,length-8)":"; next@}
+  @{print prefix$0@}
+' | @dots{}
+@end example
 
 @cindex BSD @command{tail}
 GNU @command{tail} can output any amount of data (some other versions of