From: Ralph Ronnquist <ralph.ronnquist@gmail.com>
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