-The cli calls the above functions in "notmuch new" if the
-maildir.synchronize_flags configuration option is enabled.
+The cli calls the above functions if the maildir.synchronize_flags configuration
+option is enabled. Maildir flags are synchronized to tags in "notmuch new", and
+tags are synchronized to maildir flags in "notmuch tag" and "notmuch restore".