Simplify export plugins

Author: sampsyo

docs/plugins/export.rst

@@ -1,70 +1,65 @@
 Export Plugin
 =============
 
-The ``export`` plugin lets you get data from the items and export the content to
-a ``json`` file.
+The ``export`` plugin lets you get data from the items and export the content
+as `JSON`_.
 
-Configuration
--------------
-To configure the plugin, make a ``export:`` section in your configuration
-file. The default options are::
+.. _JSON: http://www.json.org
 
-  export:
-    default_format: json
-    json:
-      formatting:
-        ensure_ascii: False
-        indent: 4
-        separators: [',' , ': ']
-        sort_keys: true
+Enable the ``export`` plugin (see :ref:`using-plugins` for help). Then, type ``beet export`` followed by a :doc:`query </reference/query>` to get the data from
+your library. For example, run this::
 
-- **default_format**: Choose the format of the exported content.
-  Supports json only for now.
+    $ beet export beatles
 
-Each format have their own options.
+to print a JSON file containing information about your Beatles tracks.
 
-The ``json`` formatting uses the `json`_ standard library options.
-Using custom options overwrites all options at the same level.
-The default options used here are:
+Command-Line Options
+--------------------
 
-- **ensure_ascii**: All non-ASCII characters are escaped with `\uXXXX`, if true.
+The ``export`` command has these command-line options:
 
-- **indent**: The number of spaces for indentation.
+* ``--include-keys`` or ``-i``: Choose the properties to include in the output
+  data. The argument is a comma-separated list of simple glob patterns where
+  ``*`` matches any string. For example::
 
-- **separators**: A ``(item_separator, dict_separator)`` tuple
+      $ beet export -i 'title,mb*' beatles
 
-- **sort_keys**: Sorts the keys of the json
+  will include the ``title`` property and all properties starting with
+  ``mb``. You can add the ``-i`` option multiple times to the command
+  line.
 
-.. _json: https://docs.python.org/2/library/json.html#basic-usage
+* ``--library`` or ``-l``: Show data from the library database instead of the
+  files' tags.
 
-Using
------
+* ``--output`` or ``-o``: Path for an output file. If not informed, will print
+  the data in the console.
 
-Enable the ``export`` plugin (see :ref:`using-plugins` for help) and then add a
-``export`` section to your :doc:`configuration file </reference/config>`
+* ``--append``: Appends the data to the file instead of writing.
 
-To use, you can enter a :doc:`query </reference/query>` to get the data from
-your library::
+Configuration
+-------------
 
-    $ beet export beatles
+To configure the plugin, make a ``export:`` section in your configuration
+file. Under the ``json`` key, these options are available:
 
-If you just want to see specific properties you can use the
-``--include-keys`` option to filter them. The argument is a
-comma-separated list of simple glob patterns where ``*`` matches any
-string. For example::
+- **ensure_ascii**: Escape non-ASCII characters with `\uXXXX` entities.
 
-    $ beet export -i 'title,mb*' beatles
+- **indent**: The number of spaces for indentation.
 
-Will only show the ``title`` property and all properties starting with
-``mb``. You can add the ``-i`` option multiple times to the command
-line.
+- **separators**: A ``[item_separator, dict_separator]`` tuple.
 
-Additional command-line options include:
+- **sort_keys**: Sorts the keys in JSON dictionaries.
 
-* ``--library`` or ``-l``: Show data from the library database instead of the
-  files' tags.
+These options match the options from the `Python json module`_.
 
-* ``--output`` or ``-o``: Path for an output file. If not informed, will print
-  the data in the console.
+.. _Python json module: https://docs.python.org/2/library/json.html#basic-usage
 
-* ``--append``: Appends the data to the file instead of writing.
+The default options look like this::
+
+    export:
+        json:
+            formatting:
+                ensure_ascii: False
+                indent: 4
+                separators: [',' , ': ']
+                sort_keys: true