README 3.79 KB
Newer Older
Torsten Schönfeld's avatar
Torsten Schönfeld committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
Gtk3
====

Perl bindings to the 3.x series of the gtk+ toolkit.  This module allows you to
write graphical user interfaces in a Perlish and object-oriented way, freeing
you from the casting and memory management in C, yet remaining very close in
spirit to original API.


INSTALLATION
------------

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install


DEPENDENCIES
------------

Gtk3 needs this C library:

  gtk+-3.0 >= 3.0.0

and these Perl modules:

  Glib::Object::Introspection >= 0.002

32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
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-Gtk3 [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.

Torsten Schönfeld's avatar
Torsten Schönfeld committed
48 49 50 51

BUG REPORTS
-----------

52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
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=Gtk3
- submitting bugs via e-mail (open to anyone with e-mail):
  bug-Gtk3 [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-Gtk3

Or, read-only access via HTTP:

 git clone http://git.gnome.org/browse/perl-Gtk3

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'.
Torsten Schönfeld's avatar
Torsten Schönfeld committed
106 107


108 109 110 111
COPYRIGHT AND LICENSE
---------------------

Copyright (C) 2005-2012 Torsten Schoenfeld <kaffeetisch@gmx.de>
Torsten Schönfeld's avatar
Torsten Schönfeld committed
112 113 114 115 116

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
Software Foundation; either version 2.1 of the License, or (at your option) any
later version.
117 118 119 120 121 122 123

This library is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.

See the LICENSE file in the top-level directory of this distribution for the
full license terms.