README
1Gtk2::ImageView
2===============
3
4Perl bindings to the GtkImageView image viewer widget
5Find out more about GtkImageView at http://trac.bjourne.webfactional.com/.
6
7The Perl bindings follow the C API very closely, and the C reference
8should be considered the canonical documentation.
9
10Be sure to check out the example programs in the "examples" directory.
11
12To discuss Gtk2::ImageView or gtk2-perl, ask questions and flame/praise the
13authors, join gtk-perl-list@gnome.org at lists.gnome.org.
14
15
16INSTALLATION
17------------
18
19To install this module type the following:
20
21 perl Makefile.PL
22 make
23 make test
24 make install
25
26
27To avoid installing to a system directory, since this is a beta release,
28you can change the installation prefix at Makefile.PL time with
29
30 perl Makefile.PL PREFIX=/some/other/place
31
32This will install the module to the subdirectory lib/perl5 under the given
33prefix. If this is not already in perl's include path, you'll need to tell
34perl how to get to this library directory so you can use it; there are three
35ways:
36
37 in your environment (the easiest):
38 # assuming a bourne-style shell
39 PERL5LIB=/some/other/place/lib/perl5/site_perl
40 export PERL5LIB
41
42 on the perl command line:
43 perl -I /some/other/place/lib/perl5/site_perl yourscript
44
45 in the code of your perl script:
46 use lib '/some/other/place/lib/perl5/site_perl';
47
48To build the documentation as html, run:
49
50 make html
51
52Note that the bindings must first have been built and that the
53mpod2html script must be installed.
54
55
56DEPENDENCIES
57------------
58
59This module requires these other modules and libraries:
60
61 perl >= 5.8.0
62 Glib >= 1.163 (Perl module)
63 GTK+ > 2.x (C library)
64 GtkImageView >= 1.6.0
65
66If GTK+ is as new or newer as 2.8, the Cairo module is also required:
67
68 Cairo >= 1.00 (Perl module)
69
70In order to build it from source, you'll also need
71
72 ExtUtils::Depends >= 0.2
73 ExtUtils::PkgConfig >= 1.03
74
75
76BUG REPORTS
77-----------
78
79Please submit bug reports top
80http://trac.bjourne.webfactional.com/newticket/.
81
82
83COPYRIGHT AND LICENSE
84---------------------
85
86Copyright (c) 2007 -- 2008 by Jeffrey Ratcliffe <Jeffrey.Ratcliffe@gmail.com>
87see AUTHORS for complete list of contributors
88
89This library is free software; you can redistribute it and/or
90modify it under the terms of the GNU Lesser General Public
91License as published by the Free Software Foundation; either
92version 3 of the License, or (at your option) any later version.
93
94This library is distributed in the hope that it will be useful,
95but WITHOUT ANY WARRANTY; without even the implied warranty of
96MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
97Library General Public License for more details.
98
99You should have received a copy of the GNU Lesser General Public License
100along with this program. If not, see <http://www.gnu.org/licenses/>.
101
102