LEGALESE
~~~~~~~~
     Copyright (c) 1995 Ilya Zakharevich. All rights reserved.
     This program is free software; you can redistribute it and/or
     modify it under the same terms as Perl itself.

	You should have received a copy of the Perl license along with
	Perl; see the file README in Perl distribution.
 
	You should have received a copy of the GNU General Public License
	along with Perl; see the file Copying.  If not, write to
	the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

	You should have received a copy of the Artistic License
	along with Perl; see the file Artistic.


Author of this software makes no claim whatsoever about suitability,
reliability, edability, editability or usability of this product, and
should not be kept liable for any damage resulting from the use of
it. If you can use it, you are in luck, if not, I should not be kept
responsible. Keep a handy copy of your backup tape at hand.

WHAT
~~~~

This module is intended for low-resolution or high-resolution graphics
using gnuplot low-level functions. Documentation is at the start of
the .pm file.

INSTALL
~~~~~~~
You may need to edit LIBS line in Makefile.PL, and INC and CFLAGS lines
in gnuterm/Makefile.PL (as based on the included platform-specific
makefiles and READMEs in ./gnuterm directory), but if you do not
wish to support platform-specific terminals, this should work:

	perl Makefile.PL
	make
	make test
		(Check whether you are satisfied with the result.)
	make install

By default, the following libs are tried to be found:

  -L/usr/openwin/lib -lX11 -lm  -lsocket -lvga -llinuxvga \
    -lgd -lpng -lz -ljmgraph -lvesa

You may change this by putting "TRY_LIBS=suitable list" on the command line
of Makefile.PL.  (Say, I needed to remove -lgd since the header file
gd.h was for a newer version of gd than the library, and Term::Gnuplot
could not determine the version of gd correctly.)

If you needed some changed, and can automate them, please send patches to
the address below.  Currently the defines HAVE_LIBGD, HAVE_LIBPNG,
LINUXVGA, EMXVESA are automatically set to reasonable values.  X11 and DEBUG
terminals are always included.  Gnuplot 3.7 would also use 

 AMIGA ATARI MTOS _Macintosh DJGPP __ZTC__ PC NEXT APOLLO GPR IRIS MGR RGIP
 SCO SUN UIS UNIXPC UNIXPLOT GNUGRAPH DEBUG

Note that for some term types (such as X11, or PM) additional binaries are
needed.  They should be available if gnuplot is already installed on your
system.

AUTHOR BUGS
~~~~~~~~~~~
Ilya Zakharevich ilyaz@cpan.org

CHANGES
~~~~~~~
0.2: Test added.
0.3: Part of gnuplot3.5 distribution included to make it
	into turnkey installation, tested on OS/2, Solaris.
0.4: list_terms() added;
     interactive test for different terminals;
0.41:
     change_term_address(), term_tbl_address() added;

0.5:	uses Gnuplot 3.6pre built 340 (with a tiny patch, included);
	change_term returns 1 on success, 0 on failure;
0.51:	Does not need any change to Gnuplot source files.
0.55:	Updated to latest Gnuplot.h from PARI 2.0.13 (with do_init => init).
	setpointsize works now.
	set_gnuplot_fh() removed, replaced by plot_outfile_set().
	Updated to version 3.7.
	stdfn.c needed too...
	setpointsize(0.25) instead of pointsize().
	GD terminal was coring, since it required calling option before plot.
0.56:	Better docs, DEBUG terminal.
	Setup a line buffer for options() so that gnuplot error reporting
	works better.
	New functions plotsizes_scale(), term_init(), term_start_plot(),
	term_end_plot(), term_start_multiplot(), term_end_multiplot().
	New C API setup_gpshim().
	POD for Terminals.
0.5601: syscfg.h was not \n-terminated
	SET_OUTFILE() had wrong precedence of `,'.
0.57:	Updated to 3.7.1.  Gnuplot.h from PARI 2.0.17 used.
	New Makefile.PL option TRY_LIBS.
0.5701:	New function _term_descrs(), hash %description.
	A primitive support for direct-to-Tk drawing: create Tk
	canvas $c, call Term::Gnuplot::setcanvas($c), then use
	'tkcanvas' terminal with option 'tkperl_canvas'.  (Size is
	determined at the moment of doing set_options().)
0.5702:
	Add a check for gdCreateGif too;
	setcanvas was not exported;
	Change TERM_PUBLIC to 'extern' for our private functions in
	tkcanvas.trm.
	Make Tk serve events while in test.pl.
	BUGS with tkcanvas tests: Not realistic charcell/ticks sizes;
	    $ptk_canvas->delete($ptk_canvas->find('all')) if $ptk_canvas;
	segfaults; thus the canvas is not cleared between the iterations.

0.5703:
	$ptk_canvas->delete('all') works.  Go figure...
	Refcount the canvas.
	Off by one and 2 errors in the size of plotting area fixed.
	Same for offsets of plotting area (including borders).
	New make target gnuterm_dynamic to make loadable-at-runtime DLL.
	Now queries the font size and calculates ticks accordingly.
	Erase the canvas between builtin and Perl tests.

0.5704:
	Make x11 test optional if gnuplot_x11 is not on PATH.

0.570400:
	maybe_command_in_dirs() was removed from MakeMaker!!!
	File::Basename need to be used by Makefile.PL...
	-Zmt should be removed from cppflags on OS/2.
	remove file 'test_x11' on clean.
	distribute as bz2.
	$| in test file allows redirection of output...
	[XXX??? dumb terminal on DOSISH systems rights in binary mode???]

0.5705:
	Compensate for feature-deprived MakeMaker of newer Perls.

0.5706:
	Some (broken?) Linux distributions had unusable -lgd -lpng; now
		we check manually for presence of header files, and do not
		let Perl try -lgd -lpng if the header files are not there.