1ANNOTATE-OUTPUT(1)          General Commands Manual         ANNOTATE-OUTPUT(1)
2
3
4

NAME

6       annotate-output - annotate program output with time and stream
7

SYNOPSIS

9       annotate-output program [args ...]
10

DESCRIPTION

12       annotate-output  will  execute  the specified program, while prepending
13       every line with the current time and O for stdout and E for stderr.
14
15

EXAMPLE

17       $ annotate-output make
18       21:41:21 I: Started make
19       21:41:21 O: gcc -Wall program.c
20       21:43:18 E: program.c: Couldn't compile, and took me ages to find out
21       21:43:19 E: collect2: ld returned 1 exit status
22       21:43:19 E: make: *** [all] Error 1
23       21:43:19 I: Finished with exitcode 2
24
25

BUGS

27       Since stdout and stderr are processed in parallel, it can  happen  that
28       some  lines received on stdout will show up before later-printed stderr
29       lines (and vice-versa).
30
31       This is unfortunately very hard to  fix  with  the  current  annotation
32       strategy.   A  fix  would  involve switching to PTRACE'ing the process.
33       Giving nice a (much) higher priority over the  executed  program  could
34       however cause this behaviour to show up less frequently.
35
36       The  program does not work as well when the output is not linewise.  In
37       particular, when an interactive program asks for  input,  the  question
38       might  not  be  shown until after you have answered it.  This will give
39       the impression that the annotated program has hung, while it has not.
40
41       annotate-output does not currently accept any command-line options,  so
42       --help, --version, and that kind of stuff do not currently work (unless
43       you install /usr/bin/--help ;) ).
44
45

TODO

47       Accept --help, --version command-line options.
48
49       Get rich with this very sophisticated piece of bash.
50
51

WEBSITE/SUPPORT

53       The  most  recent  version  of  this  utility  is  on  http://jeroen.A-
54       Eskwadraat.nl/sw/annotate
55
56       This  program  is  community-supported  (meaning: you'll need to fix it
57       yourself).  Patches are however appreciated, as is any feedback  (posi‐
58       tive or negative).
59
60

AUTHOR

62       annotate-output  was  written  by Jeroen van Wolffelaar <jeroen@wolffe‐
63       laar.nl> This manpage comes under the same copyright as annotate-output
64       itself,  read /usr/bin/annotate-output (or wherever you install it) for
65       the details.
66
67
68
69DEBIAN                         Debian Utilities             ANNOTATE-OUTPUT(1)
Impressum