From efc3b89e6120b7c4ed6af06249c24d8576619083 Mon Sep 17 00:00:00 2001 From: Owen Taylor Date: Mon, 7 Jul 2003 22:10:16 +0000 Subject: Merge changes by Havoc Pennington that had been made in web module: Mon Jul 7 18:26:14 2003 Owen Taylor * destop-entry-spec.sgml: Merge changes by Havoc Pennington that had been made in web module: 2002/04/20: add changes posted to xdg-list a while back --- desktop-entry/ChangeLog | 7 ++ desktop-entry/desktop-entry-spec.sgml | 136 +++++++++++++++++++++++++++++++--- 2 files changed, 131 insertions(+), 12 deletions(-) (limited to 'desktop-entry') diff --git a/desktop-entry/ChangeLog b/desktop-entry/ChangeLog index cfb0ae7..ac924ba 100644 --- a/desktop-entry/ChangeLog +++ b/desktop-entry/ChangeLog @@ -1,3 +1,10 @@ +Mon Jul 7 18:26:14 2003 Owen Taylor + + * destop-entry-spec.sgml: Merge changes by Havoc + Pennington that had been made in web module: + + 2002/04/20: add changes posted to xdg-list a while back + Sat Aug 24 17:00:48 2002 Owen Taylor * desktop-entry-spec.sgml: In legacy-mixed table, fix duplicate diff --git a/desktop-entry/desktop-entry-spec.sgml b/desktop-entry/desktop-entry-spec.sgml index a7509f8..4177c52 100644 --- a/desktop-entry/desktop-entry-spec.sgml +++ b/desktop-entry/desktop-entry-spec.sgml @@ -73,6 +73,10 @@ desktop entry file but possibly one or more comments (see below). + + Group headers may not contain the characters '[' and ']' as + those delimit the header. + Lines beginning with a "#" are considered comments and will be ignored, however they should be preserved across reads / writes of the @@ -91,9 +95,14 @@ Name=Value - Space before and after the equals sign should be supported; the "=" + Space before and after the equals sign should be ignored; the "=" sign is the actual delimiter. + + The escape sequences \s, \n, \t, \r, and \\ are supported, + meaning ASCII space, newline, tab, carriage return, and + backslash, respectively. + Possible value types @@ -103,14 +112,16 @@ Name=Value The difference between string and localestring is that the value for - a string key must contain only ASCII characters and while the value + a string key must contain only UTF-8 characters and while the value of a localestring key may contain localized encodings. (See section 5.) Some keys can have multiple values; these should be separated by a semicolon. Those keys which have several values should have a - semicolon as the trailing character. + semicolon as the trailing character. For lists of strings, + semicolons are simply not allowed in the strings, there is no + escape mechanism. @@ -206,7 +217,16 @@ Name=Value Name - name of the entry, need not match binary name + specific name of the application, for example "Mozilla" + + localestring + YES + YES + + + GenericName + + generic name of the application, for example "Web Browser" localestring YES @@ -256,7 +276,9 @@ Name=Value Comment - descriptive comment + tooltip for the entry, for example "View sites on the + Internet"; should not be redundant with Name or + GenericName. localestring NO @@ -284,9 +306,13 @@ Name=Value Icon - icon to display in file manager, menus, etc. the icon - MAY specify a specific path to override common search - directories + icon to display in file manager, menus, etc. If the + name is an absolute path, the given file will be + used. If the name is not an absolute path, an + implementation-dependent search algorithm will be used + to locate the icon. Icons may be localized with the + Icon[xx]= syntax, but filenames should be in UTF-8, not + locale encoding. string NO @@ -333,7 +359,9 @@ Name=Value if the program runs in a terminal, any options that should be passed to the terminal emulator before - actually executing the program + actually executing the program. This field is + deprecated because it's dependent on which emulator + is used. string NO @@ -448,6 +476,78 @@ Name=Value NO YES + + BinaryPattern + + Deprecated. + + string + NO + NO + + + DocPath + + Deprecated. + + string + NO + NO + + + Extensions + + Deprecated. + + string + NO + NO + + + InitialPreference + + Deprecated. + + string + NO + NO + + + Keywords + + Deprecated. + + string + NO + NO + + + MapNotify + + Deprecated. + + string + NO + NO + + + Protocols + + Deprecated. + + string + NO + NO + + + ServiceTypes + + Deprecated. + + string + NO + NO + @@ -580,7 +680,18 @@ Name=Value Each "Exec" field may take a number of arguments which will be expanded by the file manager or program launcher and passed to the - program if necessary. Recognized fields are as follows: + program if necessary. + + + Literal % characters must be escaped as %%, and adding new + format characters is not allowed. It's a fatal error to have an + Exec field with a format character not given in the spec. + Again for emphasis: nonstandard extensions are + not allowed here - you must add an X-Foo-Exec field if you have + nonstandard Exec lines. + + + Recognized fields are as follows: @@ -621,13 +732,14 @@ Name=Value %d - the directory of the file to open. + directory containing the file that would be passed in a %f field %D - a list of directories + list of directories containing the files that would be + passed in to a %F field -- cgit v1.2.3-70-g09d2