enlightenment/enlightenment
enlightenment
/
enlightenment
10
9
Fork 12
Code Issues 24 Pull Requests 2 Projects Releases Wiki Activity

Made a start on documenting the internals of how E treats FDO specs a 

little differently.  I'll finish this after I sleep.


SVN revision: 25535
This commit is contained in:
David Walter Seikel 2006-09-06 15:10:34 +00:00
parent f5de58485b
commit 0fca2a48ac
2 changed files with 45 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
doc/FDO.txt Normal file
View File

@ -0,0 +1,44 @@
Enlightenment DR17 use freedesktop.org .desktop files according to the
XDG Desktop Entry Specification version 0.9.4, icon themes according to
the XDG Icon Theme Specification version 0.11, and menus according to
the Desktop Menu Specification version 0.92. There are some extensions
though.
.desktop extensions.
Two extension fields are defined as allowed by the specification.
X-Enlightenment-IconPath is used to specify an absolute or relative path to
an icon file. If it exists it overrides any other icon specifications.
X-Enlightenment-IconClass is used to specify a list of icon classes.
This is the same information that was in .eaps as app/icon/class, and is
used the same way if it exists. Obviously any .desktop file that comes
with packages outside of E is unlikely to have that field. One further
twist is that if the icon classes are not found in edje, then icon class
becomes a list of icons to search in the standard FDO way.
The standard Icon field is also treated differently. If it contains a /
it is considered to be an absolute path, or a path relative to the
location of the .desktop file. Otherwise, if no icon class was
specified in the .desktop file, then the Icon, Exec, and Categories
fields are used in that order to build an icon class. Everything but
the Icon field is lower cased.
This means that for standard .desktop files, with out the extension
fields, icons in the E theme are searched for first, then icons are
searched for in the usual FDO way, unless the Icon field specifies a
path, then it is simply used with no searching. Converted .eaps should
just copy the app/icon/class data to the X-Enlightenment-IconClass
field.
Icon theme extensions.
.edj files are searched for before the other types of icon file. The
"icon" group is used to specify the graphics for the icon. It is up to
the code using the result to allow full edje interactions and
animations, and people that write that code are encouraged to support it
all.

1
doc/Makefile.am
View File

@ -2,6 +2,7 @@ MAINTAINERCLEANFILES = Makefile.in
filesdir = $(datadir)/enlightenment/doc
files_DATA = \
documentation.html \
FDO.txt \
enlightenment.png
EXTRA_DIST = $(files_DATA)