xfce4 perl bindings
About | Requirements | Downloads | Installation | Documentation | Getting Help |
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.
Requirements
You’ll need libxfce4util and libxfcegui4 4.4 or newer.
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:
1git clone git://git.xfce.org/bindings/xfce4-perl
You can view the sources here as well.
Installation
The following should get you running:
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).