home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 2006 November (DVD) / PCWELT_11_2006.ISO / casper / filesystem.squashfs / usr / share / doc / libglib-perl / README < prev    next >
Encoding:
Text File  |  2006-03-12  |  3.5 KB  |  95 lines
  1. # $Header: /cvsroot/gtk2-perl/gtk2-perl-xs/Glib/README,v 1.65 2006/03/12 21:22:00 kaffeetisch Exp $
  2.  
  3. Glib version 1.120
  4. ==================
  5.  
  6. This module provides perl access to Glib and GLib's GObject libraries.
  7. GLib is a portability and utility library; GObject provides a generic
  8. type system with inheritance and a powerful signal system.  Together
  9. these libraries are used as the foundation for many of the libraries
  10. that make up the Gnome environment, and are used in many unrelated
  11. projects.
  12.  
  13. This wrapper attempts to provide a perlish interface while remaining
  14. as true as possible to the underlying C API, so that any reference
  15. materials you can find on using GLib may still apply to using the
  16. libraries from perl.  Where GLib's functionality overlaps perl's,
  17. perl's is favored; for example, you will find perl lists and arrays in
  18. place of GSList or GList objects.  Some concepts have been eliminated;
  19. you need never worry about reference-counting on GObjects or GBoxed
  20. structures.  Other concepts have been converted to a perlish analogy;
  21. the GType id will never be seen in perl, as the package name serves
  22. that purpose.  See the main Glib manpage for more information.
  23.  
  24. This module also provides facilities for creating wrappers for other
  25. GObject-based libraries.  The documentation page of the gtk2-perl
  26. project's website has information about this stuff; see
  27. http://gtk2-perl.sourceforge.net/
  28.  
  29. INSTALLATION
  30.  
  31. To install this module type the following:
  32.  
  33.    perl Makefile.PL
  34.    make
  35.    make test
  36.    make install
  37.  
  38.  
  39. To avoid installing to a system directory, since this is a beta release,
  40. you can change the installation prefix at Makefile.PL time with
  41.  
  42.    perl Makefile.PL PREFIX=/some/other/place
  43.  
  44. This will install the module to the subdirectory lib/perl5 under the given
  45. prefix.  If this is not already in perl's include path, you'll need to tell
  46. perl how to get to this library directory so you can use it; there are three
  47. ways:
  48.  
  49.   in your environment (the easiest):
  50.     # assuming a bourne-style shell
  51.     PERL5LIB=/some/other/place/lib/perl5/site_perl
  52.     export PERL5LIB
  53.  
  54.   on the perl command line:
  55.     perl -I /some/other/place/lib/perl5/site_perl yourscript
  56.  
  57.   in the code of your perl script:
  58.     use lib '/some/other/place/lib/perl5/site_perl';
  59.  
  60.  
  61. DEPENDENCIES
  62.  
  63. In order to use perl bindings for glib, you must have glib 2.x and its
  64. prerequisites (pkg-config and a decent standard c library) installed.
  65. glib-2.x is available from http://www.gtk.org, http://www.gnome.org,
  66. etc.
  67.  
  68. Glib uses unicode internally; therefore this module requires perl 5.8.0
  69. or newer.
  70.  
  71. You'll also need the following modules in order to build the Glib module
  72. from source:
  73.  
  74.   ExtUtils::Depends >= 0.200
  75.   ExtUtils::PkgConfig >= 1.00
  76.  
  77. COPYRIGHT AND LICENSE
  78.  
  79. Copyright (C) 2003-2006 by the gtk2-perl team (see the file AUTHORS for the
  80. full list)
  81.  
  82. This library is free software; you can redistribute it and/or modify it under
  83. the terms of the GNU Library General Public License as published by the Free
  84. Software Foundation; either version 2.1 of the License, or (at your option) any
  85. later version.
  86.  
  87. This library is distributed in the hope that it will be useful, but WITHOUT ANY
  88. WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
  89. PARTICULAR PURPOSE.  See the GNU Library General Public License for more
  90. details.
  91.  
  92. You should have received a copy of the GNU Library General Public License along
  93. with this library; if not, write to the Free Software Foundation, Inc., 59
  94. Temple Place - Suite 330, Boston, MA  02111-1307  USA.
  95.