A couple of explanatory comments for #1292

beetsplug/filefilter.py

@@ -50,10 +50,15 @@ class FileFilterPlugin(BeetsPlugin):
             if len(items_to_import) > 0:
                 task.items = items_to_import
             else:
+                # Returning an empty list of tasks from the handler
+                # drops the task from the rest of the importer pipeline.
                 return []
+
         elif isinstance(task, SingletonImportTask):
             if not self.file_filter(task.item['path']):
                 return []
+
+        # If not filtered, return the original task unchanged.
         return [task]
 
     def file_filter(self, full_path):