|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| lib/ | H | 06-Jun-2020 | - | 4,931 | 2,102 |
| t/ | H | 06-Jun-2020 | - | 4,528 | 3,215 |
| AUTHORS | H A D | 27-Nov-2011 | 1.5 KiB | 36 | 30 |
| ChangeLog.pre-git | H A D | 27-Sep-2018 | 143.4 KiB | 4,474 | 2,974 |
| GBookmarkFile.xs | H A D | 22-May-2018 | 19.8 KiB | 727 | 632 |
| GBoxed.xs | H A D | 19-Aug-2019 | 24.4 KiB | 954 | 687 |
| GClosure.xs | H A D | 26-Nov-2014 | 23.9 KiB | 848 | 605 |
| GError.xs | H A D | 13-Aug-2015 | 18.6 KiB | 605 | 445 |
| GIOChannel.xs | H A D | 06-Jan-2012 | 8.5 KiB | 228 | 169 |
| GKeyFile.xs | H A D | 26-Sep-2018 | 21.2 KiB | 887 | 778 |
| GLog.xs | H A D | 25-May-2020 | 13.6 KiB | 428 | 330 |
| GMainLoop.xs | H A D | 24-Jan-2015 | 19.1 KiB | 619 | 416 |
| GObject.xs | H A D | 25-May-2020 | 53 KiB | 1,816 | 1,275 |
| GOption.xs | H A D | 25-May-2020 | 21.9 KiB | 869 | 661 |
| GParamSpec.xs | H A D | 21-May-2017 | 35.5 KiB | 1,184 | 926 |
| GSignal.xs | H A D | 11-Dec-2013 | 34.8 KiB | 1,109 | 859 |
| GType.xs | H A D | 18-Feb-2020 | 81.7 KiB | 2,898 | 2,104 |
| GUtils.xs | H A D | 25-May-2020 | 14.4 KiB | 481 | 369 |
| GValue.xs | H A D | 19-Aug-2019 | 10.1 KiB | 341 | 232 |
| GVariant.xs | H A D | 19-Aug-2019 | 21.5 KiB | 738 | 509 |
| Glib.exports | H A D | 26-Sep-2018 | 3.2 KiB | 129 | 110 |
| Glib.xs | H A D | 24-Jan-2015 | 16.1 KiB | 600 | 439 |
| LICENSE | H A D | 06-Jan-2012 | 25.8 KiB | 506 | 419 |
| MANIFEST | H A D | 06-Jun-2020 | 1.1 KiB | 83 | 82 |
| MANIFEST.SKIP | H A D | 27-Nov-2011 | 135 | 17 | 16 |
| META.json | H A D | 06-Jun-2020 | 2.2 KiB | 89 | 88 |
| META.yml | H A D | 06-Jun-2020 | 1.4 KiB | 58 | 57 |
| Makefile.PL | H A D | 26-Sep-2018 | 9.5 KiB | 294 | 217 |
| NEWS | H A D | 06-Jun-2020 | 47.2 KiB | 1,276 | 989 |
| README | H A D | 27-Sep-2018 | 5.4 KiB | 158 | 116 |
| TODO | H A D | 27-Nov-2011 | 643 | 12 | 11 |
| apidoc.pl | H A D | 21-May-2017 | 1.4 KiB | 50 | 33 |
| copyright.pod | H A D | 27-Nov-2011 | 122 | 4 | 2 |
| devel.pod | H A D | 06-Jan-2012 | 14.8 KiB | 343 | 249 |
| doctypes | H A D | 27-Nov-2011 | 786 | 19 | 18 |
| gperl-gtypes.c | H A D | 25-May-2020 | 21.6 KiB | 571 | 453 |
| gperl-gtypes.h | H A D | 24-Jan-2015 | 3.1 KiB | 90 | 60 |
| gperl-private.h | H A D | 25-May-2020 | 1.6 KiB | 70 | 39 |
| gperl.h | H A D | 26-Sep-2018 | 16.5 KiB | 487 | 276 |
| gperl_marshal.h | H A D | 09-Jul-2012 | 7.2 KiB | 255 | 95 |
| perl-Glib.spec.in | H A D | 06-Jan-2012 | 2.8 KiB | 76 | 64 |
| perl-glib.doap | H A D | 26-Sep-2018 | 943 | 28 | 23 |
| typemap | H A D | 26-Sep-2018 | 6.9 KiB | 295 | 238 |
| xsapi.pod.foot | H A D | 06-Jan-2012 | 1 KiB | 31 | 20 |
| xsapi.pod.head | H A D | 27-Nov-2011 | 510 | 24 | 13 |
README
1Glib
2====
3
4This module provides perl access to Glib and GLib's GObject libraries.
5GLib is a portability and utility library; GObject provides a generic
6type system with inheritance and a powerful signal system. Together
7these libraries are used as the foundation for many of the libraries
8that make up the Gnome environment, and are used in many unrelated
9projects.
10
11This wrapper attempts to provide a perlish interface while remaining
12as true as possible to the underlying C API, so that any reference
13materials you can find on using GLib may still apply to using the
14libraries from perl. Where GLib's functionality overlaps perl's,
15perl's is favored; for example, you will find perl lists and arrays in
16place of GSList or GList objects. Some concepts have been eliminated;
17you need never worry about reference-counting on GObjects or GBoxed
18structures. Other concepts have been converted to a perlish analogy;
19the GType id will never be seen in perl, as the package name serves
20that purpose. See the main Glib manpage for more information.
21
22This module also provides facilities for creating wrappers for other
23GObject-based libraries. The documentation page of the gtk2-perl
24project's website has information about this stuff; see
25http://gtk2-perl.sourceforge.net/
26
27INSTALLATION
28------------
29
30To install this module type the following:
31
32 perl Makefile.PL
33 make
34 make test
35 make install
36
37
38To avoid installing to a system directory, since this is a beta release,
39you can change the installation prefix at Makefile.PL time with
40
41 perl Makefile.PL PREFIX=/some/other/place
42
43This will install the module to the subdirectory lib/perl5 under the given
44prefix. If this is not already in perl's include path, you'll need to tell
45perl how to get to this library directory so you can use it; there are three
46ways:
47
48 in your environment (the easiest):
49 # assuming a bourne-style shell
50 PERL5LIB=/some/other/place/lib/perl5/site_perl
51 export PERL5LIB
52
53 on the perl command line:
54 perl -I /some/other/place/lib/perl5/site_perl yourscript
55
56 in the code of your perl script:
57 use lib '/some/other/place/lib/perl5/site_perl';
58
59
60DEPENDENCIES
61------------
62
63In order to use perl bindings for glib, you must have glib 2.x and its
64prerequisites (pkg-config and a decent standard c library) installed.
65glib-2.x is available from http://www.gtk.org, http://www.gnome.org,
66etc.
67
68Glib uses unicode internally; therefore this module requires perl 5.8.0
69or newer.
70
71You'll also need the following modules in order to build the Glib module
72from source:
73
74 ExtUtils::Depends >= 0.300
75 ExtUtils::PkgConfig >= 1.00
76
77
78HOW TO CONTACT US
79-----------------
80Homepage: http://gtk2-perl.sourceforge.net/
81Mailing list: gtk-perl-list [at] gnome.org
82Mailing list archives: https://mail.gnome.org/archives/gtk-perl-list/
83IRC: irc://irc.gnome.org/#gtk-perl
84E-mail bug submission via CPAN's RT:
85 bug-Glib [at] rt.cpan.org
86Web bug submission via gnome.org's bugzilla:
87 http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl
88
89Please do not contact any of the maintainers directly unless they ask you to.
90The first point of contact for questions/problems/issues should always be the
91mailing list.
92
93
94BUG REPORTS
95-----------
96For help with problems, please contact the mailing list (above). If you
97already know you have a bug, please file it with one of the bug trackers
98below. With any problems and/or bug reports, it's always helpful for the
99developers to have the following information:
100
101- A small script that demonstrates the problem; this is not required, however,
102 it will get your issue looked at much faster than a description of the
103 problem alone.
104- Version of Perl (perl -v)
105- Versions of Gtk2-Perl modules (Glib/Gtk2/Pango/Cairo)
106- Optional, but nice to have: versions of GTK+ libraries on your system
107 (libglib, libgtk+, libpango, libcairo, etc.)
108
109There are multiple project bug trackers, please choose the one you are most
110comfortable with using and/or already have an account for.
111
112Request Tracker:
113- submitting bugs via the Web (requires a PAUSE account/Bitcard):
114 https://rt.cpan.org/Public/Bug/Report.html?Queue=Glib
115- submitting bugs via e-mail (open to anyone with e-mail):
116 bug-Glib [at] rt.cpan.org
117
118Gnome's bugtracker:
119- report bugs to the 'gnome-perl' product (requires login)
120 http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl
121
122
123PATCH SUBMISSION GUIDELINES
124---------------------------
125You can send us patches by...
126- E-mailing it to the mailing list (above); please use a pastebin service of
127 some kind for longer patchfiles (over say 20k in size).
128- Those with gnome.org Git ID's can push trivial patches to git directly; if
129 you're not sure what a trivial patch is, please ask first on the mailing
130 list prior to pushing your commit.
131
132OBTAINING SOURCE FROM THE GNOME.ORG GIT REPO
133--------------------------------------------
134Assuming you already have the 'git' command installed on your system, you can
135use the 'git://' or 'https://' protocols
136
137git clone git@gitlab.gnome.org:GNOME/perl-glib.git
138
139- or -
140
141git clone https://gitlab.gnome.org/GNOME/perl-glib.git
142
143To update an existing clone of the source:
144
145git pull
146
147Most Linux distros now package the 'git' command in the 'git' package.
148
149
150COPYRIGHT AND LICENSE
151---------------------
152
153Copyright (C) 2003-2018 by the gtk2-perl team (see the file AUTHORS for the
154full list)
155
156See the LICENSE file in the top-level directory of this distribution for the
157full license terms.
158