[nongnu] elpa/gnuplot 2c1e7cb 177/184: Rewrite README.org

[ELPA Syncer]

branch: elpa/gnuplot
commit 2c1e7cbe65961fdbf0488c045c5684233e18a987
Author: mtreca <maxime.treca@gmail.com>
Commit: mtreca <maxime.treca@gmail.com>

    Rewrite README.org
---
 INSTALL.org |  91 --------------------
 README.org  | 275 ++++++++++++++++++++++++++++++++----------------------------
 gnuplot.el  | 121 --------------------------
 3 files changed, 149 insertions(+), 338 deletions(-)

diff --git a/INSTALL.org b/INSTALL.org
deleted file mode 100644
index b73c1ce..0000000
--- a/INSTALL.org
+++ /dev/null
@@ -1,91 +0,0 @@
-
-* Installing gnuplot-mode from Git repository or .tar.gz
-  The easiest way to install gnuplot-mode in a recent Emacs is to use
-  the Emacs package system with the MELPA repository, or the el-get
-  package (described in README.org). Either method will install the
-  most recent gnuplot-mode from the 
[[https://github.com/emacsorphanage/gnuplot][Github repository]]. If you want to
-  install gnuplot-mode yourself from a cloned repository, read on.
-
-  Gnuplot-mode has been included with Gnuplot since the 3.7
-  distribution. The installation instructions for the free-standing
-  distribution have been modified to be consistent with that.
-
-** Normal installation (configure + make)
-   1. Type ~./configure~.
-
-      If configure doesn't work for you, you can use ~Makefile.dst~
-      instead: see [[Installing without configure or make]] below.
-
-      You can specify the Emacs executable to use for byte-compiling
-      by using the ~EMACS~ environment variable. On Mac OS X, if your
-      Emacs application is located at ~/Applications/Emacs.app~, you
-      should do ~./configure
-      EMACS=/Applications/Emacs.app/Contents/MacOS/Emacs~
-
-      You can also specify the ~--with-lispdir=~ switch to change
-      where ~make install~ will put the compiled Lisp files, for
-      example to install them in your ~.emacs.d~ directory.
-
-      If you build this from a shell within Emacs itself and get
-      strange issues with load paths or environment variables, build
-      it in a separate terminal
-
-   2. Run ~make~.  There will be some compilation warnings, but they
-      should be harmless.
-
-   3. To make the reference card, run ~make pdf~ or ~make ps~.
-
-   4. Run ~make install~, or manually move the lisp files to the
-      system site_lisp directory if you are installing as root. If you
-      are installing as a normal user, move the ~.elc~ files to a
-      place where emacs can find them, e.g. your personal ~.emacs.d~.
-
-** Installing without configure or make
-   If ~configure~ fails for some reason, you can use the included
-   ~Makefile.dst~ file by doing ~make -f Makefile.dst~. This makefile
-   doesn't include an install target, so you'll have to install the
-   ~.elc~ files manually. It does have targets to build the
-   gnuplot-mode reference card (~pdf~, ~ps~ or ~all~).
-
-   The "configure; make" sequence may not work on all systems,
-   particularly Win32 systems. The long-winded way of making the .elc
-   and gpelcard.ps files is to edit each of the .el files with emacs
-   and do ~M-x byte-compile-file~. Then ~latex gpelcard.tex~ and
-   ~dvips gpelcard.dvi~, or ~pdflatex gpelcard.tex~.
-
-* Post-installation setup
-   1. Enable gnuplot mode from your emacs configuration (see README.org).
-
-   2. The function ~gnuplot-info-lookup-symbol~ looks at the Gnuplot
-      info file that comes with this package or that can be made from
-      the Gnuplot distribution.  For that function to work, the file
-      gnuplot.info must be placed somewhere where info can find it, for
-      example ~/usr/info~  A line like this in your .emacs allows you to
-      put gnuplot.info any place convenient:
-      ~(add-to-list 'Info-default-directory-list "/path/to/file")~
-
-* Build-system files
-  The included ~configure~, ~aclocal.m4~ and ~Makefile.in~ files were
-  generated from ~configure.ac~ and ~Makefile.am~ using GNU autotools
-  2.69. If you want to regenerate them for some reason, do the
-  following:
-
-  : autoreconf
-  : automake --add-missing
-
-  The build- and installation-related files are the following:
-
-  | File               | Description                                          |
-  |--------------------+------------------------------------------------------|
-  | configure.ac       | Definitions for `autoconf`                           |
-  | Makefile.am        | Definitions for `automake`                           |
-  | Makefile.dst       | Alternative makefile, avoiding configure & autotools |
-  | dot.el             | a short lisp file used by Makefile.dst               |
-  | configure          | `configure` script generated from configure.ac       |
-  | aclocal.m4         | m4 macros generated from configure.ac                |
-  | Makefile.in        | Makefile template generated from Makefile.am         |
-  | install-sh         | scripts needed by configure and make                 |
-  | missing            |                                                      |
-
-* Problems?
-  Submit an issue on github: https://github.com/emacsorphanage/gnuplot
diff --git a/README.org b/README.org
index c3a054c..6dca378 100644
--- a/README.org
+++ b/README.org
@@ -1,74 +1,168 @@
+#+TITLE: Gnuplot for Emacs
 
-* gnuplot-mode, version 0.7
+This package allows running [[http://www.gnuplot.info/][gnuplot]] files from 
within the [[https://www.gnu.org/software/emacs/][GNU Emacs]]
+editor. It features:
 
-  This directory contains files for running Gnuplot from within emacs.
-  See the homepage at https://github.com/emacsorphanage/gnuplot
+- Syntax highlighting and indentation for gnuplot scripts.
+- Pull-down menus for common gnuplot-related tasks.
+- Interactive gnuplot sessions using =comint=.
+- Context-sensitive completion.
+- Inline display of gnuplot plots.
 
-** Contents
+It is recommended to run =gnuplot-mode= on GNU Emacs 25 or above,
+using gnuplot version 5.0 or above.
 
-   | File               | Description                                          
|
-   
|--------------------+------------------------------------------------------|
-   | README.org         | this file                                            
|
-   | INSTALL.org        | thorough installation instructions                   
|
-   | gnuplot.el         | gnuplot mode for emacs                               
|
-   | gnuplot-gui.el     | a GUI for setting command arguments interactively    
|
-   | gnuplot-context.el | context-sensitive completion and help lookup         
|
-   | gnuplot.info       | info version of gnuplot 4.6 help                     
|
-   | gpelcard.tex       | quick reference card for gnuplot mode (latex)        
|
+* Installation
+** Using MELPA
 
-** Installation
-*** Installing from MELPA
-    In recent versions of Emacs, gnuplot-mode can be installed directly
-    from the [[http://melpa.milkbox.net][MELPA]] package repository as the 
~gnuplot~ package (note:
-    not ~gnuplot-mode~, which is an alternative gnuplot package).
+The easiest way to install =gnuplot-mode= is to directly get it from
+[[http://melpa.milkbox.net][MELPA]]. After 
[[http://melpa.milkbox.net/#installing][configuring Emacs to use MELPA]], you 
should be able to
+install gnuplot-mode by typing
 
-    After [[http://melpa.milkbox.net/#installing][configuring Emacs to use 
MELPA]], you should be able to
-    install gnuplot-mode by typing
-    : M-x install-package RET gnuplot RET
+: M-x install-package RET gnuplot RET
 
-    Or do ~M-x list-packages~ and search for "gnuplot" in the list.
+or do =M-x list-packages= and search for =gnuplot= in the list.
 
-*** Installing using el-get
-    [[https://github.com/dimitri/el-get.git][El-get]] includes a gnuplot-mode 
recipe. So to install simply call,
+** Using =el-get=
 
-    : M-x el-get-install RET gnuplot-mode
+The [[https://github.com/dimitri/el-get.git][el-get]] package includes a 
gnuplot-mode recipe. So to install
+simply call
 
-    Alternatively, you can place the following in your init file so that
-    ~el-get~ can install and load gnuplot-mode at Emacs start up.
+: M-x el-get-install RET gnuplot-mode
 
-    : (el-get 'sync 'gnuplot-mode)
+Alternatively, you can directly place the following in your init file so that
+=el-get= can install and load gnuplot-mode at Emacs start up:
 
-*** Installing from cloned repository or .tar.gz
-    See the file INSTALL.org for details.
+: (el-get 'sync 'gnuplot-mode)
 
-** Documentation
-*** Configuration Example
+** From source
 
-First of all, make sure that =gnuplot.el= is in your load-path (this is 
automatic if using a package helper like use-package). To do so manually, us 
something like
+After fetching the package's source from 
[[https://github.com/emacsorphanage/gnuplot][the homepage]], byte-compile
+the package's files using either
+
+: ./configure && make
+
+or
+
+: make -f Makefile.dst
+
+and move the compiled =.elc= files to your chosen target directory.
+
+* Configuration
+** Load Path
+
+First of all, make sure that =gnuplot.el= is in your load-path (this is 
automatic if using a package helper like use-package). To do so manually, add 
the following snippet in your emacs configuration file
 
 #+begin_src emacs-lisp
 (add-to-list 'load-path "/path/to/gnuplot")
 #+end_src
 
-A basic gnuplot configuration can be found below.
+** Info File
+
+The function =gnuplot-info-lookup-symbol= looks at the Gnuplot info
+file. For that function to work, a =gnuplot.info= file must be placed
+somewhere where info can find it. You can either use the file provided
+by this package or a locally installed one. The following snippet
+allows you to put the =gnuplot.info= any place convenient:
 
 #+begin_src emacs-lisp
-;; these lines enable the use of gnuplot mode
-(autoload 'gnuplot-mode "gnuplot" "gnuplot major mode" t)
-(autoload 'gnuplot-make-buffer "gnuplot" "open a buffer in gnuplot mode" t)
+(add-to-list 'Info-default-directory-list "/path/to/info/file")
+#+end_src
 
-;; this line automatically causes all files with the .gp extension to be 
loaded into gnuplot mode
-(setq auto-mode-alist (append '(("\\.gp$" . gnuplot-mode)) auto-mode-alist))
+** Enable Mode
 
-;; This line binds the function-9 key so that it opens a buffer into gnuplot 
mode
-(global-set-key [(f9)] 'gnuplot-make-buffer)
+You can automatically enable =gnuplot-mode= using the snippet below:
+
+#+begin_src emacs-lisp
+(autoload 'gnuplot-mode "gnuplot" "Gnuplot major mode" t)
+(autoload 'gnuplot-make-buffer "gnuplot" "open a buffer in gnuplot-mode" t)
+(setq auto-mode-alist (append '(("\\.gp$" . gnuplot-mode)) auto-mode-alist))
 #+end_src
 
-*** Reference Card
+* Usage
+
+Apart from enabling =gnuplot-mode= automatically (see above), these
+two functions are useful for starting up gnuplot-mode:
+
+- =M-x gnuplot-mode= : start gnuplot-mode in the current buffer
+- =M-x gnuplot-make-buffer= : open a new buffer (which is not visiting
+  a file) and start gnuplot-mode in that buffer
+
+
+** Bindings
+
+When =gnuplot-mode= is on, the following keybindings are available:
 
- A reference card for gnuplot-mode can be compiled using the =gpelcard.tex= 
file included in this package.
+| C-c C-l        | send current line to gnuplot                         |
+| C-c C-v        | send current line to gnuplot and move forward 1 line |
+| C-c C-r        | send current region to gnuplot                       |
+| C-c C-b        | send entire buffer to gnuplot                        |
+| C-c C-f        | send a file to gnuplot                               |
+| C-c C-i        | insert filename at point                             |
+| C-c C-n        | negate set option on current line                    |
+| C-c C-c        | comment region                                       |
+| C-c C-o        | set arguments for command at point                   |
+| S-mouse-2      | set arguments for command under mouse cursor         |
+| C-c C-d        | read the gnuplot info file                           |
+| C-c C-e        | show-gnuplot-buffer                                  |
+| C-c C-k        | kill gnuplot process                                 |
+| C-c C-z        | customize gnuplot-mode                               |
+| M-tab or M-ret | complete keyword before point                        |
+| ret            | newline and indent                                   |
+| tab            | indent current line                                  |
+| C-c M-i        | toggle inline plot display in comint buffer          |
 
-*** Usage on Windows
+
+With the exception of the commands for sending commands to Gnuplot,
+most of the above commands also work in the Gnuplot comint buffer, in
+addition to the following:
+
+| M-C-p   | plot the most recent script buffer line-by-line   |
+| M-C-f   | save the current script buffer and load that file |
+| C-c C-e | pop back to most recent script buffer             |
+
+** Context-sensitive keyword completion
+
+By default gnuplot-mode will try to parse your commands as you type
+and suggest only relevant completion candidates on typing =M-TAB= or
+=TAB=. For example, with point after the =with= of a =plot= command,
+tab completion will suggest only plotting styles. This also enables
+more specific help topic lookup in the gnuplot info file, provided you
+have the right version of =gnuplot.info= installed (see the
+Installation section for isntructions).
+
+If the context-sensitivity annoys you, you can get simple
+non-context-sensitive completion back by toggling
+=gnuplot-context-sensitive-mode=. See also the variable
+=gnuplot-tab-completion=.
+
+By its nature, the completion code has to know a fair bit about the
+structure of the gnuplot language. If you use it with an old version
+of gnuplot (pre version 4) it will make mistakes. Most of gnuplot
+4.6's command language is parsed correctly except for the =set
+terminal= commands.
+
+** Eldoc mode
+
+If you install the file =gnuplot-eldoc.el= from a recent Gnuplot
+distribution, gnuplot-mode can show syntax hints in the modeline when
+~eldoc-mode~ is turned on and context sensitivity is enabled.
+    
+** Inline Images
+
+You can optionally have plots displayed inline in the Gnuplot comint
+process buffer. This is handy for trying things out without having to
+switch between Emacs and the Gnuplot display. Call
+=gnuplot-inline-imge-mode= or type ~C-c M-i~ in a gnuplot-mode buffer
+to try it out. This feature is implemented using temporary =png=
+files, and is also somewhat experimental. It requires Gnuplot to have
+=png= support and a GNU Emacs with image support. Please report bugs.
+
+
+
+* FAQ / Remarks
+
+** Usage on Windows
 
 Multiple users have reported issues when trying to work with
 =gnuplot.el= on Windows. Most notably, the gnuplot process hangs after
@@ -97,85 +191,14 @@ You currently have two solutions:
    We would like to implement a send-buffer without comint as well
    eventually.
 
-More information on =gnuplot.el= and WIndows can be found on these threads: 
[[https://github.com/emacsorphanage/gnuplot/issues/15][1]], 
[[https://github.com/emacsorphanage/gnuplot/pull/33][2]]
-
-** New features for gnuplot-mode 0.7
-   Version 0.7 of gnuplot-mode is designed for use with gnuplot
-   version 4.4 and up. It will also mostly work fine with older
-   versions. If it doesn't work with newer versions, report a bug.
-
-   This version has mostly been tested under GNU Emacs 25.
-   It should also work on GNU Emacs 24.3 and above.
-
-*** New syntax for gnuplot version 4
-    This version of gnuplot-mode supports the new curly-brace-block
-    ~do~ and ~if~ statements introduced in recent versions of gnuplot.
-    The indentation code to handle these is pretty simple, but should
-    work. Please report any bugs. The number of columns to offset
-    inner blocks is controlled by the ~gnuplot-basic-offset~ variable.
-
-*** Context-sensitive keyword completion
-    By default gnuplot-mode will try to parse your commands as you
-    type and suggest only relevant completion candidates on typing
-    M-TAB or TAB. For example, with point after the ~with~ of a ~plot~
-    command, tab completion will suggest only plotting styles. This
-    also enables more specific help topic lookup in the gnuplot info
-    file, provided you have the right version of ~gnuplot.info~
-    installed.
-
-    If the context-sensitivity annoys you, you can get simple
-    non-context-sensitive completion back by toggling
-    ~gnuplot-context-sensitive-mode~. See also the variable
-    ~gnuplot-tab-completion~.
-
-    By its nature, the completion code has to know a fair bit about
-    the structure of the gnuplot language. If you use it with an old
-    version of gnuplot (pre version 4) it will make mistakes. Most of
-    gnuplot 4.6's command language is parsed correctly except for the
-    =set terminal= commands.
-
-*** Eldoc mode
-    If you install the file ~gnuplot-eldoc.el~ from a recent Gnuplot
-    distribution, gnuplot-mode can show syntax hints in the modeline
-    when ~eldoc-mode~ is turned on and context sensitivity is enabled.
-
-*** Inline images
-    You can optionally have plots displayed inline in the Gnuplot
-    comint process buffer. This is handy for trying things out without
-    having to switch between Emacs and the Gnuplot display. Call
-    ~gnuplot-inline-imge-mode~ or type ~C-c M-i~ in a gnuplot-mode
-    buffer to try it out. This feature is implemented using temporary
-    ~.png~ files, and is also somewhat experimental. It requires
-    Gnuplot to have ~png~ support and a GNU Emacs with image support.
-    Please report bugs.
-
-** NOTES
-   1. The gnuplot-mode distribution comes with the version of the gnuplot
-      info file that gets made by gnuplot 4.6.  Use it rather than the
-      old one.  If you really must use the older info file, see the
-      document string for the variable `gnuplot-info-hook'.  If you
-      already have the info file installed on your computer, you will not
-      need the one that comes with gnuplot-mode.
-
-   2. The interactive graphical graphical interface to setting command
-      arguments contained in gnuplot-gui.el is experimental. It is
-      incomplete and may make mistakes. Hopefully, you will find it
-      useful. It *requires* that you are using a version of emacs with
-      the widget library installed or that you have installed it
-      yourself. Version numbers in the 20's of Emacs and XEmacs ship
-      with the widget library.
-
-   3. Gnuplot's ~pause -1~ command, which waits for the user to press a
-      key, is problematic when running under Emacs.  Sending =pause -1=
-      to the running gnuplot process will make Emacs appear to freeze.
-      (It isn't really crashed: typing =C-g= will unlock it and let you
-      continue).  The workaround for now is to make Gnuplot output a
-      string before pausing, by doing
-      : pause -1 "Hit return"
-      or similar.  Thanks to Jim Mehl for reporting this issue.
-
-** The todo list
-   1. Use [[http://tromey.com/elpa/][ELPA]]
-
-      Gnuplot-mode is already on http://melpa.milkbox.net, but it would
-      be good to get it into the other repositories too.
+More information on =gnuplot.el= and Windows can be found on these threads: 
[[https://github.com/emacsorphanage/gnuplot/issues/15][1]], 
[[https://github.com/emacsorphanage/gnuplot/pull/33][2]]
+
+
+** Pause Command
+
+Gnuplot's =pause -1= command, which waits for the user to press a key,
+is problematic when running under Emacs. Sending =pause -1= to the
+running gnuplot process will make Emacs appear to freeze. (It isn't
+really crashed: typing =C-g= will unlock it and let you continue). The
+workaround for now is to make Gnuplot output a string before pausing,
+by doing =pause -1 "Hit return"= or similar.
diff --git a/gnuplot.el b/gnuplot.el
index f0cd62d..be18573 100644
--- a/gnuplot.el
+++ b/gnuplot.el
@@ -37,119 +37,12 @@
 ;; This version of gnuplot-mode has been tested mostly on GNU Emacs
 ;; 25.
 ;;
-;;
-;; This mode offers several tools to help you compose your scripts,
-;; including font-lock syntax colorization, a syntax table appropriate
-;; to gnuplot, key bindings, pull-down menus, indentation, keyword
-;; completions and variable customization using the Custom package.
-;; Once the script is composed, there are several function for sending
-;; some or all of the script to gnuplot.  The interaction with the
-;; gnuplot process is within a comint buffer.  Plots can optionally be
-;; displayed within Emacs.
-;;
-;;    C-c C-l       send current line to gnuplot
-;;    C-c C-v       send current line to gnuplot and move forward 1 line
-;;    C-c C-r       send current region to gnuplot
-;;    C-c C-b       send entire buffer to gnuplot
-;;    C-c C-f       send a file to gnuplot
-;;    C-c C-i       insert filename at point
-;;    C-c C-n       negate set option on current line
-;;    C-c C-c       comment region
-;;    C-c C-o       set arguments for command at point
-;;   S-mouse-2      set arguments for command under mouse cursor
-;;    C-c C-d       read the gnuplot info file
-;;    C-c C-e       show-gnuplot-buffer
-;;    C-c C-k       kill gnuplot process
-;;    C-c C-u       submit a bug report about gnuplot-mode
-;;    C-c C-z       customize gnuplot-mode
-;; M-tab or M-ret   complete keyword before point
-;;      ret         newline and indent
-;;      tab         indent current line
-;;    C-c M-i       toggle inline plot display in comint buffer
-;;
-;; With the exception of the commands for sending commands to Gnuplot,
-;; most of the above commands also work in the Gnuplot comint buffer,
-;; in addition to the following:
-;;     M-C-p        plot the most recent script buffer line-by-line
-;;     M-C-f        save the current script buffer and load that file
-;;    C-c C-e       pop back to most recent script buffer
-;;
-;; These two functions are useful for starting up gnuplot-mode:
-;;
-;; M-x gnuplot-mode
-;;         start gnuplot-mode in the current buffer
-;;
-;; M-x gnuplot-make-buffer
-;;         open a new buffer (which is not visiting a file) and start
-;;         gnuplot-mode in that buffer
-;;
 ;; Gnuplot-mode now includes context-sensitive support for keyword
 ;; completion and, optionally, eldoc-mode help text.  See the
 ;; commentary in gnuplot-context.el for more information.  If you
 ;; don't find it useful, it can be turned off by customizing
 ;; `gnuplot-context-sensitive-mode'.
 ;;
-;;
-;; ---------------------------------------------------------------------
-;;
-;; Other Lisp files used by gnuplot.el
-;;
-;; gnuplot-gui.el (written by Bruce):
-;;   Defines the GUI interface for setting setting arguments to
-;;   gnuplot options.  This uses the widget package extensively.
-;;
-;; gnuplot-context.el (written by Jonathan, j.j.oddie@gmail.com)
-;;   Context-sensitive completion, help lookup and eldoc
-;;   strings for gnuplot buffers.  Should be byte-compiled before
-;;   using.
-;;
-;; ---------------------------------------------------------------------
-;;
-;; This mode was inspired by the original gnu-plot-mode by Gershon
-;; Elber, which is distributed with gnuplot itself and which dates
-;; back to the early 90's.  Although this mode encompasses the
-;; functionality of the original, the two share no code and the
-;; current implementation takes advantage of many features of modern
-;; versions of Emacs and adheres (or so I intend) to the major mode
-;; conventions described in the emacs-lisp reference for version 19
-;; and later.
-;;
-;; ---------------------------------------------------------------------
-;;
-;;                         Installation
-;;                         ============
-;;
-;; A recent version of this file can be found at
-;;   https://github.com/emacsorphanage/gnuplot/
-;;
-;; To autoload gnuplot-mode on any file with gp extension, put this in
-;; your .emacs file
-;;   (autoload 'gnuplot-mode "gnuplot" "gnuplot major mode" t)
-;;   (autoload 'gnuplot-make-buffer "gnuplot" "open a buffer in gnuplot-mode" 
t)
-;;
-;; Something like
-;;   (setq auto-mode-alist (append '(("\\.gp$" . gnuplot-mode))
-;;                                 auto-mode-alist))
-;; is useful for having files ending in .gp start up in gnuplot-mode.
-;;
-;; Something like
-;;   (global-set-key [(f9)] 'gnuplot-make-buffer)
-;; may be useful.  This binds f9 to the function that opens a scratch
-;; buffer (i.e. one that is not visiting a file) in gnuplot-mode.
-;; This is handy for your quick 'n' dirty plotting chores.
-;;
-;; To use the `gnuplot-info-lookup-symbol' function, the file
-;; gnuplot.info MUST be installed somewhere that info can find it.
-;; This means you must either:
-;;   1.  Copy gnuplot.info to the normal info directory or
-;;   2.  Make sure info can find gnuplot.info by putting this in your
-;;       .emacs file:
-;;         (setenv "INFOPATH"
-;;            (concat (getenv "INFOPATH") ":"
-;;                    (expand-file-name "/path/to/file")))
-;;       where "/path/to/file" is the location of gnuplot.info
-;;
-;;
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
 
@@ -180,20 +73,6 @@
 ;;  with the gnuplot 3.7-beta distribution and for providing me with
 ;;  installation materials
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;; To Do:
-;;
-;; 1. Since `gnuplot-display-process' can be nil, it would be
-;;    handy to have a function to put on
-;;    `gnuplot-after-plot-buffer-hook' to check and see if the script
-;;    executed properly.  Alas I am not sure how gnuplot signals its
-;;    errors.
-;; 2. improve plot, splot, fit in GUI
-;; 3. interface to setting bind command using `read-key-sequence'.
-;;    this is a pain because the nomenclature is really different in
-;;    gnuplot than in `read-key-sequence'
-;;
-;;
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
 ;;; Code: