      Ruby/PGPLOT ver 0.1.2 by Masahiro TANAKA  2001-09-20

= Description

  * Ruby interface to PGPLOT.
    It provides PGPLOT functions as a Ruby module.

= Requirement

  * PGPLOT ver 5.2.x
     (http://astro.caltech.edu/~tjp/pgplot/)
  * Ruby ver 1.6.x
  * NArray Extension library ver 0.5.x
     (http://www.ruby-lang.org/en/raa-list.rhtml?name=NArray)

= Installation

  * install PGPLOT library

    - requires FORTRAN77
    - requires construction of C interface library (libcpgplot.a)

  * install Ruby, NArray

  * install Ruby/PGPLOT

    - extract distribution.

    - compile and install by:

      ruby extconf.rb [options (see below)]
      make
      make site-install
      (or make install)

    - Options for `ruby extconf.rb':
       --with-sunws : PGPLOT is compiled with Sun WorkShop f77.
		      g77 is assumed without this option.
       --with-x11-dir=path	  : path of X11
       --with-pgplot-include=path : path of cpgplot.h
       --with-pgplot-lib=path	  : path of PGPLOT libraries.

      example:
       ruby extconf.rb --with-x11-dir=/usr/X11R6 \
	--with-pgplot-include=/usr/local/pgplot \
	--with-pgplot-lib=/usr/local/pgplot

= Usage

  * Environment variables for PGPLOT (csh):

      setenv PGPLOT_DIR  /usr/local/lib/pgplot/ # pgxwin_server, rgb.txt
      setenv PGPLOT_FONT ${PGPLOT_DIR}/grfont.dat
      setenv PGPLOT_DEV  /xwin

  * To load the Ruby/PGPLOT extension;

      require "pgplot"

  * Module name is `Pgplot'.  If you want to omit the module name;

      include Pgplot

  * Pgplot module method names are lower case of corresponding
    PGPLOT functions.  To start plotting:

      pgbeg('/xwin')

    See PGPLOT manual for function usage.
    Arguments are not always same as the FORTRAN PGPLOT.
    "FuncUsage" file includes a list of functions with
    different arguments.

= Platforms tested

  * Ruby 1.6.4 (2001-04-10) [sparc-solaris2.7]
  * gcc/g77 2.95.3
  * Sun WorkShop C/FORTRAN77 5.0

= License

  This program is free software.
  You can distribute/modify this program
  under the same terms as Ruby itself.
  NO WARRANTY.

= Acknowledgment

  M.T. thanks to Tim Pearson for developing the useful PGPLOT library
  and giving me the permission to distribute the Ruby version of pgdemos.
  M.T. also thanks to the developers of the Ruby language
  for providing the wonderful language.
