From fac814421a4df08cd8a5ad3575c46e2445ceffb2 Mon Sep 17 00:00:00 2001 From: Peter Kessen Date: Thu, 4 Feb 2016 17:59:59 +0100 Subject: [PATCH 1/2] Added documentation for changes by #1843 --- docs/guides/advanced.rst | 5 ++++- docs/reference/cli.rst | 5 +++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/guides/advanced.rst b/docs/guides/advanced.rst index 119139c50..d68696906 100644 --- a/docs/guides/advanced.rst +++ b/docs/guides/advanced.rst @@ -117,7 +117,10 @@ using the :ref:`modify-cmd` command:: beet modify context=party artist:'beastie boys' -And then :doc:`query ` your music just as you would with any +By default beets will show you the changes that are about to be applied and ask +if you really want to apply them to all, some or none of the items or albums. + +Then :doc:`query ` your music just as you would with any other field:: beet ls context:mope diff --git a/docs/reference/cli.rst b/docs/reference/cli.rst index cd7872bd4..000fda231 100644 --- a/docs/reference/cli.rst +++ b/docs/reference/cli.rst @@ -250,7 +250,7 @@ move ```` :: - beet move [-cap] [-d DIR] QUERY + beet move [-capt] [-d DIR] QUERY Move or copy items in your library. @@ -262,7 +262,8 @@ them. As with other commands, the ``-a`` option matches albums instead of items. To perform a "dry run", just use the ``-p`` (for "pretend") flag. This will show you a list of files that would be moved but won't actually change anything -on disk. +on disk. In advance the ``-t`` option sets the timid mode which will ask again +before really moving or copying the files. .. _update-cmd: From f6b81c1bdd59adb4c57e1bf7a5ad1afb7012157a Mon Sep 17 00:00:00 2001 From: Peter Kessen Date: Thu, 4 Feb 2016 18:35:01 +0100 Subject: [PATCH 2/2] Made changes suggested by @sampsyo --- docs/guides/advanced.rst | 2 ++ docs/reference/cli.rst | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/guides/advanced.rst b/docs/guides/advanced.rst index d68696906..55bda7aac 100644 --- a/docs/guides/advanced.rst +++ b/docs/guides/advanced.rst @@ -119,6 +119,8 @@ using the :ref:`modify-cmd` command:: By default beets will show you the changes that are about to be applied and ask if you really want to apply them to all, some or none of the items or albums. +You can type y for "yes", n for "no", or s for "select". If you choose the latter, +the command will prompt you for each individual matching item or album. Then :doc:`query ` your music just as you would with any other field:: diff --git a/docs/reference/cli.rst b/docs/reference/cli.rst index 000fda231..fcef6d23f 100644 --- a/docs/reference/cli.rst +++ b/docs/reference/cli.rst @@ -262,7 +262,7 @@ them. As with other commands, the ``-a`` option matches albums instead of items. To perform a "dry run", just use the ``-p`` (for "pretend") flag. This will show you a list of files that would be moved but won't actually change anything -on disk. In advance the ``-t`` option sets the timid mode which will ask again +on disk. The ``-t`` option sets the timid mode which will ask again before really moving or copying the files. .. _update-cmd: