From f0225903440271bda1a9d6454d1a1c3f8947ee81 Mon Sep 17 00:00:00 2001
From: Dima Kogan <dima@secretsauce.net>
Date: Fri, 20 Sep 2013 22:45:53 -0700
Subject: [PATCH] added timefmt documentation

---
 bin/feedgnuplot | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/bin/feedgnuplot b/bin/feedgnuplot
index b3c8d0f..45bb4c1 100755
--- a/bin/feedgnuplot
+++ b/bin/feedgnuplot
@@ -1016,6 +1016,29 @@ C<replot> and we're plotting in realtime with C<--stream>, the plot will be
 refreshed immediately. If a line of data begins with C<clear>, the plot is
 cleared, to be re-filled with any data following the C<clear>.
 
+=head3 Time/date data
+
+If the input data domain is a time/date, this can be interpreted with
+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
+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
+instead of \t. When this flag is given, some other options act a little bit
+differently:
+
+=over
+
+=item
+
+C<--xlen> is in seconds
+
+=item
+
+C<--xmin> and C<--xmax> I<must> use the format passed in to C<--timefmt>
+
+=back
+
+
 =head2 Real-time streaming data
 
 To plot real-time data, pass in the C<--stream [refreshperiod]> option. Data
@@ -1030,7 +1053,8 @@ To plot only the most recent data (instead of I<all> the data), C<--xlen
 windowsize> can be given. This will create an constantly-updating, scrolling
 view of the recent past. C<windowsize> should be replaced by the desired length
 of the domain window to plot, in domain units (passed-in values if C<--domain>
-or line numbers otherwise).
+or line numbers otherwise). If the domain is a time/date via C<--timefmt>, then
+C<windowsize> is in seconds.
 
 =head2 Hardcopy output
 
@@ -1143,6 +1167,9 @@ As an example, if line 3 of the input is "0 9 1 20"
   --[no]3d             Do [not] plot in 3D. This only makes sense with --domain.
                        Each domain here is an (x,y) tuple
 
+  --timefmt [format]   Interpret the X data as a time/date, parsed with the given
+                       format
+
   --colormap           Show a colormapped xy plot. Requires extra data for the color.
                        zmin/zmax can be used to set the extents of the colors.
                        Automatically increments extraValuesPerPoint