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