[perl-Pango] README: group project contact addresses/links together



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]