README 4.09 KB
Newer Older
1
2
Cairo
=====
x-rwmcfa1's avatar
x-rwmcfa1 committed
3

4
Perl bindings to the cairo graphics library (http://www.cairographics.org).
x-rwmcfa1's avatar
x-rwmcfa1 committed
5
6

INSTALLATION
Torsten Schönfeld's avatar
Torsten Schönfeld committed
7
------------
x-rwmcfa1's avatar
x-rwmcfa1 committed
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

To avoid installing to a system directory, if you don't have root access,
you can change the installation prefix at Makefile.PL time with

   perl Makefile.PL PREFIX=/some/other/place

This will install the module to the subdirectory lib/perl5 under the given
prefix.  If this is not already in perl's include path, you'll need to tell
perl how to get to this library directory so you can use it; there are three
ways:

  in your environment (the easiest):
    # assuming a bourne-style shell
    PERL5LIB=/some/other/place/lib/perl5/site_perl
    export PERL5LIB

  on the perl command line:
    perl -I /some/other/place/lib/perl5/site_perl yourscript

  in the code of your perl script:
    use lib '/some/other/place/lib/perl5/site_perl';

DEPENDENCIES
Torsten Schönfeld's avatar
Torsten Schönfeld committed
38
------------
x-rwmcfa1's avatar
x-rwmcfa1 committed
39
40
41

This module requires these other modules and libraries:

Torsten Schönfeld's avatar
Torsten Schönfeld committed
42
  cairo (C library) >= 1.0.0
x-rwmcfa1's avatar
x-rwmcfa1 committed
43
44
45

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

46
47
  ExtUtils::Depends   >= 0.2
  ExtUtils::PkgConfig >= 1.0
48
  Test::Number::Delta >= 1.0
x-rwmcfa1's avatar
x-rwmcfa1 committed
49

50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
HOW TO CONTACT US
-----------------
Homepage:               http://gtk2-perl.sourceforge.net/
Mailing list:           gtk-perl-list [at] gnome.org
Mailing list archives:  https://mail.gnome.org/archives/gtk-perl-list/
IRC:                    irc://irc.gnome.org/#gtk-perl
E-mail bug submission via CPAN's RT:
                bug-Cairo [at] rt.cpan.org
Web bug submission via gnome.org's bugzilla:
                http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl

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.

Torsten Schönfeld's avatar
Torsten Schönfeld committed
65
66
BUG REPORTS
-----------
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
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)
- Optional, but nice to have: 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 (requires a PAUSE account/Bitcard):
  https://rt.cpan.org/Public/Bug/Report.html?Queue=Cairo
- submitting bugs via e-mail (open to anyone with e-mail):
  bug-Cairo [at] rt.cpan.org

Gnome's bugtracker:
- report bugs to the 'gnome-perl' product (requires login)
  http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl

93
94
95
96
97
98
99
100
101
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).
- 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 first on the mailing
  list prior to pushing your commit.

102
103
104
105
106
107
OBTAINING SOURCE FROM THE GNOME.ORG GIT REPO
--------------------------------------------
Assuming you already have the 'git' command installed on your system, you can
use the 'git://' protocol:

git clone git://git.gnome.org/perl-Cairo
Torsten Schönfeld's avatar
Torsten Schönfeld committed
108

109
110
111
112
113
114
115
116
117
118
Or, read-only access via HTTP:

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

To update an existing clone of the source:

git pull

Most Linux distros package the 'git' command in a package called 'git-core'.

x-rwmcfa1's avatar
x-rwmcfa1 committed
119
COPYRIGHT AND LICENSE
Torsten Schönfeld's avatar
Torsten Schönfeld committed
120
---------------------
x-rwmcfa1's avatar
x-rwmcfa1 committed
121

122
Copyright (C) 2004-2013 by the cairo perl team
x-rwmcfa1's avatar
x-rwmcfa1 committed
123
124

Ross McFarland           rwmcfa1 at neces dot com
125
Torsten Schoenfeld       kaffeetisch at gmx dot de
x-rwmcfa1's avatar
x-rwmcfa1 committed
126

127
See the LICENSE file in the top-level directory of this distribution for the
128
full license terms.