summary refs log tree commit diff
path: root/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
diff options
context:
space:
mode:
authorK900 <me@0upti.me>2022-02-23 10:26:30 +0300
committerJonathan Ringer <jonringer@users.noreply.github.com>2022-02-25 13:40:38 -0800
commit066a581a80c0939423ff8b2d4b451a07ea8e5865 (patch)
tree33882d64391f55b47b0c3c4e59ee2780baba5ea0 /nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
parent8bb8f9c8118be62d632b6636c2f52e26e2f763bd (diff)
downloadnixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.tar
nixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.tar.gz
nixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.tar.bz2
nixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.tar.lz
nixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.tar.xz
nixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.tar.zst
nixpkgs-066a581a80c0939423ff8b2d4b451a07ea8e5865.zip
nixos/doc: add release note for makeDesktopItem changes
Diffstat (limited to 'nixos/doc/manual/from_md/release-notes/rl-2205.section.xml')
-rw-r--r--nixos/doc/manual/from_md/release-notes/rl-2205.section.xml64
1 files changed, 64 insertions, 0 deletions
diff --git a/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml b/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
index 56f9f60f3eb..0760a781ea3 100644
--- a/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
+++ b/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
@@ -746,6 +746,70 @@
           <literal>false</literal>.
         </para>
       </listitem>
+      <listitem>
+        <para>
+          <literal>pkgs.makeDesktopItem</literal> has been refactored to
+          provide a more idiomatic API. Specifically:
+        </para>
+        <itemizedlist spacing="compact">
+          <listitem>
+            <para>
+              All valid options as of FDO Desktop Entry specification
+              version 1.4 can now be passed in as explicit arguments
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <literal>exec</literal> can now be null, for entries that
+              are not of type Application
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <literal>mimeType</literal> argument is renamed to
+              <literal>mimeTypes</literal> for consistency
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <literal>mimeTypes</literal>,
+              <literal>categories</literal>,
+              <literal>implements</literal>,
+              <literal>keywords</literal>, <literal>onlyShowIn</literal>
+              and <literal>notShowIn</literal> take lists of strings
+              instead of one string with semicolon separators
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <literal>extraDesktopEntries</literal> renamed to
+              <literal>extraConfig</literal> for consistency
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Actions should now be provided as an attrset
+              <literal>actions</literal>, the <literal>Actions</literal>
+              line will be autogenerated.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              <literal>extraEntries</literal> is removed.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              Additional validation is added both at eval time and at
+              build time.
+            </para>
+          </listitem>
+        </itemizedlist>
+        <para>
+          See the <literal>vscode</literal> package for a more detailed
+          example.
+        </para>
+      </listitem>
     </itemizedlist>
   </section>
   <section xml:id="sec-release-22.05-notable-changes">