From: Ralph Ronnquist Date: Thu, 27 Apr 2023 16:14:40 +0000 (+1000) Subject: editorial X-Git-Url: https://git.rrq.au/?a=commitdiff_plain;h=e4dec7c1d25ea3566deb336f9167fce48302b076;p=rrq%2Fnewlisp%2Falsa-dispatcher.git editorial --- diff --git a/alsa-dispatcher.8.adoc b/alsa-dispatcher.8.adoc index 0e27fc9..d3554eb 100644 --- a/alsa-dispatcher.8.adoc +++ b/alsa-dispatcher.8.adoc @@ -25,24 +25,24 @@ with _libasound.so_ for ALSA API actions. == CONFIGURATIONS -The system setup for using *alsa-dispatcher.lsp* includes two -configuration aspects: +The setup for using *alsa-dispatcher.lsp* includes two configuration +aspects: 1. The ALSA configuration collection needs to be augmented with a _pcm_ block that directs playback to *alsa-dispatcher.lsp* and capture from, say, _plughw_ (i.e., the primary sound card). - 2. The priority list for *alsa-dispatcher.lsp* of posible endpoints + 2. The priority list of posible endpoints for *alsa-dispatcher.lsp* is a text file named _$HOME/.alsa-dispatcher_. [] *ALSA configuration (e.g. $HOME/.asoundrc)*:: -The ALSA configuration collection needs to include setup for -*alsa-dispatcher* as an ALSA PCM by means of e.g. a short declaration -in the user's _$HOME/.asoundrc_ file, or system-wide in -_/etc/asoundrc.conf_ The following is an example. +The ALSA configuration collection needs to include a declaration for +*alsa-dispatcher* as an ALSA PCM by means of a short declaration in +the user's _$HOME/.asoundrc_ file or system-wide in +_/etc/asoundrc.conf_ The following is an example _$HOME/.asoundrc_. + ---- pcm.!default dispatch @@ -56,22 +56,23 @@ pcm.dispatch { } ---- + -The first of those lines asserts that "dispatch" is the default +The first line in the example asserts that "dispatch" is the default PCM. + -The lines below declares the "dispatch" PCM to have its playback -stream directed via a pipe to the command -_/usr/local/bin/alsa-dispatcher.lsp_ (assuming that is where -*alsa-dispatcher.lsp* is), and its capture stream is sourced from -_plughw_ (i.e. the default sound card). +The lines below that declares the "dispatch" PCM to have its playback +stream directed to the command _/usr/local/bin/alsa-dispatcher.lsp_ +via a pipe (that is where *alsa-dispatcher.lsp* is for this example), +and the "dispatch" PCM capture stream is sourced from _plughw_ (i.e. +the default sound card). *About $HOME/.alsa-dispatcher*:: -The possible endpoints are enumerated in _$HOME/.alsa-dispatcher_ with -one line for each PCM device: its name and optionally some specific -setting variation for that device in the form of _key=value_. Blank -lines and lines starting with "#" are comments. The following is an -example. +Possible endpoints are enumerated for *alsa-dispatcher.lsp* in a text +file _$HOME/.alsa-dispatcher_ with one line for each PCM device. The +line contains its name and optionally some specific setting variation +for that device. Such settings have the form of _key=value_ with space +seapartion between settings. Blank lines and lines starting with "#" +are comments. The following is an illustration example. + ---- bt