From 315fe78f0cda91c379403bc85a2e3e4e8d38bffe Mon Sep 17 00:00:00 2001
From: Adrian Sampson <adrian@radbox.org>
Date: Fri, 14 Aug 2015 19:57:05 -0700
Subject: [PATCH] Example for play --args (#1532)

---
 docs/plugins/play.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/plugins/play.rst b/docs/plugins/play.rst
index b856d5e6f..54bf82649 100644
--- a/docs/plugins/play.rst
+++ b/docs/plugins/play.rst
@@ -51,3 +51,18 @@ Optional Arguments
 The ``--args`` (or ``-A``) flag to the ``play`` command lets you specify
 additional arguments for your player command. Options are inserted after the
 configured ``command`` string and before the playlist filename.
+
+For example, if you have the plugin configured like this::
+
+    play:
+        command: mplayer -quiet
+
+and you occasionally want to shuffle the songs you play, you can type::
+
+    $ beet play --args -shuffle
+
+to get beets to execute this command::
+
+    mplayer -quiet -shuffle /path/to/playlist.m3u
+
+instead of the default.