README
1Pango
2=====
3
4Pango is a library for laying out and rendering text, with an emphasis on
5internationalization. Pango can be used anywhere that text layout is needed,
6but using Pango in conjunction with L<Cairo> and/or L<Gtk2> provides a complete
7solution with high quality text handling and graphics rendering.
8
9
10INSTALLATION
11------------
12
13To install this module type the following:
14
15 perl Makefile.PL
16 make
17 make test
18 make install
19
20
21DEPENDENCIES
22------------
23
24This module requires these other modules and libraries:
25
26 perl >= 5.8.0
27 Glib >= 1.220 (Perl module)
28
29 pango >= 1.x (C library)
30
31If pango is as new or newer as 1.10, the Cairo module is also required:
32
33 Cairo >= 1.000 (Perl module)
34
35In order to build it from source, you'll also need
36
37 ExtUtils::Depends >= 0.300
38 ExtUtils::PkgConfig >= 1.030
39
40
41HOW TO CONTACT US
42-----------------
43
44Homepage: http://gtk2-perl.sourceforge.net/
45Mailing list: gtk-perl-list [at] gnome.org
46Mailing list archives: https://mail.gnome.org/archives/gtk-perl-list/
47IRC: irc://irc.gnome.org/#gtk-perl
48E-mail bug submission via CPAN's RT:
49 bug-Pango [at] rt.cpan.org
50Web bug submission via gnome.org's bugzilla:
51 http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl
52
53Please do not contact any of the maintainers directly unless they ask you to.
54The first point of contact for questions/problems/issues should always be the
55mailing list.
56
57
58BUG REPORTS
59-----------
60
61For help with problems, please contact the mailing list (above). If you
62already know you have a bug, please file it with one of the bug trackers
63below. With any problems and/or bug reports, it's always helpful for the
64developers to have the following information:
65
66- A small script that demonstrates the problem; this is not required, however,
67 it will get your issue looked at much faster than a description of the
68 problem alone.
69- Version of Perl (perl -v)
70- Versions of Gtk2-Perl modules (Glib/Gtk2/Pango/Cairo)
71- Optional, but nice to have: versions of GTK+ libraries on your system
72 (libglib, libgtk+, libpango, libcairo, etc.)
73
74There are multiple project bug trackers, please choose the one you are most
75comfortable with using and/or already have an account for.
76
77Request Tracker:
78- submitting bugs via the Web (requires a PAUSE account/Bitcard):
79 https://rt.cpan.org/Public/Bug/Report.html?Queue=Pango
80- submitting bugs via e-mail (open to anyone with e-mail):
81 bug-Pango [at] rt.cpan.org
82
83Gnome's bugtracker:
84- report bugs to the 'gnome-perl' product (requires login)
85 http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl
86
87PATCH SUBMISSION GUIDELINES
88---------------------------
89
90You can send us patches by...
91- E-mailing it to the mailing list (above); please use a pastebin service of
92 some kind for longer patchfiles (over say 20k in size).
93- Those with gnome.org Git ID's can push trivial patches to git directly; if
94 you're not sure what a trivial patch is, please ask first on the mailing
95 list prior to pushing your commit.
96
97
98OBTAINING SOURCE FROM THE GNOME.ORG GIT REPO
99--------------------------------------------
100
101Assuming you already have the 'git' command installed on your system, you can
102use the 'git://' protocol:
103
104 git clone git://git.gnome.org/perl-Pango
105
106Or, read-only access via HTTP:
107
108 git clone http://git.gnome.org/browse/perl-Pango
109
110To update an existing clone of the source:
111
112 git pull
113
114Most Linux distros package the 'git' command in a package called either 'git'
115or 'git-core'.
116
117
118COPYRIGHT AND LICENSE
119---------------------
120
121Copyright (C) 2003-2014, by the gtk2-perl team (see the file AUTHORS
122for the full list)
123
124This library is free software; you can redistribute it and/or modify it under
125the terms of the GNU Library General Public License as published by the Free
126Software Foundation; either version 2.1 of the License, or (at your option) any
127later version.
128
129This library is distributed in the hope that it will be useful, but WITHOUT ANY
130WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
131PARTICULAR PURPOSE.
132
133See the LICENSE file in the top-level directory of this distribution for the
134full license terms.
135