Debian Codegraph @

README

raw
1 Pango
2 =====
3
4 Pango is a library for laying out and rendering text, with an emphasis on
5 internationalization. Pango can be used anywhere that text layout is needed,
6 but using Pango in conjunction with L<Cairo> and/or L<Gtk2> provides a complete
7 solution with high quality text handling and graphics rendering.
8
9
10 INSTALLATION
11 ------------
12
13 To install this module type the following:
14
15 perl Makefile.PL
16 make
17 make test
18 make install
19
20
21 DEPENDENCIES
22 ------------
23
24 This 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
31 If pango is as new or newer as 1.10, the Cairo module is also required:
32
33 Cairo >= 1.000 (Perl module)
34
35 In order to build it from source, you'll also need
36
37 ExtUtils::Depends >= 0.300
38 ExtUtils::PkgConfig >= 1.030
39
40
41 HOW TO CONTACT US
42 -----------------
43
44 Homepage: http://gtk2-perl.sourceforge.net/
45 Mailing list: gtk-perl-list [at] gnome.org
46 Mailing list archives: https://mail.gnome.org/archives/gtk-perl-list/
47 IRC: irc://irc.gnome.org/#gtk-perl
48 E-mail bug submission via CPAN's RT:
49 bug-Pango [at] rt.cpan.org
50 Web bug submission via gnome.org's bugzilla:
51 http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl
52
53 Please do not contact any of the maintainers directly unless they ask you to.
54 The first point of contact for questions/problems/issues should always be the
55 mailing list.
56
57
58 BUG REPORTS
59 -----------
60
61 For help with problems, please contact the mailing list (above). If you
62 already know you have a bug, please file it with one of the bug trackers
63 below. With any problems and/or bug reports, it's always helpful for the
64 developers 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
74 There are multiple project bug trackers, please choose the one you are most
75 comfortable with using and/or already have an account for.
76
77 Request 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
83 Gnome's bugtracker:
84 - report bugs to the 'gnome-perl' product (requires login)
85 http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl
86
87 PATCH SUBMISSION GUIDELINES
88 ---------------------------
89
90 You 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
98 OBTAINING SOURCE FROM THE GNOME.ORG GIT REPO
99 --------------------------------------------
100
101 Assuming you already have the 'git' command installed on your system, you can
102 use the 'git://' protocol:
103
104 git clone git://git.gnome.org/perl-Pango
105
106 Or, read-only access via HTTP:
107
108 git clone http://git.gnome.org/browse/perl-Pango
109
110 To update an existing clone of the source:
111
112 git pull
113
114 Most Linux distros package the 'git' command in a package called either 'git'
115 or 'git-core'.
116
117
118 COPYRIGHT AND LICENSE
119 ---------------------
120
121 Copyright (C) 2003-2014, by the gtk2-perl team (see the file AUTHORS
122 for the full list)
123
124 This library is free software; you can redistribute it and/or modify it under
125 the terms of the GNU Library General Public License as published by the Free
126 Software Foundation; either version 2.1 of the License, or (at your option) any
127 later version.
128
129 This library is distributed in the hope that it will be useful, but WITHOUT ANY
130 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
131 PARTICULAR PURPOSE.
132
133 See the LICENSE file in the top-level directory of this distribution for the
134 full license terms.