source: gnome/core/gnome-menus.xml@ 9fd3676e

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY gnome-menus-download-http "&gnome-download-http;/gnome-menus/&gnome-version;/gnome-menus-&gnome-menus-version;.tar.bz2">
  <!ENTITY gnome-menus-download-ftp  "&gnome-download-ftp;/gnome-menus/&gnome-version;/gnome-menus-&gnome-menus-version;.tar.bz2">
  <!ENTITY gnome-menus-md5sum        "279316228fd84917acb9405476f74b53">
  <!ENTITY gnome-menus-size          "451 KB">
  <!ENTITY gnome-menus-buildsize     "9 MB">
  <!ENTITY gnome-menus-time          "0.1 SBU">
]>

<sect1 id="gnome-menus" xreflabel="gnome-menus-&gnome-menus-version;">
  <?dbhtml filename="gnome-menus.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>gnome-menus-&gnome-menus-version;</title>

  <indexterm zone="gnome-menus">
    <primary sortas="a-Gnome-menus">Gnome-menus</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to gnome-menus</title>

    <para>The <application>gnome-menus</application> package contains an
    implementation of the draft <quote>Desktop Menu Specification</quote>
    from freedesktop.org (<ulink
    url="http://www.freedesktop.org/Standards/menu-spec"/>). Also contained
    are the <application>GNOME</application> menu layout configuration files,
    <filename>.directory</filename> files and a menu related utility
    program.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&gnome-menus-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&gnome-menus-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &gnome-menus-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &gnome-menus-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &gnome-menus-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &gnome-menus-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">gnome-menus Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="glib2"/> and
    <xref linkend="perl-xml-parser"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="python"/>,
    <xref linkend="gamin"/>, and
    <xref linkend="intltool"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/gnome-menus"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of gnome-menus</title>

     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     href="../../xincludes/without-gnome.xml"/>

    <para>Install <application>gnome-menus</application> by running the
    following commands:</para>

<screen><userinput>./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
            --sysconfdir=&gnome-etc-dir; \
            --enable-inotify &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/gnome-prefix.xml"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/gnome-sysconfdir.xml"/>

    <para><parameter>--enable-inotify</parameter>: 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 <application>Gamin</application> as the file polling method.</para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring gnome-menus</title>

    <sect3>
      <title>Configuration Information</title>

      <sect4>
        <title>XDG_CONFIG_DIRS Variable</title>

        <para>So that <application>GNOME</application> can find the desktop
        configuration files, ensure you set the <envar>XDG_CONFIG_DIRS</envar>
        environment variable in the individual user's profiles, or in the system
        profile (use this option if you will be running
        <application>GDM</application>) as shown below (you may add additional
        directories, separated with colons, if desired):</para>

<screen role='root'><userinput>echo "export XDG_CONFIG_DIRS=&gnome-etc-dir;/xdg" \
&gt; /etc/profile.d/gnome.sh</userinput></screen>

      </sect4>

      <sect4>
        <title>XDG_DATA_DIRS Variable</title>

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

<screen role='root'><userinput>echo "export XDG_DATA_DIRS=$GNOME_PREFIX/share:\
/usr/share:/usr/local/share" &gt;&gt; /etc/profile.d/gnome.sh</userinput></screen>

      </sect4>

      <sect4>
        <title>PYTHONPATH Variable</title>

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

<screen role='root'><userinput>echo "export PYTHONPATH=\$PYTHONPATH:$(pkg-config \
--variable=prefix ORBit-2.0)/lib/python2.6/site-packages:$(pkg-config \
--variable=prefix ORBit-2.0)/lib/python2.6/site-packages/GMenuSimpleEditor" \
&gt;&gt; /etc/profile.d/gnome.sh</userinput></screen>

      </sect4>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>gmenu-simple-editor</seg>
        <seg>libgnome-menu.{so,a} and gmenu.{so,a}</seg>
        <seg>&gnome-etc-dir;/xdg/menus,
        <envar>$GNOME_PREFIX</envar>/{include/gnome-menus,
        share/{desktop-directories,gnome-menus/{examples,glade}},
        lib/python&python-majorver;/site-packages/GMenuSimpleEditor}</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="gmenu-simple-editor">
        <term><command>gmenu-simple-editor</command></term>
        <listitem>
          <para>is a simple front-end script to the
          <application>Python</application> Gmenu Simple Editor module</para>
          <indexterm zone="gnome-menus gmenu-simple-editor">
            <primary sortas="b-gmenu-simple-editor">gmenu-simple-editor</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libgnome-menu">
        <term><filename class='libraryfile'>libgnome-menu.{so,a}</filename></term>
        <listitem>
          <para>contains functions required to support GNOME's implementation
          of the Desktop Menu Specification.</para>
          <indexterm zone="gnome-menus libgnome-menu">
            <primary sortas="c-libgnome-menu">libgnome-menu.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gmenu">
        <term><filename class='libraryfile'>gmenu.{so,a}</filename></term>
        <listitem>
          <para>is a <application>Python</application> library.</para>
          <indexterm zone="gnome-menus gmenu">
            <primary sortas="c-gmenu">gmenu.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>