
What is Guppi?
==============

Guppi is a GPLed Gnome-based guile-scriptable plot program with
integrated statistics capabilities.

It is still in an early stage of development.  The current functionality is
very limited.  The source code is the only documentation.


Contact Info
============

The Guppi web page is at http://www.gnome.org/guppi.

To subscribe to the Guppi mailing list, send a message with "subscribe"
as the subject to guppi-list-request@gnome.org.

Bug reports and suggestions can be formally submitted via the Gnome
bug-tracking system at http://bugs.gnome.org.  Keep in mind, though, that
Guppi is a very, very new piece of alpha-level software.  We *know* that
there are lots of bugs and that there is a long list of missing features.
The only bug reports that would be really useful to us would involve subtle
issues.  (If you aren't sure whether or not your problem is subtle, wait a
few releases before making a report.)

Other correspondence about Guppi can be sent to Jon Trowbridge <trow@gnu.org>.

If you are interested in Guppi and live in the Chicago area, drop me
(Jon) a line.


Helping Out
===========

If you would like to assist in Guppi's development, please do!  There
is plenty to do, even if you aren't a programmer.

If you are a programmer and have specific enhancements and/or fixes
that you want to do, you should probably contact Jon Trowbridge
<trow@gnu.org> and/or guppi-list *before* you start.  Guppi is young
enough to be in constant flux, and unannounced patches may be rejected
because they do not integrate well with Guppi's planned future
development.

(By the way, I know that my C coding practices are not even close to
the GNU style guidelines.  Please humor me on this issue.)


Requirements
============

 * Gtk+ 1.2.0 or later, gnome-libs 1.0.53 or later, etc.
 * gnome-xml
 
   These are all available as RPMs at www.gnome.org, and are also
   nicely packed for Debian 2.2 ("potato") or later.  If you are
   building Guppi from sources, be sure to install the development
   packages as well.  (These usually have names like "foo-dev" or
   "libfoo123-dev".)

   Hopefully you have these (or at least the user libraries) installed
   already.

 * gnome-print

   Mandrake (www.mandrake.com) seems to have nice RPMs for
   gnome-print (and gnome-print-devel, if you are building from 
   sources).

   gnome-print is packaged for Debian 2.2 ("potato").

 * Guile 1.3.4 or later.  Earlier versions will not work.

   You can check which version of Guile you have by running
   "guile-config --version"

   I believe that the version of Guile in RH6.x (where x<2) is 1.3.0
   or 1.3.2 --- I've been told there is a problem with it.  In fact,
   it has been reported that pretty much all of the 1.3.4 RPMs out there
   are broken in one way or another.

   If you need to get a working version of Guile 1.3.4 installed on an
   RPM-based system, use the RPMs at ftp://ftp.gnome.org/pub/guppi/RPMS.

   Debian 2.2's ("potato") standard guile package is the correct version.
   It even works.  If you are building Guppi from sources, be sure to also
   install "libguile6-dev".

* perl 5

  If you are building from the sources, you need some incarnation
  of perl 5.  Doesn't everyone have perl laying around?


Installation Notes
==================

Some platforms get unresolved symbols when building the shared
libraries.  A work around is to run configure with the
--enable-sluggish-linking option, which causes extra information to be
passed in when the libraries are being built.  (This fix imposes a
surprisingly large amount of extra overhead on unaffected platforms;
hence the name of the option.)


A Note About Licenses
=====================

As mentioned above, Guppi is distributed under the Gnu General Public
License (GPL).  If you are not familiar with the GPL, you can read
about in the file COPYING that you should have gotten along with
Guppi.  If you can't find that file, you can read the text of the GPL
at http://www.gnu.org/copyleft/gpl.html.

The GPL does not restrict your use of Guppi.  You may use it, modify
it, or extend it in any way you want.  However, any loadable modules
or plug-ins that are designed for use with Guppi are considered to be
extensions of Guppi, and hence may only be distributed under a license
that is legally compatible with the GPL.

You can learn about licenses that are and are not GPL-compatible at
http://www.gnu.org/philosophy/license-list.html.  If you have any
questions about whether or not your code is distributable, contact Jon
Trowbridge <trow@gnu.org>.

