From 4e8b34699354b14cf433bbc2b1ff691eda0ad062 Mon Sep 17 00:00:00 2001 From: Kalev Lember Date: Fri, 12 Apr 2019 10:43:14 +0200 Subject: [PATCH] Add a note about not dropping .desktop suffix from existing IDs --- docs/sources/metainfo/desktopapp.xml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/sources/metainfo/desktopapp.xml b/docs/sources/metainfo/desktopapp.xml index e651fb99..e1984356 100644 --- a/docs/sources/metainfo/desktopapp.xml +++ b/docs/sources/metainfo/desktopapp.xml @@ -83,6 +83,13 @@ components can be an arbitrary string (matching the naming rules applying to all AppStream metadata), while the tag is used to associate .desktop files with their metainfo files. + + Note that even though the component-ID can now be arbitrary, when updating existing applications, do not change their + <id/> to drop the .desktop suffix. The rules are relaxed when picking a new component-ID for new + applications, but when updating older applications they still need to keep their original <id/> (when + it's otherwise compliant) as it is a unique way of identifying applications across distributions and releases and should + always remain stable. +