commit - 5d86bc14239778053daa5c38c13f2a5c7d63a24c
commit + a6d90fb2a2388f8dac656580763603d3d5800862
blob - dec680d9676e016b064e1853c041172615e294db
blob + f6920244743a072cc8d91eab40c121d6441a8cc4
--- amused.1
+++ amused.1
@@ -12,7 +12,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd May 9, 2022
+.Dd May 10, 2022
 .Dt AMUSED 1
 .Os
 .Sh NAME
@@ -28,10 +28,8 @@
 .Oc
 .Sh DESCRIPTION
 .Nm
-is a music player daemon and command-line utility that plays music
-in the background.
-The server is automatically started when the user interacts with
-it.
+is a music player daemon and command-line utility to plays music.
+The server is started automatically in the background on demand.
 .Pp
 The following options are available:
 .Bl -tag -width Ds
@@ -40,7 +38,7 @@ Do not daemonize if starting the daemon:
 .Nm
 will run in the foreground and log to standard error.
 It's ignored if any commands are given on the command line or if the
-server was already running.
+server is already running.
 .It Fl v
 Produce more verbose output.
 .It Fl s Ar socket
@@ -70,21 +68,22 @@ Play the first song in the playing queue that matches
 Load a playlist from
 .Ar file
 or standard input.
-A playlist is a list of paths to music files one per line optionally
-prefixed by
+A playlist is a list of paths to music files given one per line
+and optionally prefixed by
 .Sq > \&
 or two spaces.
 If the list was generated by
 .Nm
 .Ic show Fl p
-restores also the currently played song, otherwise tries to match it in
-the new list.
+restores also the position in the playlist, otherwise if already playing
+something tries to match the currently playing song in the new list.
+Failing that, the playlist will be played from the first track onwards.
 .It Cm monitor
-Stop indefinitely and print the events as happen.
-Events are print one per line and are triggered either by other
-instances of
+Stop indefinitely and print the events as they happen one per line.
+The events are triggered either by other instances of
 .Nm
-issuing commands or the player itself anvancing the playing queue.
+issuing commands or the player itself anvancing through the playing
+queue.
 .It Cm next
 Play the next song.
 .It Cm pause
@@ -94,9 +93,9 @@ Start or resume the playback.
 .It Cm prev
 Play the previous song.
 .It Cm repeat one|all on|off
-Enable or disable the repetition of the current track
+Enable or disable the automatic repetition of the current track
 .Pq Cm one
-or of the playing queue
+or of the whole playing queue
 .Pq Cm all .
 .It Cm restart
 Rewind the current song to the beginning.
@@ -148,7 +147,7 @@ Load a previous state:
 $ amused load < state
 .Ed
 .Pp
-Randomize the current playlist:
+Shuffle the playlist:
 .Bd -literal -offset indent
 $ amused show | sort -R | amused load
 .Ed