Beyond Linux® From Scratch - Version 6.3

Chapter 29. GNOME Core Packages

gnome-menus-2.18.3

Introduction to gnome-menus

The gnome-menus package contains an implementation of the draft “Desktop Menu Specification” from freedesktop.org (http://www.freedesktop.org/Standards/menu-spec). Also contained are the GNOME menu layout configuration files, .directory files and a menu related utility program.

Package Information

gnome-menus Dependencies

Required

GLib-2.12.12 and XML::Parser-2.34

Optional

Python-2.5.2, Gamin-0.1.9, and intltool-0.35.5

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gnome-menus

Installation of gnome-menus

[Note]

Note

The instructions below are based on installing the package into a GNOME-2 environment. If, for whatever reason, you're installing this package without having ORBit2 and the core GNOME-2 libraries installed, you'll need to modify the --prefix= parameter on the configure script to point to your desired installation path (e.g., --prefix=/usr).

Install gnome-menus by running the following commands: 

./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
            --sysconfdir=/etc/gnome/2.18.3 \
            --enable-inotify &&
make

This package does not come with a test suite.

Now, as the root user: 

make install

Command Explanations

--prefix=$(pkg-config --variable=prefix ORBit-2.0): Setting the prefix using this parameter instead of with $GNOME_PREFIX will ensure that the prefix is consistent with the installation environment and the package will be installed in the correct location.

--sysconfdir=/etc/gnome/2.18.3: This parameter causes the configuration files to be installed in /etc/gnome/2.18.3 instead of $GNOME_PREFIX/etc. Additionally (if applicable), the parameter ensures that the GConf-2 database is correctly updated.

--enable-inotify: This parameter is used so that file polling is accomplished using the kernel inotify calls, instead of using other polling methods. Remove this parameter if you wish to fall back to Gamin as the file polling method.

Configuring gnome-menus

Configuration Information

XDG_CONFIG_DIRS Variable

So that GNOME can find the desktop configuration files, ensure you set the XDG_CONFIG_DIRS environment variable in the system profile, or in individual user's profiles as shown below (you may add additional directories, separated with colons, if desired): 

export XDG_CONFIG_DIRS=/etc/gnome/2.18.3/xdg:/etc/xdg
XDG_DATA_DIRS Variable

So that GNOME can find the data to populate the menus, ensure you set the XDG_DATA_DIRS environment variable in the system profile, or in individual user's profiles as shown below (you may add additional directories, separated with colons, if desired): 

export XDG_DATA_DIRS=$GNOME_PREFIX/share:/usr/share
PYTHONPATH Variable

If your GNOME-2 installation prefix is anything other than /usr and you have Python installed, you need to update the PYTHONPATH environment variable so that the gmenu module can be located by Python. Set the variable in the system profile, or in individual user's profiles as shown below: 

export PYTHONPATH=$PYTHONPATH:$(pkg-config --variable=prefix \
       ORBit-2.0)/lib/python2.5/site-packages:$(pkg-config \
       --variable=prefix \
       ORBit-2.0)/lib/python2.5/site-packages/GMenuSimpleEditor

Contents

Installed Programs: gmenu-simple-editor and gnome-menu-spec-test
Installed Library: libgnome-menu.{so,a}
Installed Directories: /etc/gnome/2.18.3/xdg and the following subdirectories of $GNOME_PREFIX/: include/gnome-menus, lib/python2.5/site-packages/GMenuSimpleEditor, share/{desktop-directories, gnome-menus}

Short Descriptions

gmenu-simple-editor

is a simple front-end script to the Python Gmenu Simple Editor module

gnome-menu-spec-test

is used to test GNOME's implementation of the Desktop Menu Specification.

libgnome-menu.{so,a}

contains functions required to support GNOME's implementation of the Desktop Menu Specification.

Last updated on 2008-03-17 13:11:35 -0500