README

Cairo::GObject
==============

Perl module to integrate Cairo into the Glib type system.

INSTALLATION
------------

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES
------------

This module requires these other modules and libraries:

  cairo-gobject (C library) >= 1.10.0
  Cairo (Perl module)       >= 1.080
  Glib (Perl module)        >= 1.224

In order to build it from source, you'll also need

  ExtUtils::Depends   >= 0.2
  ExtUtils::PkgConfig >= 1.0

HOW TO CONTACT US
-----------------
Mailing list:   gtk-perl-list [at] gnome.org
Homepage:       http://gtk2-perl.sourceforge.net/
IRC:            irc://irc.gnome.org/#gtk-perl
Bug submission: bug-Cairo-GObject [at] rt.cpan.org

Please do not contact any of the maintainers directly unless they ask you to.
The first point of contact for questions/problems/issues should always be the
mailing list.

BUG REPORTS
-----------
For help with problems, please contact the mailing list (above).  If you
already know you have a bug, please file it with one of the bug trackers
below.  With any problems and/or bug reports, it's always helpful for the
developers to have the following information:

- A small script that demonstrates the problem; this is not required, however,
  it will get your issue looked at much faster than a description of the
  problem alone.
- Version of Perl (perl -v)
- Versions of Gtk2-Perl modules (Glib/Gtk2/Pango/Cairo/Cairo-GObject)
- Versions of GTK+ libraries on your system (libglib, libgtk+, libpango,
  libcairo, etc.)

There are multiple project bug trackers, please choose the one you are most
comfortable with using and/or already have an account for.

Request Tracker; submitting bugs via the Web:
<https://rt.cpan.org/Public/Bug/Report.html?Queue=Cairo-GObject>
Submitting bugs via e-mail: bug-Cairo-GObject [at] rt.cpan.org

Gnome's bugtracker: report bugs to the gnome-perl product:
<http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl>

OBTAINING SOURCE FROM THE GNOME.ORG GIT REPO
--------------------------------------------
Assuming you already have the 'git' command installed on your system:

git clone git://git.gnome.org/perl-Cairo-GObject

-or-

git clone http://git.gnome.org/browse/perl-Cairo-GObject

To update an existing clone of the source, change into the source directory
and run:

git pull

PATCH SUBMISSION GUIDELINES
---------------------------
You can send us patches by...
- E-mailing it to the mailing list (above); please use a pastebin service of
  some kind for longer patchfiles (over say 20k in size).
- E-mail a git pull request from GitHub or another hosted Git service to the
  mailing list.
- Those with gnome.org Git ID's can push trivial patches to git directly; if
  you're not sure what a trivial patch is, please ask on the mailing list
  first prior to pushing your commit.

COPYRIGHT AND LICENSE
---------------------

Copyright (C) 2011 by the cairo perl team

Torsten Schoenfeld       kaffeetisch at gmx dot de

This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Library General Public License as published by the Free
Software Foundation; either version 2.1 of the License, or (at your option) any
later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU Library General Public License for more
details.

See the LICENSE file in the top level of this distribution for license terms.