Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
xfce:garcon:start [2020/08/31 00:57] – created kevinbowenxfce:garcon:start [2026/11/04 01:07] (current) – add link to releng dependency list kevinbowen
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
 +{{ :xfce:garcon.png?48nolink|}}
 ====== garcon - menu library ====== ====== garcon - menu library ======
  
-Garcon is an implementation of the freedesktop.org menu specification +**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. Garcon 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. 
-replacing the former Xfce menu library libxfce4menu. It is based on + 
-GLib/GIO only and aims at covering the entire specification except for +  * **[[#Required Packages|Required Packages]]** 
-legacy menus.+  * **[[#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]]
 +
 +For current version requirements of Xfce components, see the [[https://wiki.xfce.org/releng/4.22/roadmap#changes_in_dependencies|dependency version list]] on the developer wiki.
 +
 +----
 +
 +===== 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 ===== ===== Latest Release =====
-==== 0.7.1 (202020818)==== +{{rss>https://archive.xfce.org/feeds/project/garcon 1 date 2h}}
-[[https://archive.xfce.org/src/xfce/garcon/0.7/garcon-0.7.1.tar.bz2|garcon-0.7.1.tar.bz2]] +
-    * **[[https://archive.xfce.org/src/xfce/garcon/0.7/garcon-0.7.1.tar.bz2?sha1?sha1|SHA1 hash]]** +
-    * **[[https://archive.xfce.org/src/xfce/garcon/0.7/garcon-0.7.1.tar.bz2?sha256|SHA256 hash]]**+
  
-[[https://archive.xfce.org/src/xfce/garcon|Previous Versions]]+[[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 ===== ===== Source Code Repository =====
Line 24: Line 61:
 ---- ----
 ===== Reporting Bugs ===== ===== Reporting Bugs =====
-  * **[[:xfce:garcon:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs +  * **[[:xfce:garcon:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
  
 +[[|Back To Top]]
 ---- ----
-[[:start|Back to main Xfce documentation page]]+[[:start|Return to Xfce Main Documentation Page]]