[perl-Pango] README: group project contact addresses/links together
- From: Brian Manning <bmanning src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [perl-Pango] README: group project contact addresses/links together
- Date: Sat, 25 Jan 2014 19:52:08 +0000 (UTC)
commit 16820f3331c053c04a57db0261bb7ad4ab8b14eb
Author: Brian Manning <bmanning src gnome org>
Date: Sat Jan 25 11:38:54 2014 -0800
README: group project contact addresses/links together
- Remove outdated install instructions
- Added more info on how to report bugs, submit patches
- Added instructions on how to clone via Git
README | 105 +++++++++++++++++++++++++++++++++++++++++++++-------------------
1 files changed, 74 insertions(+), 31 deletions(-)
---
diff --git a/README b/README
index 09b1b33..3c650bd 100644
--- a/README
+++ b/README
@@ -6,12 +6,6 @@ internationalization. Pango can be used anywhere that text layout is needed,
but using Pango in conjunction with L<Cairo> and/or L<Gtk2> provides a complete
solution with high quality text handling and graphics rendering.
-To discuss gtk2-perl, ask questions and flame/praise the authors,
-join gtk-perl-list gnome org at lists.gnome.org.
-
-Also have a look at the gtk2-perl website and sourceforge project page,
-http://gtk2-perl.sourceforge.net
-
INSTALLATION
------------
@@ -23,27 +17,6 @@ To install this module type the following:
make test
make install
-To avoid installing to a system directory, since this is a beta release,
-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
------------
@@ -65,18 +38,88 @@ In order to build it from source, you'll also need
ExtUtils::PkgConfig >= 1.030
+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-Pango [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.
+
+
BUG REPORTS
-----------
-Please report bugs to the gnome-perl product in GNOME's Bugzilla:
-<http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl>
+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=Pango
+- submitting bugs via e-mail (open to anyone with e-mail):
+ bug-Pango [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
+
+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.
+
+
+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
+
+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 either 'git'
+or 'git-core'.
COPYRIGHT AND LICENSE
---------------------
-Copyright (C) 2003-2008 by the gtk2-perl team (see the file AUTHORS for the
-full list)
+Copyright (C) 2003-2014, by the gtk2-perl team (see the file AUTHORS
+for the full list)
This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Library General Public License as published by the Free
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]