summaryrefslogtreecommitdiff
path: root/desktop-entry
AgeCommit message (Collapse)AuthorFilesLines
2023-02-05desktop-entry: Update my email addressWill Thompson1-1/+1
2022-12-03desktop-entry: Use gender neutral pronouns in specPhaedrus Leeds1-1/+1
It's more inclusive to use "they/them" rather than "he/him" when referring to the user in these specs.
2022-01-02desktop-entry-spec: Add "SingleMainWindow" keyNate Graham1-0/+18
This is an upstreaming of the GNOME-specific X-GNOME-SingleWindow key, which functions as the same thing, signaling that an app only supports having a single one of its main window open. We recently added support for apps with that key in KDE [1] and thought it would be useful to upstream (with a slightly more accurate name, since technically single-instance apps can open multiple windows) so that everyone could benefit from the same thing. [1] https://invent.kde.org/plasma/plasma-workspace/-/merge_requests/1309
2021-07-19desktop-entry: fix itemizedlist closing tagSimon Ser1-1/+1
Fixes: 923eb9fea389 ("Let DBus-activated processes properly integrate on Wayland")
2021-07-15Let DBus-activated processes properly integrate on WaylandAleix Pol1-5/+19
On Wayland, the xdg-activation-v1 protocol provides means for processes to get activated that requires a token to be passed to the compositor. This change explains how to make this wayland activation happen when the process has been invoked through DBus.
2020-12-18desktop-entry: Bump version number in description of Version keyAlexander Volkov1-1/+1
2020-04-27desktop-entry-spec: Bump development version to 1.5Bastien Nocera1-1/+1
2020-04-27web-export: desktop-entry version 1.4Bastien Nocera1-1/+1
2020-04-27desktop-entry-spec: add PrefersNonDefaultGPU entryJan Grulich1-0/+19
This new key tells a launcher to do what it can to run an application on the “non-default” GPU when available, usually a a more powerful discrete GPU. It's a standardisation of KDE's X-KDE-RunOnDiscreteGpu key.
2019-10-22desktop-entry: bump version to 1.4Will Thompson1-1/+1
2019-10-22desktop-entry: add changelog entry for iconstringWill Thompson1-2/+8
2019-10-22desktop-entry: add myself as an authorWill Thompson1-0/+9
2019-10-22desktop-entry: define an 'iconstring' typeWill Thompson1-5/+25
Icons are currently of type 'localestring', which is defined by this specification as follows: > Values of type 'localestring' are user displayable, and are encoded in > UTF-8 Icon names are not user-displayable, and so should not be extracted by tools like xgettext for translation along with user-displayable strings. However, we still want tools that load .desktop files to respect the (rare) cases where icons have been localized. Define a new type, 'iconstring', with the properties we want. See discussion at https://savannah.gnu.org/bugs/index.php?56543 and the linked mailing list thread.
2019-10-22desktop-entry: fix "togheter" typoWill Thompson1-1/+1
2019-10-21Rename .cvsignore to .gitignoreBastien Nocera1-0/+0
for i in `find -name .cvsignore` ; do mv $i `dirname $i`/.gitignore ; git add `dirname $i`/.gitignore ; done
2017-12-24desktop-entry-spec: separate 1.1 and 1.2, describe recent changesDavid Faure1-1/+5
2017-12-24mention that this file is outdatedDavid Faure1-0/+2
2017-12-24desktop-entry-spec: Deprecate dashes in well-known namesSimon McVittie1-0/+15
We don't really need two parallel forms of punctuation, and in particular DNS domain names only have one (dashes). If we choose one representation and deprecate the other, it makes the recommendation clearer for app authors. Dashes are not allowed in D-Bus object paths and interface names, are only conditionally allowed in Flatpak app IDs (they can only appear in the last element), and have a special syntactic role in Freedesktop icon names. An alternative approach would be to allow dashes, deprecate underscores, have a trivial conversion from DNS domain name to desktop file ID (except in the case of leading digits), and always special-case the transformation from desktop file ID/well-known bus name to object path, interface name or Flatpak app ID. However, that seems more error-prone, because it would make naive code incorrect; and general-purpose conversion from DNS domain name to desktop file ID is always going to need a special case anyway, to deal with leading digits (allowed in DNS but not D-Bus). Signed-off-by: Simon McVittie <smcv@debian.org>
2017-12-24desktop-entry-spec: Formalize the reverse DNS conventionSimon McVittie1-3/+8
Also mention the D-Bus convention for the part after the domain name, which is widely deployed and seems as good as anything else. Signed-off-by: Simon McVittie <smcv@debian.org>
2017-12-24desktop-entry-spec: Formalize file naming recommendationsSimon McVittie1-5/+15
* Add a link to the canonical definition of a D-Bus well-known name * Specify punctuation in terms of Unicode code points * Split syntactic rules (character set) and semantic rules (relationship to domain names) into separate paragraphs Signed-off-by: Simon McVittie <smcv@debian.org>
2017-12-24desktop-entry-spec: New section "File naming"Simon McVittie1-36/+42
This combines the notes on file naming that were previously part of "Basic format of the file" with the former appendix "Desktop File ID". Signed-off-by: Simon McVittie <smcv@debian.org>
2016-12-24Mention that %f includes the path.David Faure1-1/+1
https://bugs.freedesktop.org/show_bug.cgi?id=15167
2016-04-25desktop-entry-spec: allow '-' in application idsAllison Ryan Lortie1-3/+7
Up to now, the spec has not clearly specified what will happen if a '-' appears in an otherwise-valid-looking application ID with DBusActivatable=yes. This leads to problems because '-' is indeed valid in D-Bus names (which suggests that everything should work properly) but not valid in D-Bus object paths (which suggests that it won't work). Firm up the range of valid characters permitted in the recommended style of application IDs (instead of just saying "reverse DNS convention"). Specifically mention that '-' is permitted here. Specify how to deal with dashes when forming the D-Bus object path for the org.freedesktop.Application interface. https://bugs.freedesktop.org/show_bug.cgi?id=95129
2015-03-06Add a change historyMatthias Clasen1-2/+35
Also, bump the version to 1.2alpha to avoid confusion with additions that happpened after 1.1. Also, change the <pubdate> to today. https://bugs.freedesktop.org/show_bug.cgi?id=87463
2015-03-06Fix an oversight in the Version key specificationMatthias Clasen1-1/+1
Desktop files conforming to this version of the specification should use Version=1.1, obviously. https://bugs.freedesktop.org/show_bug.cgi?id=87462
2015-03-01desktop-entry-spec: document DesktopNamesRyan Lortie1-0/+6
Document the DesktopNames key as the mechanism by which the XDG_CURRENT_DESKTOP environment variable is expected to be set. We don't document this as a key in the normal way, because it is not a valid key for desktop files. We only include a mention of it here because the desktop entry spec is more or less the "home" of what XDG_CURRENT_DESKTOP means, and the mechanism by which it is normally set should be part of that definition. https://bugs.freedesktop.org/show_bug.cgi?id=85938
2014-04-23desktop-entry spec: fix typoRyan Lortie1-1/+1
2014-04-10desktop entry spec: Add support for Implements=Ryan Lortie1-0/+60
https://bugs.freedesktop.org/show_bug.cgi?id=73317
2014-04-04desktop-entry-spec: define "desktop ID"David Faure1-0/+44
(was only in menu spec; moved and improved) As requested and reviewed by Ryan Lortie, also reviewed by Bastien Nocera.
2014-04-03desktop-entry: specify $XDG_CURRENT_DESKTOPRyan Lortie1-7/+26
2014-04-02date -> pubdate, so it appears in the HTML-generated pagesDavid Faure1-1/+1
https://bugs.freedesktop.org/show_bug.cgi?id=76045
2014-04-01desktop-entry: call this 1.1 for simplicityDavid Faure1-1/+1
2014-04-01desktop-entry: Mention that trailing commas in lists are optionalJerome Leclanche1-5/+6
https://bugs.freedesktop.org/show_bug.cgi?id=76902 Approved by David Faure and Ryan Lortie
2013-07-11desktop-entry-spec: Remove OnlyShowIn / NotShowIn from desktop actionsJasper St. Pierre1-19/+0
As discussed on the list, there doesn't seem to be a good rationale for allowing actions to specify what desktop environment actions shoudl be shown in. https://bugs.freedesktop.org/show_bug.cgi?id=66712
2013-07-11desktop-entry: add DBusActivatableRyan Lortie1-8/+93
Add a DBusActivatable key along with the recommendation that desktop files be named like "org.example.FooViewer.desktop". https://bugs.freedesktop.org/show_bug.cgi?id=64066
2012-01-24desktop-entry: Improvements to specification of actionsVincent Untz1-95/+112
Structure and reorganize the text with subsections, and reword for clarifications. Also make the Icon key a localestring, like it is for Desktop Entry. Add a link to the Exec key section in the description of [Desktop Entry]/Exec.
2012-01-24desktop-entry: Restore support for Desktop ActionsGiovanni Campagna1-3/+127
Reintroduce the Actions key, which was removed around version 1.1, and give it a formal specification, detailing what actions applications are expected to provide and who should make use of this information. Names were taken from the original specification, since apparently they have been in use during all this time. Also remove X-KDE-* keys from the example, as it's unrelated to the spec.
2011-12-19desktop-entry: Add an optional Keywords keyFlorian Müllner1-2/+21
When searching through .desktop files, the existing keys meant for menu browsing may produce insufficient results; add a new optional key specifically targeting search which may be used to improve matches.
2008-09-12reword sentence about characters allowed in key names to avoid someVincent Untz2-2/+8
2008-09-12 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: reword sentence about characters allowed in key names to avoid some ambiguity. Patch by Simon McVittie <simon.mcvittie@collabora.co.uk>
2008-03-04bump version to 1.1-draft, so we can publish it. SeeVincent Untz2-2/+7
2008-03-04 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: bump version to 1.1-draft, so we can publish it. See http://bugs.freedesktop.org/show_bug.cgi?id=14097
2007-09-10fix Icon key in example: it was using the .png extension for an icon name.Vincent Untz2-1/+6
2007-09-10 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: fix Icon key in example: it was using the .png extension for an icon name. Which is wrong :-)
2007-07-27don't say that the files are encoded as lines of 8-bit characters, whichVincent Untz2-2/+10
2007-07-27 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: don't say that the files are encoded as lines of 8-bit characters, which is wrong for UTF-8. Use something a bit better proposed by Matthias Clasen <mclasen@redhat.com> Bug #11417.
2007-05-30s/DESKTOP_LAUNCH_ID/DESKTOP_STARTUP_ID/ Thanks to Dan WinshipVincent Untz2-1/+7
2007-05-30 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: s/DESKTOP_LAUNCH_ID/DESKTOP_STARTUP_ID/ Thanks to Dan Winship <danw@gnome.org> for catching this. Bug #11081.
2007-04-28scanf behavior is locale-dependent, and the numeric type shouldn't be.Vincent Untz2-1/+9
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: scanf behavior is locale-dependent, and the numeric type shouldn't be. Specify that the value is a floating point number as recognized by scanf in the C locale. Thanks to Dan Winship <danw@gnome.org> for catching this. http://lists.freedesktop.org/archives/xdg/2007-April/009732.html
2007-04-28clarify description for the TryExec key.Vincent Untz2-3/+10
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: clarify description for the TryExec key. http://lists.freedesktop.org/archives/xdg/2007-March/009556.html
2007-04-28change "the $PATH" to "the $PATH environment variable".Vincent Untz2-1/+8
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: change "the $PATH" to "the $PATH environment variable". http://lists.freedesktop.org/archives/xdg/2007-March/009552.html
2007-04-28improve the description of the Comment key.Vincent Untz2-3/+8
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: improve the description of the Comment key. http://lists.freedesktop.org/archives/xdg/2007-March/009440.html
2007-04-28a desktop file of type Application should always have an Exec key. SameVincent Untz2-2/+15
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: a desktop file of type Application should always have an Exec key. Same for Link Type and URL key. http://lists.freedesktop.org/archives/xdg/2007-March/009437.html
2007-04-28desktop files of type Directory have a .directory extension right now (atVincent Untz2-6/+15
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml: desktop files of type Directory have a .directory extension right now (at least in GNOME), but according to the spec, this is wrong. The patch fixes this. Also, it removes a small part of text explaining the name of a desktop file describing a directory. http://lists.freedesktop.org/archives/xdg/2007-March/009437.html
2007-04-28clarify a bit the text about keys that only makes sense in a specificVincent Untz2-1/+13
2007-04-28 Vincent Untz <vuntz@gnome.org> * desktop-entry-spec.xml:clarify a bit the text about keys that only makes sense in a specific context. Also, state that the keys should not be used outside of this context. For example, the URL key should not be present if the type is not Link. http://lists.freedesktop.org/archives/xdg/2007-March/009437.html
generated by cgit v1.2.3 (git 2.39.1) at 2024-05-04 07:33:55 +0000