xfce4 perl bindings

About

xfce4-perl is a set of perl bindings for the Xfce 4 core libraries: libxfce4util and libxfcegui4. There are no plans to bind libxfce4mcs: MCS should not be used for "normal" applications, and is expected to be replaced in Xfce 4.6 anyway.

Requrements

You'll need a very recent version of libxfce4util and libxfcegui4 from Xfce SVN. Particularly, you need at least version 4.3.4 of libxfcegui4, which can only be obtained via the 'trunk' branch.

A recent version of gtk2-perl is also required. Currently, the makefile has 1.082 as a requirement, which is currently the latest released version. Earlier versions may work, but I haven't tested them, so I don't know. Feel free to try to relax the version requirement by editing xfce4-perl's toplevel Makefile.PL. If everything works with an earlier version of gtk2-perl, please let me know. gtk2-perl is available from their website, or through CPAN.

Downloads

The current release version of xfce4-perl is 0.001. It can be obtained in source form here (SHA1 sum | GPG signature). It is also available from CPAN, which should be a much easier install. The development version can be retrieved from SVN by issuing the following command:

svn co http://svn.xfce.org/svn/xfce/xfce4-perl/trunk xfce4-perl

You can view the sources via the WebSVN interface as well.

Installation

The following should get you running:

perl Makefile.PL
make
make install

Since xfce4-perl installs to a system location, make install must be run as root. If the first command fails, it is most likely due to an incomplete perl module enviroment. Please install the needed prerequisites before continuing.

Documentation

Documentation is provided in standard POD format. Documentation is available for each package provided, though in many cases, only the function call signatures are present. This should slowly improve over time (documentation patches are welcome!). Try man Xfce4 for the toplevel module documentation, or man Xfce4::index to get a list of all modules that have documentation.

Getting Help

Please use the Xfce Development List for all discussion. If you think you've found a bona-fide bug, please file it on Xfce Bugzilla under the xfce4-perl product. You can usually find me as kelnos on irc.freenode.net in #xfce as well, though I'm usually only actually there in the evenings (US Pacific time).

last modified 7 nov 2005 at 03:33.