General Information
===================

This library is GtkSheet version 4. 

It is a useful widget complementary to GTK+ for creating 
spreadsheet-like interfaces in Gtk+ Version 2.x and 3.x

The official web site is:
  http://fpaquet.github.io/gtksheet/

Prerequisites
=============

GtkSheet requires the following packages:

 - The GTK+ , GLib, Pango, ATK and Cairo libraries
   GTK+ 3.22.16 requires at least GLib 3.52.3,
   Pango 1.38.1, ATK 2.15.3 and Cairo 1.14.6.

 - The TIFF, PNG, and JPEG image loading libraries. You most
   likely have these installed on your system already. If not
   these libraries are available from:

   http://www.libtiff.org/
   http://www.libpng.org/
   http://www.ijg.org/

 - For generating GtkDoc reference docs and tutorial 
   you need GtkDoc 1.8 , Docbook 4.5 with all dependencies
   (docbook-to-man,docbook-xls,docbook-utils , openjade , 
   jadetex , tex-common , sgmlspl ,texlive ,tipa ,etc)

Installation
============

See the file 'INSTALL'

Documentation
=============

In preparation. Read the header files and test programs in the directory 
./src for further information and examples.

Release notes for GtkSheet:
==========================
see https://github.com/fpaquet/gtksheet/wiki

How to report bugs
==================

Bugs should be reported to the GitHub bug tracker.
You will need to create an account for yourself.
  
In the bug report please include:
  
* Information about your system. For instance:

   - What operating system and version
   - What graphical user interface
   - For Linux, what version of the GTK libraries.

  And anything else you think is relevant.

* How to reproduce the bug. 

  Please include a short test program that exhibits the behavior. 
  As a last resort, you can also provide a pointer to a larger 
  piece of software that can be downloaded.

* If the bug was a crash, the exact text that was printed out when the
  crash occured.

* Further information such as stack traces may be useful, but is not
  necessary. If you do send a stack trace, and the error is an X error,
  it will be more useful if the stacktrace is produced running the test
  program with the --sync command line option.

Patches
=======

Patches should also be submitted to GitHub. If the patch
fixes an existing bug, add the patch as an attachment to that bug
report.

Otherwise, enter a new bug report that describes the patch, and attach
the patch to that bug report.

Bug reports containing patches should include the PATCH keyword in their
keyword fields. If the patch adds to or changes the GtkSheet programming
interface, the API keyword should also be included.
  
Patches should be in git-diff form.

General Information
===================

This library is a fork of the GtkSheet widget included in the 
Gtk+-Extra library. It includes the GtkSheet widget, a widget
displaying a spreadsheet-like matrix.

The fork was taken in April 2018. The GtkSheet in the original
Gtk+-Extra widget set will no longer be maintained.

