spec: Make launchable requirement for desktop-apps more strict

Resolves: #576
ximion · Feb 22, 2024 · 2f6010f · 2f6010f
1 parent d69dd93
commit 2f6010f
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 6 deletions.
diff --git a/docs/xml/catalog-xmldata.xml b/docs/xml/catalog-xmldata.xml
@@ -496,7 +496,7 @@
 				<term>&lt;launchable/&gt;</term>
 				<listitem>
 					<para>
-						This optional tag follows the same schema as described for metainfo files in <xref linkend="tag-launchable"/>.
+						This tag follows the same schema as described for metainfo files in <xref linkend="tag-launchable"/>.
 					</para>
 				</listitem>
 			</varlistentry>

diff --git a/docs/xml/metainfo-component.xml b/docs/xml/metainfo-component.xml
@@ -410,12 +410,12 @@
 		<term>&lt;launchable/&gt;</term>
 		<listitem>
 		<para>
-		         This optional tag indicates possible methods to launch the software described in this component.
-                         It is allowed to appear multiple times in the metainfo data.
+		         This tag indicates possible methods to launch the software described in this component.
+                         It is allowed to appear multiple times in MetaInfo data.
 		</para>
 
 		<para>
-		  The <code>&lt;launchable/&gt;</code> tag has an essential <literal>type</literal> property indicating the system that is used to launch the component.  The following types are allowed:
+		  The <code>&lt;launchable/&gt;</code> tag has a required <literal>type</literal> property indicating the system that is used to launch the component.  The following types are allowed:
                 </para>
                 <variablelist>
                   <varlistentry>

diff --git a/docs/xml/metainfo-desktopapp.xml b/docs/xml/metainfo-desktopapp.xml
@@ -141,7 +141,10 @@
 			<term>&lt;launchable/&gt;</term>
 			<listitem>
 				<para>
-					It is recommended that a <code>&lt;launchable/&gt;</code> tag is present in <literal>desktop-application</literal> metainfo files.
+					It is required that a <code>&lt;launchable/&gt;</code> tag is present in <literal>desktop-application</literal> MetaInfo files,
+					unless the MetaInfo data itself contains all required information that a desktop-entry file would have (categories, icon data, ...) and the
+					application can not be launched standalone. This makes the launchable tag a required tag for pretty much all <literal>desktop-application</literal>
+					components, with only very rare exceptions.
 					The tag is described in detail at <xref linkend="tag-launchable"/>.
 				</para>
 				<para>
@@ -229,7 +232,8 @@
 
 		<para>
 			For a component of type <literal>desktop-application</literal>, the following tags are required and must always be present: <xref linkend="tag-id-desktopapp"/>,
-			<xref linkend="tag-dapp-name"/>, <xref linkend="tag-dapp-summary"/>, <xref linkend="tag-description"/>, <xref linkend="tag-metadata_license"/>.
+			<xref linkend="tag-dapp-name"/>, <xref linkend="tag-dapp-summary"/>, <xref linkend="tag-description"/>, <xref linkend="tag-metadata_license"/>,
+			<xref linkend="tag-dapp-launchable"/>.
 		</para>
 
 	</section>