diff --git a/docs/guides/advanced.rst b/docs/guides/advanced.rst
index 119139c50..55bda7aac 100644
--- a/docs/guides/advanced.rst
+++ b/docs/guides/advanced.rst
@@ -117,7 +117,12 @@ using the :ref:`modify-cmd` command::
 
     beet modify context=party artist:'beastie boys'
 
-And then :doc:`query </reference/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.
+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 </reference/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..fcef6d23f 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. The ``-t`` option sets the timid mode which will ask again
+before really moving or copying the files.
 
 .. _update-cmd: