README
1Cairo::GObject
2==============
3
4Perl module to integrate Cairo into the Glib type system.
5
6INSTALLATION
7------------
8
9To install this module type the following:
10
11 perl Makefile.PL
12 make
13 make test
14 make install
15
16DEPENDENCIES
17------------
18
19This module requires these other modules and libraries:
20
21 cairo-gobject (C library) >= 1.10.0
22 Cairo (Perl module) >= 1.080
23 Glib (Perl module) >= 1.224
24
25In order to build it from source, you'll also need
26
27 ExtUtils::Depends >= 0.2
28 ExtUtils::PkgConfig >= 1.0
29
30HOW TO CONTACT US
31-----------------
32Mailing list: gtk-perl-list [at] gnome.org
33Homepage: http://gtk2-perl.sourceforge.net/
34IRC: irc://irc.gnome.org/#gtk-perl
35Bug submission: bug-Cairo-GObject [at] rt.cpan.org
36
37Please do not contact any of the maintainers directly unless they ask you to.
38The first point of contact for questions/problems/issues should always be the
39mailing list.
40
41BUG REPORTS
42-----------
43For help with problems, please contact the mailing list (above). If you
44already know you have a bug, please file it with one of the bug trackers
45below. With any problems and/or bug reports, it's always helpful for the
46developers to have the following information:
47
48- A small script that demonstrates the problem; this is not required, however,
49 it will get your issue looked at much faster than a description of the
50 problem alone.
51- Version of Perl (perl -v)
52- Versions of Gtk2-Perl modules (Glib/Gtk2/Pango/Cairo/Cairo-GObject)
53- Versions of GTK+ libraries on your system (libglib, libgtk+, libpango,
54 libcairo, etc.)
55
56There are multiple project bug trackers, please choose the one you are most
57comfortable with using and/or already have an account for.
58
59Request Tracker; submitting bugs via the Web:
60<https://rt.cpan.org/Public/Bug/Report.html?Queue=Cairo-GObject>
61Submitting bugs via e-mail: bug-Cairo-GObject [at] rt.cpan.org
62
63Gnome's bugtracker: report bugs to the gnome-perl product:
64<http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl>
65
66OBTAINING SOURCE FROM THE GNOME.ORG GIT REPO
67--------------------------------------------
68Assuming you already have the 'git' command installed on your system:
69
70git clone git://git.gnome.org/perl-Cairo-GObject
71
72-or-
73
74git clone http://git.gnome.org/browse/perl-Cairo-GObject
75
76To update an existing clone of the source, change into the source directory
77and run:
78
79git pull
80
81PATCH SUBMISSION GUIDELINES
82---------------------------
83You can send us patches by...
84- E-mailing it to the mailing list (above); please use a pastebin service of
85 some kind for longer patchfiles (over say 20k in size).
86- E-mail a git pull request from GitHub or another hosted Git service to the
87 mailing list.
88- Those with gnome.org Git ID's can push trivial patches to git directly; if
89 you're not sure what a trivial patch is, please ask on the mailing list
90 first prior to pushing your commit.
91
92COPYRIGHT AND LICENSE
93---------------------
94
95Copyright (C) 2011 by the cairo perl team
96
97Torsten Schoenfeld kaffeetisch at gmx dot de
98
99This library is free software; you can redistribute it and/or modify it under
100the terms of the GNU Library General Public License as published by the Free
101Software Foundation; either version 2.1 of the License, or (at your option) any
102later version.
103
104This library is distributed in the hope that it will be useful, but WITHOUT ANY
105WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
106PARTICULAR PURPOSE. See the GNU Library General Public License for more
107details.
108
109See the LICENSE file in the top level of this distribution for license terms.
110