From fa7aa7695c8c898af2a92e24eb0b865e18ee512b Mon Sep 17 00:00:00 2001 From: Brent Smith Date: Sun, 12 Mar 2006 18:05:06 +0000 Subject: Some cleanup and consistency changes. 2006-03-12 Brent Smith * menustructure.xml: Some cleanup and consistency changes. --- gnome2-system-admin-guide/C/ChangeLog | 5 + gnome2-system-admin-guide/C/menustructure.xml | 138 ++++++++++++++------------ 2 files changed, 81 insertions(+), 62 deletions(-) diff --git a/gnome2-system-admin-guide/C/ChangeLog b/gnome2-system-admin-guide/C/ChangeLog index d6be137..4258a30 100644 --- a/gnome2-system-admin-guide/C/ChangeLog +++ b/gnome2-system-admin-guide/C/ChangeLog @@ -1,3 +1,8 @@ +2006-03-12 Brent Smith + + * menustructure.xml: + Some cleanup and consistency changes. + 2006-03-11 Brent Smith * gconf.xml: diff --git a/gnome2-system-admin-guide/C/menustructure.xml b/gnome2-system-admin-guide/C/menustructure.xml index f361191..0309d70 100644 --- a/gnome2-system-admin-guide/C/menustructure.xml +++ b/gnome2-system-admin-guide/C/menustructure.xml @@ -87,11 +87,11 @@ XDG base directory specification. is not set, then the default path - /etc/xdg/ is used. This also implies that a user + /etc/xdg is used. This also implies that a user specific version may be located at $XDG_CONFIG_HOME/menus/applications.menu which is searched first. If $XDG_CONFIG_HOME is not set, - then the default path ~/.config/ is used. Directories + then the default path ~/.config is used. Directories which appear first in $XDG_CONFIG_DIRS are given precedence when there are several applications.menu files. The first file found is used and subsequent files are ignored. @@ -103,16 +103,16 @@ Search each directory in $XDG_CONFIG_HOME in - order to find /menus/applications.menu. If - $XDG_CONFIG_HOME is not set, default to - ~/.config/ + order to find menus/applications.menu. If + $XDG_CONFIG_HOME is not set, it defaults to the + ~/.config/ directory. Search each directory in $XDG_CONFIG_DIRS in - order to find /menus/applications.menu. If - $XDG_CONFIG_DIRS is not set, default to - /etc/xdg/ + order to find menus/applications.menu. If + $XDG_CONFIG_DIRS is not set, it defaults to the + /etc/xdg/ directory. @@ -295,7 +295,7 @@ - <Category> + <Category> A matching rule that selects a desktop entry when the Categories key matches @@ -370,9 +370,9 @@ url="http://www.freedesktop.org/Standards/basedir-spec">XDG base directory specification. is not set, then the default path is - /usr/share/ is used. This also implies that user + /usr/share is used. This also implies that user specific desktop entries may be located at - $XDG_DATA_HOME/applications/ which is + $XDG_DATA_HOME/applications which is searched first. If $XDG_DATA_HOME is not set, then the default path ~/.local/share is used. Desktop entries are collected from all directories in the $XDG_DATA_DIRS @@ -421,18 +421,18 @@ Categories=GTK;GNOME;Application;Utility; - Encoding - - - Specifies the encoding of the desktop - entry file. - - - - Name + + Categories - Specifies the name of the item. This - name is displayed on the item in the menu. + Specifies the + keywords that describe the item. The keywords are separated with + semicolons (;). To see a list of the standard category keywords, + see the desktop menu specification at + + http://www.freedesktop.org/Standards/menu-spec + Menu + Definition Files map desktop entries to menus by using + matching rules against the Categories key. @@ -444,6 +444,14 @@ Categories=GTK;GNOME;Application;Utility; item in the menu. + + Encoding + + + Specifies the encoding of the desktop + entry file. + + Exec @@ -460,6 +468,26 @@ Categories=GTK;GNOME;Application;Utility; path to the filename, or the file extension. + + MimeType + + Specifies the MIME types that the application can handle. + + + + Name + + Specifies the name of the item. This + name is displayed on the item in the menu. + + + + NoDisplay + + This options means This application + exists, but don't display it in the menus. + + Terminal @@ -501,26 +529,6 @@ Categories=GTK;GNOME;Application;Utility; - - - Categories - - Specifies the - keywords that describe the item. The keywords are separated with - semicolons (;). To see a list of the standard category keywords, - see the desktop menu specification at the following URL: - - http://www.freedesktop.org/Standards/menu-spec - Menu - Definition Files map desktop entries to menus by using - matching rules against the Categories key. - - - - MimeType - - Specifies the MIME types - @@ -559,14 +567,14 @@ Categories=GTK;GNOME;Application;Utility; details for the menu such as a name, a tooltip, and an icon. Directory entry files have a .directory file extension. - Directory entry files must reside at - $XDG_DATA_DIRS/desktop-directories/. If + Directory entry files must reside in the + $XDG_DATA_DIRS/desktop-directories directory. If $XDG_DATA_DIRS is not set, then the default path is - /usr/share/ is used. This also implies that user + /usr/share is used. This also implies that user specific directory entries may be located at - $XDG_DATA_HOME/desktop-directories/ + $XDG_DATA_HOME/desktop-directories which is searched first. If $XDG_DATA_HOME is not set, then - the default path ~/.local/share/ is used. Directory + the default path ~/.local/share is used. Directory entries are collected from all directories in the $XDG_DATA_DIRS environment variable. Directories which appear first in $XDG_DATA_DIRS are given precedence when @@ -576,10 +584,16 @@ Categories=GTK;GNOME;Application;Utility; The following is a sample directory entry file: [Desktop Entry] -Name=Accessories -Comment=Accessories menu -Icon=gnome-util.png -Type=Directory +[Desktop Entry] +Name=Graphics +Name[fr]=Graphisme +... +Comment=Graphics applications +Comment[fr]=Applications graphiques +... +Icon=gnome-graphics +Type=Directory +Encoding=UTF-8 describes the most important keys in directory entry files. @@ -671,7 +685,7 @@ Type=Directory Create a directory entry file for the item that you want to add. Place the directory entry file in the - $XDG_DATA_DIRS/desktop-directories/ + $XDG_DATA_DIRS/desktop-directories directory. For more information on directory entry files, see . @@ -740,8 +754,8 @@ Type=Directory - Place the desktop entry file in the folder - $XDG_DATA_DIRS/applications/ + Place the desktop entry file in the + $XDG_DATA_DIRS/applications folder. @@ -809,9 +823,9 @@ Type=Directory - Locate the desktop entry in - $XDG_DATA_DIRS/applications/ - corresponding to the menu item. + Locate the desktop entry in the + $XDG_DATA_DIRS/applications + directory that corresponds to the menu item. @@ -917,7 +931,7 @@ Type=Directory To manually create a custom menu for a user, the $XDG_CONFIG_HOME/menus/applications.menu must exist. In the case that $XDG_CONFIG_HOME is not set, - the default ~/.config/ is used. Since this is the + the default ~/.config directory is used. Since this is the first location that is searched for the applications.menu file, it takes precedence over all other menu files. @@ -952,8 +966,8 @@ Type=Directory be merged with the contents of the user's menu file. When you specify the attribute type="parent", then the contents of the <MergeFile> element are ignored and the next - applications.menu file in - $XDG_CONFIG_DIRS/menus/ is used for + applications.menu file in the + $XDG_CONFIG_DIRS/menus directory is used for merging. @@ -974,8 +988,8 @@ Type=Directory The children of the root <Menu> element in the merged menu file Merged menu file refers to the next - applications.menu in - $XDG_CONFIG_DIRS/menus/ + applications.menu in the + $XDG_CONFIG_DIRS/menus directory. are substituted for the <MergeFile> element in the base menu file. -- cgit