commit cfb00927935d61448456a1fd84b3dfa807e86cfc
from: Omar Polo <op@omarpolo.com>
date: Thu Feb 17 12:13:37 2022 UTC

improve manpage

commit - da045d77d15313594de2066d2a0eeeb7eb288790
commit + cfb00927935d61448456a1fd84b3dfa807e86cfc
blob - f1a5b2aefd895341494689f892fcfd26a573be9c
blob + 97d7ea9e0c962876b2177da26e2ce231579a7f08
--- amused.1
+++ amused.1
@@ -26,14 +26,13 @@
 .Op Ar argument ...
 .Sh DESCRIPTION
 .Nm
-is a music player daemon and command-line utility.
+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, but it can be started manually by running
+.Nm
+without any arguments.
 .Pp
-If called without any sub-
-.Ar command
-it forks in the background and starts the daemon.
-Once the daemon is running, music files can be enqueued and the reproduction
-controlled.
-.Pp
 The following options are available:
 .Bl -tag -width 12m
 .It Fl d
@@ -42,6 +41,7 @@ if this option is specified,
 .Nm
 will run in the foreground and log to
 .Em stderr .
+It's ignored if any commands are given on the command line.
 .It Fl v
 Produce more verbose output.
 .It Fl s Ar socket
@@ -55,7 +55,7 @@ to communicate with the daemon.
 The following commands are available:
 .Bl -tag -width 12m
 .It Cm play
-Start or resume playing the playlist.
+Start or resume the playback.
 .It Cm pause
 Pause the playback.
 .It Cm toggle
@@ -63,7 +63,7 @@ Play/pause the playback.
 .It Cm stop
 Stop the music player.
 .It Cm restart
-Rewind the current song from the beginning.
+Rewind the current song to the beginning.
 .It Cm add Ar
 Enqueue the given files.
 .It Cm flush
@@ -89,6 +89,12 @@ which has one song per line.
 If not specified, reads from
 .Em stdin .
 .El
+.Pp
+Commands can be also abbreviated to the smallest unique prefix,
+so that for example
+.Sq re
+can be given instead of
+.Sq restart .
 .Sh FILES
 .Bl -tag -width "/tmp/amused-$UID" -compact
 .It Pa /tmp/amused-$UID