| 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. |