From 7e0f2a431263f6c62db51003f110eb6a955a164e Mon Sep 17 00:00:00 2001
From: Dima Kogan <dima@secretsauce.net>
Date: Sun, 21 Feb 2021 00:31:39 -0800
Subject: [PATCH] documented --xticlabels

---
 bin/feedgnuplot              | 26 ++++++++++++++++++++++----
 completions/bash/feedgnuplot |  1 +
 completions/zsh/_feedgnuplot |  1 +
 3 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/bin/feedgnuplot b/bin/feedgnuplot
index 5c8fb99..3ce8379 100755
--- a/bin/feedgnuplot
+++ b/bin/feedgnuplot
@@ -399,6 +399,12 @@ sub interpretCommandline
       print STDERR "--3d does not make sense with circles (gnuplot doesn't support this)\n";
       exit -1;
     }
+
+    if ( $options{xticlabels} )
+    {
+      print STDERR "--3d makes no sense with --xticlabels\n";
+      exit -1;
+    }
   }
   else
   {
@@ -423,6 +429,12 @@ sub interpretCommandline
       exit -1;
     }
 
+    if ( $options{xticlabels} && @{$options{histogram}})
+    {
+      print STDERR "--histogram makes no sense with --xticlabels\n";
+      exit -1;
+    }
+
     for my $hist_curve(@{$options{histogram}})
     {
         my $hist_dim = getRangeSize($hist_curve);
@@ -1470,10 +1482,13 @@ network interface in bytes/second (uses bash, awk and Linux):
 
 =head1 DESCRIPTION
 
-This is a flexible, command-line-oriented frontend to Gnuplot. It creates
-plots from data coming in on STDIN or given in a filename passed on the
-commandline. Various data representations are supported, as is hardcopy
-output and streaming display of live data. A simple example:
+This is a flexible, command-line-oriented frontend to Gnuplot. It creates plots
+from data coming in on STDIN or given in a filename passed on the commandline.
+Various data representations are supported, as is hardcopy output and streaming
+display of live data. For a tutorial and a gallery please see the guide at
+L<https://github.com/dkogan/feedgnuplot/blob/master/guide/guide.org>
+
+A simple example:
 
  $ seq 5 | awk '{print 2*$1, $1*$1}' | feedgnuplot
 
@@ -2319,6 +2334,9 @@ Print the version and exit
 
 =head1 RECIPES
 
+For a tutorial and a gallery please see the guide at
+L<https://github.com/dkogan/feedgnuplot/blob/master/guide/guide.org>
+
 =head2 Basic plotting of piped data
 
  $ seq 5 | awk '{print 2*$1, $1*$1}'
diff --git a/completions/bash/feedgnuplot b/completions/bash/feedgnuplot
index a9840b3..bbb3b5a 100644
--- a/completions/bash/feedgnuplot
+++ b/completions/bash/feedgnuplot
@@ -66,4 +66,5 @@ complete -W               \
     --zlabel              \
     --zmax                \
     --zmin                \
+    --xticlabels          \
     --vnlog ' feedgnuplot
diff --git a/completions/zsh/_feedgnuplot b/completions/zsh/_feedgnuplot
index 1ab075c..53b40c7 100644
--- a/completions/zsh/_feedgnuplot
+++ b/completions/zsh/_feedgnuplot
@@ -67,4 +67,5 @@ _arguments -S
     '--version'                                                                   \
     '--help'                                                                      \
     '--timefmt[Format for time/date data]:time format'                            \
+    '--xticlabels[x-axis tic labels are read from the data]'                      \
     '--vnlog[column IDs come from a vnlog header]'