Xfce Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~NOTOC~~
{{ :xfce:garcon.png?48nolink|}}
====== garcon - menu library ======

**Garcon** is an implementation of the [[https://specifications.freedesktop.org/menu-spec/latest/|freedesktop.org compliant menu]] specification. It is based on GLib/GIO and aims at covering the entire specification except for legacy menus. It was started as a complete rewrite of the former Xfce menu library called libxfce4menu, which, in contrast to garcon,
was lacking menu merging features essential for loading menus modified with menu editors.

  * **[[#Required Packages|Required Packages]]**
  * **[[#Debugging Support|Debugging Support]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[https://developer.xfce.org/garcon/index.html|garcon API documentation (for developers)]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====

Garcon covers almost every part of the menu specification except for
legacy menus and a few XML attributes. In contrast to
libxfce4menu, it can also load menus modified with menu editors such
as Alacarte as menu merging is now supported.

----
===== Required Packages =====

  * [[https://gitlab.gnome.org/GNOME/glib|GLib]]
  * [[https://gitlab.gnome.org/GNOME/gtk|GTK]]
  * [[https://gitlab.xfce.org/xfce/libxfce4ui|libxfce4ui]]
  * [[https://gitlab.xfce.org/xfce/libxfce4util|libxfce4util]]

----

===== Debugging Support =====

garcon currently supports three different levels of debugging support,
which can be setup using the configure flag `--enable-debug` (check the output
of `configure --help`):

| Argument  | Description |
| -------   | ----------- |
|  `yes`    | This is the default for Git snapshot builds. It adds all kinds of checks to the code, and is therefore likely to run slower. Use this for development of garcon and locating bugs in garcon. |
| `minimum` | This is the default for release builds. **This is the recommended behaviour.** |
| `no`      | Disables all sanity checks. Don't use this unless you know exactly what you do. |

[[|Back To Top]]
----

===== Latest Release =====
{{rss>https://archive.xfce.org/feeds/project/garcon 1 date 2h}}

[[https://gitlab.xfce.org/xfce/garcon/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/xfce/garcon/|Download current release]]** Download current release (older versions of this component are also available here)


[[|Back to Top]]
----
===== Source Code Repository =====
[[https://gitlab.xfce.org/xfce/garcon|]]

----
===== Reporting Bugs =====
  * **[[:xfce:garcon:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports

[[|Back To Top]]
----
[[:start|Return to Xfce Main Documentation Page]]
Xfce Wiki

Sub domains

Tools
