Add docs and changelog for archive import

Author: Thomas Scholtes

docs/changelog.rst

@@ -25,6 +25,7 @@ New stuff:
 * There is also a new :doc:`/plugins/keyfinder` that runs a command line
   program to get the key from audio data and store it in the
   `initial_key` field.
+* Beets can now import `zip`, `tar` and `rar` archives.
 
 Fixes:
 

docs/reference/cli.rst

@@ -43,21 +43,25 @@ import
 ``````
 ::
 
-    beet import [-CWAPRqst] [-l LOGPATH] DIR...
+    beet import [-CWAPRqst] [-l LOGPATH] PATH...
     beet import [options] -L QUERY
 
 Add music to your library, attempting to get correct tags for it from
 MusicBrainz.
 
-Point the command at a directory full of music. The directory can be a single
-album or a directory whose leaf subdirectories are albums (the latter case is
-true of typical Artist/Album organizations and many people's "downloads"
-folders). The music will be copied to a configurable directory structure (see
-below) and added to a library database (see below). The command is interactive
-and will try to get you to verify MusicBrainz tags that it thinks are suspect.
-(This means that importing a large amount of music is therefore very tedious
-right now; this is something we need to work on. Read the
-:doc:`autotagging guide </guides/tagger>` if you need help.)
+Point the command at a directory full of music. The directory can be a
+single album or a directory whose leaf subdirectories are albums (the
+latter case is true of typical Artist/Album organizations and many
+people's "downloads" folders). The path can also be a single file or an
+archive. Beets supports `zip` and `tar` archives out of the box. To
+extract `rar` files you need to install the `rarfile`_ package and the
+`unrar` command. The music will be copied to a configurable directory
+structure (see below) and added to a library database (see below). The
+command is interactive and will try to get you to verify MusicBrainz
+tags that it thinks are suspect.  (This means that importing a large
+amount of music is therefore very tedious right now; this is something
+we need to work on. Read the :doc:`autotagging guide </guides/tagger>`
+if you need help.)
 
 * By default, the command copies files your the library directory and
   updates the ID3 tags on your music. If you'd like to leave your music
@@ -116,6 +120,8 @@ right now; this is something we need to work on. Read the
   ``--group-albums`` option to split the files based on their metadata before
   matching them as separate albums.
 
+.. _rarfile: https://pypi.python.org/pypi/rarfile/2.2
+
 .. only:: html
 
     Reimporting