nixos/doc: add release note for makeDesktopItem changes
This commit is contained in:
parent
8bb8f9c811
commit
066a581a80
|
@ -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">
|
||||
|
|
|
@ -231,6 +231,18 @@ In addition to numerous new and upgraded packages, this release has the followin
|
|||
pipewire-media-session is deprecated by upstream and not recommended, but can still be manually enabled by setting
|
||||
`services.pipewire.media-session.enable` to `true` and `services.pipewire.wireplumber.enable` to `false`.
|
||||
|
||||
- `pkgs.makeDesktopItem` has been refactored to provide a more idiomatic API. Specifically:
|
||||
- All valid options as of FDO Desktop Entry specification version 1.4 can now be passed in as explicit arguments
|
||||
- `exec` can now be null, for entries that are not of type Application
|
||||
- `mimeType` argument is renamed to `mimeTypes` for consistency
|
||||
- `mimeTypes`, `categories`, `implements`, `keywords`, `onlyShowIn` and `notShowIn` take lists of strings instead of one string with semicolon separators
|
||||
- `extraDesktopEntries` renamed to `extraConfig` for consistency
|
||||
- Actions should now be provided as an attrset `actions`, the `Actions` line will be autogenerated.
|
||||
- `extraEntries` is removed.
|
||||
- Additional validation is added both at eval time and at build time.
|
||||
|
||||
See the `vscode` package for a more detailed example.
|
||||
|
||||
<!-- To avoid merge conflicts, consider adding your item at an arbitrary place in the list instead. -->
|
||||
|
||||
## Other Notable Changes {#sec-release-22.05-notable-changes}
|
||||
|
|
Loading…
Reference in a new issue