pulseaudio: Minor clarifications to 15.0 release notes

1 files changed, 13 insertions, 11 deletions

diff --git a/Software/PulseAudio/Notes/15.0.mdwn b/Software/PulseAudio/Notes/15.0.mdwn
index 11672e6a..07e02dea 100644
--- a/Software/PulseAudio/Notes/15.0.mdwn
+++ b/Software/PulseAudio/Notes/15.0.mdwn
@@ -6,7 +6,7 @@
 
 ## Notes for end users
 
-### Support for LDAC and AptX bluetooth codecs, plus so-called "SBC XQ" (SBC with higher-quality parameters)
+### Support for LDAC and AptX bluetooth codecs, plus "SBC XQ" (SBC with higher-quality parameters)
 
 PulseAudio now supports the LDAC and AptX codecs for A2DP. In order to use them, the device has to support the codecs too. Also "XQ" configuration variants for the old SBC codec are available. The SBC XQ variants have a fixed (and higher than the "normal" SBC) bitrate, so they may have more drop-outs if the wireless connection is bad, but on the other hand the quality is always good if the connection is good. For variable bitrate, pulseaudio is now able to increase the bitrate again after it was reduced due to connectivity issues. 
 
@@ -16,7 +16,7 @@ Switching the codec can be done on the command line with `pactl send-message /ca
 
 Native support for HFP AG role has been added. The native backend has become the default backend for HSP/HFP. Support for ofono is still available when setting the backend parameter to `auto` or `ofono`. The native backend currently only implements the HFP AG role, but not the HFP HS role, therefore ofono is still required for this role. Additionally, support for mSBC has been implemented to improve voice quality. 
 
-### Support for bluetooth A2DP AVRCP Absolute Volume
+### Support for Bluetooth A2DP AVRCP Absolute Volume
 
 AVRCP Absolute Volume allows PulseAudio to control the volume of the connected A2DP device (when playing to it) or for a connected device to control volume in PulseAudio (when the device plays to PulseAudio). Previously when playing to e.g. a headset, PulseAudio did its own volume control in software, and the headset did its own volume in hardware. Having two levels of volumes sometimes made it difficult to get high enough volume, now there's only one level of volume control.
 
@@ -43,23 +43,25 @@ module-jackdbus-detect automatically loads a JACK sink and source when JACK star
  * `sink_client_name` - The name that the JACK sink uses when it registers a client with JACK
  * `source_client_name` - The name that the JACK source uses when it registers a client with JACK
 
-### Improved support for SteelSeries Arctis 9
+### Improved hardware support
+
+#### SteelSeries Arctis 9
 
 The same custom configuration that is used with several other USB gaming headsets is now applied to SteelSeries Arctis 9, which makes the device much more functional.
 
-### Improved support for HP Thunderbolt Dock 120W G2
+#### HP Thunderbolt Dock 120W G2
 
 HP Thunderbolt Dock 120W G2 has a 3.5 mm headset connector, and there's a separate audio module sold for the dock that provides speakerphone functionality (integrated microphone and speaker with echo cancellation). PulseAudio now has configuration that improves the device descriptions shown to the user and marks the speakerphone as a preferred device for voice audio.
 
-### Improved support for Behringer U-Phoria UMC22
+#### Behringer U-Phoria UMC22
 
 Behringer U-Phoria UMC22 has two mono microphone inputs, which show up as a single stereo device in ALSA. PulseAudio now has custom configuration for this sound card, allowing the user to select a profile that enables only one or the other of the channels. That way recording applications don't end up recording a stereo track that has audio only on one channel.
 
-### Improved support for OnePlus Type-C Bullets
+#### OnePlus Type-C Bullets
 
 OnePlus Type-C Bullets is a simple USB-C headset device. It works with the default configuration too, but custom configuration was added to hide card profiles that don't make sense (for example, HDMI showed up as a supported profile with the default configuration).
 
-### Improved support for Sennheiser GSX 1000/1200 PRO
+#### Sennheiser GSX 1000/1200 PRO
 
 Sennheiser GSX 1000 and 1200 PRO are USB DACs designed for gaming. They have a separate mono output for voice audio, and they also provide a virtual surround device that downmixes 7.1 surround audio to headphones in hardware. Custom configuration was added to expose these devices properly.
 
@@ -97,7 +99,7 @@ Card profiles can be set to sticky using the command `pactl send-message /card/<
 
 ## Notes for application developers
 
-### New API for sending messages from clients to pulseaudio objects
+### New API for sending messages from clients to PulseAudio objects
 
 The new "message API" was added to facilitate easy communication between clients and pulseaudio objects. It's currently used for switching bluetooth codecs and setting card profiles to sticky. The message API is using JSON format to exchange information between pulseaudio objects and a client.
 
@@ -107,7 +109,7 @@ If an application wants last bits of virtual memory, it can forcefully disable s
 
 ## Notes for packagers
 
-### Autotools have been dropped
+### Autotools build system have been dropped
 
 As already announced in the 14.0 release notes, the support for autotools finally has been dropped. The meson build system has been improved significantly and is now the standard way to build pulseaudio. 
 
@@ -115,11 +117,11 @@ As already announced in the 14.0 release notes, the support for autotools finall
 
 PulseAudio's startup script (default.pa for the normal per-user mode and system.pa for the system mode) defines the set of modules to load automatically on startup. At the end of the scripts there is now an include directive that loads files from `/etc/pulse/default.pa.d/` or `/etc/pulse/system.pa.d/`. This is primarily meant for distributions when they want to add some module to the configuration when installing a package: it's now easy to install a file containing the configuration for the installed package. Users can of course use this mechanism too if they prefer to add a module to the configuration without modifying the original startup script.
 
-### It's possible to exclude the daemon from a build
+### Option to build client library and utilities only
 
 When PipeWire is used to replace PulseAudio, libpulse and PulseAudio utilities are still useful but the PulseAudio daemon is not needed. It's now possible to compile libpulse and the utilities without compiling the daemon. To do this, pass `-Ddaemon=false` to Meson.
 
-### Avoid loading X11 modules on Wayland (GNOME only for now)
+### Avoid loading X11 modules on Wayland (GNOME-only for now)
 
 PulseAudio traditionally loads a few X11 modules automatically on a graphical login via the `/etc/xdg/autostart/pulseaudio.desktop` file. That's not really desirable on Wayland, because that will autostart XWayland even if it's not otherwise used. The `pulseaudio.desktop` file now contains the line `X-GNOME-HiddenUnderSystemd=true`, so when using GNOME and systemd the X11 modules aren't loaded this way any more. If GNOME is run under X11, there's a new systemd service called `pulseaudio-x11` that handles loading the X11 modules.