[PATCH v24 14/16] docs: describe virtio-sound capture options

[Joonho Lee]

Document the request-owned default capture path, its temporary memory
and copy cost, and the two remaining default-off compatibility
parameters. Remove the earlier opt-in staging and short/empty-response
descriptions.

Assisted-by: LLM
Signed-off-by: Joonho Lee <mynameisjune111@xxxxxxxxx>

---
Documentation/admin-guide/kernel-parameters.txt |   23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -8344,6 +8344,29 @@
 
 			Can be used multiple times for multiple devices.
 
+	virtio_snd.capture_packed_status= [HW,ALSA]
+			Read an explicitly enabled packed status trailer after
+			the returned capture data. The fixed status scatterlist is
+			used by default.
+			Format: <bool>
+			Default: false.
+
+	virtio_snd.capture_pause_restart= [HW,ALSA]
+			Stop and release the stream when pausing capture. On
+			resume, send SET_PARAMS, PREPARE, and START. With this
+			option disabled, pause uses STOP and START while retaining
+			the prepared stream.
+			Format: <bool>
+			Default: false.
+
+			Capture always receives into request-owned buffers, then
+			appends validated, frame-aligned audio to the ALSA ring in
+			request order. A valid short response is retained. Empty
+			responses are tolerated only during bounded startup or for
+			requests already in flight at STOP or PAUSE. This uses up
+			to one PCM buffer of temporary memory and copies returned
+			audio into the ALSA ring.
+
 	vga=		[BOOT,X86-32] Select a particular video mode
 			See Documentation/arch/x86/boot.rst and
 			Documentation/admin-guide/svga.rst.