added documentation for zero subcommand

This commit is contained in:
Josh Brown 2016-12-17 17:17:55 -06:00
parent a5b37d01c9
commit fec7e30fe1

View file

@ -18,6 +18,7 @@ Configuration
Make a ``zero:`` section in your configuration file. You can specify the
fields to nullify and the conditions for nullifying them:
* Set ``auto`` to ``yes`` to null fields automatically on import. Default ``yes``
* Set ``fields`` to a whitespace-separated list of fields to change. You can
get the list of all available fields by running ``beet fields``. In
addition, the ``images`` field allows you to remove any images
@ -42,3 +43,9 @@ If a custom pattern is not defined for a given field, the field will be nulled
unconditionally.
Note that the plugin currently does not zero fields when importing "as-is".
Manually Triggering Zero
------------------------
The ``zero`` command will invoke the zero plugin on items matching a query. Use the
command ``beet zero [QUERY]``