The following document details how to install libdesktop-agnostic.
For Ubuntu users, there is a PPA with semi-regular releases:
If you wish to build from source, the preferred method is to use the Debian packaging method:
For Gentoo users, an SCM version is available at the desktop-effects overlay. You can add it by installing layman and running the following commands (with administrative privileges):
layman -a desktop-effects
echo ** x11-libs/libdesktop-agnostic >> /etc/portage/package.keywords
emerge libdesktop-agnostic
There are several USE flags for libdesktop-agnostic. Please consult the metadata.xml file in the directly where the libdesktop-agnostic-9999.ebuild is located for flag descriptions.
For the Python bindings:
One of the following VFS libraries:
libdesktop-agnostic uses Waf as its build system. It is bundled with the package. From the toplevel directory, run ./waf --help to see all of the options available for the various commands. A regular user will just need to run the following:
./waf configure --config-backends=[cfg] --vfs-backends=[vfs] --desktop-entry-backends=[de]
./waf
./waf install
The preceding commands check the system for dependencies, build the library and test programs, and install the library to the default location (/usr/local).
The placeholders (specified by the [bracketed] identifiers) should be replaced by a comma-separated list of backends. A list of valid backends follows:
Packagers should package binary modules separately.
A configuration file (desktop-agnostic.ini) is installed in $SYSCONFDIR/xdg/libdesktop-agnostic. $SYSCONFDIR is usually /etc. The default modules are the first modules listed in the respective backend flags passed to ./waf configure.