slightly improved --timefmt documentation

This commit is contained in:
Dima Kogan 2013-09-20 23:13:55 -07:00
parent 809442e2dc
commit fad78b60b0

View File

@ -1023,8 +1023,8 @@ C<--timefmt>. This option takes a single argument: the format to use to parse
the data. The format is documented in 'set timefmt' in gnuplot, although the the data. The format is documented in 'set timefmt' in gnuplot, although the
common flags that L<strftime> understands are generally supported. The backslash common flags that L<strftime> understands are generally supported. The backslash
sequences in the format are I<not> supported, so if you want a tab, put in a tab sequences in the format are I<not> supported, so if you want a tab, put in a tab
instead of \t. When this flag is given, some other options act a little bit instead of \t. Whitespace in the format I<is> supported. When this flag is
differently: given, some other options act a little bit differently:
=over =over
@ -1038,6 +1038,19 @@ C<--xmin> and C<--xmax> I<must> use the format passed in to C<--timefmt>
=back =back
Using this option changes both the way the input is parsed I<and> the way the
x-axis tics are labelled. Gnuplot tries to be intelligent in this labelling, but
it doesn't always to what the user wants. The labelling can be controlled with
the gnuplot C<set format> command, which takes the same type of format string as
C<--timefmt>. Example:
$ sar 1 -1 |
awk '$1 ~ /..:..:../ && $8 ~/^[0-9\.]*$/ {print $1,$8; fflush()}' |
feedgnuplot --stream --domain
--lines --timefmt '%H:%M:%S'
--extracmds 'set format x "%H:%M:%S"'
This plots the 'idle' CPU consumption against time.
=head2 Real-time streaming data =head2 Real-time streaming data