commit - da045d77d15313594de2066d2a0eeeb7eb288790
commit + cfb00927935d61448456a1fd84b3dfa807e86cfc
blob - f1a5b2aefd895341494689f892fcfd26a573be9c
blob + 97d7ea9e0c962876b2177da26e2ce231579a7f08
--- amused.1
+++ amused.1
.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
.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
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
.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
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