[gentoo-dev] [PATCH] 2024-05-03-wireplumber-0_5-bump: add news item

[gentoo-dev] [PATCH] 2024-05-03-wireplumber-0_5-bump: add news item

[James Calligeros]

Signed-off-by: James Calligeros <jcalligeros99@gmail.com>
---
 .../2024-05-03-wireplumber-0_5-bump.en.txt    | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 2024-05-03-wireplumber-0_5-bump/2024-05-03-wireplumber-0_5-bump.en.txt

diff --git a/2024-05-03-wireplumber-0_5-bump/2024-05-03-wireplumber-0_5-bump.en.txt b/2024-05-03-wireplumber-0_5-bump/2024-05-03-wireplumber-0_5-bump.en.txt
new file mode 100644
index 0000000..0c43de8
--- /dev/null
+++ b/2024-05-03-wireplumber-0_5-bump/2024-05-03-wireplumber-0_5-bump.en.txt
@@ -0,0 +1,23 @@
+Title: Potentially breaking upgrade - media-video/wireplumber-0.5.2
+Author: James Calligeros <jcalligeros99@gmail.com>
+Posted: 2024-05-03
+Revision: 1
+News-Item-Format: 2.0
+
+As some will be aware, WirePlumber 0.5.0 introduced a significant breaking
+change to its entire configuration system, eliminating the use of Lua
+scripts for configuration purposes. This also came with a complete
+rework of how Lua scripts are registered with WirePlumber for execution.
+
+Most typical desktop users, including EasyEffects users, should not notice
+any change to their system. That said, it was not uncommon for people to
+suggest or implement configuration changes using the Lua API.
+
+                 ANY CUSTOM FUNCTIONALITY WHICH RELIES
+             ON WIREPLUMBER'S LUA API WILL BREAK ON UPGRADE
+
+If you rely on this functionality, please review the WirePlumber documentation
+on porting your Lua scripts to the new API and registering them with the system
+before upgrading:
+
+https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/migration.html
-- 
2.45.0

Re: [gentoo-dev] [PATCH] 2024-05-03-wireplumber-0_5-bump: add news item

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 1532 bytes --]

>>>>> On Fri, 03 May 2024, James Calligeros wrote:

> +Title: Potentially breaking upgrade - media-video/wireplumber-0.5.2

The title must have 50 chars as a maximum, by GLEP 42. If it is longer,
then it isn't guaranteed that eselect news will display it properly.

> +Author: James Calligeros <jcalligeros99@gmail.com>
> +Posted: 2024-05-03
> +Revision: 1
> +News-Item-Format: 2.0

I guess this could profit from a "Display-If-Installed" header. Read the
GLEP for details.

> +
> +As some will be aware, WirePlumber 0.5.0 introduced a significant breaking
> +change to its entire configuration system, eliminating the use of Lua
> +scripts for configuration purposes. This also came with a complete
> +rework of how Lua scripts are registered with WirePlumber for execution.
> +
> +Most typical desktop users, including EasyEffects users, should not notice
> +any change to their system. That said, it was not uncommon for people to
> +suggest or implement configuration changes using the Lua API.
> +
> +                 ANY CUSTOM FUNCTIONALITY WHICH RELIES
> +             ON WIREPLUMBER'S LUA API WILL BREAK ON UPGRADE

Please don't shout. It will hurt users' ears. :)

> +
> +If you rely on this functionality, please review the WirePlumber documentation
> +on porting your Lua scripts to the new API and registering them with the system
> +before upgrading:

Again, by GLEP 42: "The text body should be wrapped at 72 characters."

> +
> +https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/migration.html

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 507 bytes --]