From 86fec680b6944a52ae3dd4e7cdd967b2047872c8 Mon Sep 17 00:00:00 2001
From: Adrian Sampson <adrian@radbox.org>
Date: Sat, 12 Oct 2013 19:35:17 -0700
Subject: [PATCH] add missing ftintitle docs

---
 docs/plugins/ftintitle.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 docs/plugins/ftintitle.rst

diff --git a/docs/plugins/ftintitle.rst b/docs/plugins/ftintitle.rst
new file mode 100644
index 000000000..19bb612c7
--- /dev/null
+++ b/docs/plugins/ftintitle.rst
@@ -0,0 +1,20 @@
+FtInTitle Plugin
+================
+
+The ``ftintitle`` plugin automatically moved "featured" artists from the
+``artist`` field to the ``title`` field.
+
+According to `MusicBrainz style`_, featured artists are part of the artist
+field. That means that, if you tag your music using MusicBrainz, you'll have
+tracks in your library like "Tellin' Me Things" by the artist "Blakroc feat.
+RZA". If you prefer to tag this as "Tellin' Me Things feat. RZA" by "Blakroc",
+then this plugin is for you.
+
+To use the plugin, just enable it and run the command::
+
+    $ beet ftintitle [QUERY]
+
+The query is optional; if it's left off, the transformation will be applied to
+your entire collection.
+
+.. _MusicBrainz style: http://musicbrainz.org/doc/Style