Change document about emms-mark-regexp, and add more

darcs-hash:20070308141340-94065-2368578753b8b9c1f500d22f5548c8f610cdd53b.gz

1 files changed, 20 insertions, 4 deletions

diff --git a/emms.texinfo b/emms.texinfo
index 780a122..29f91e9 100644
--- a/emms.texinfo
+++ b/emms.texinfo
@@ -1038,10 +1038,8 @@ Toggles mark on the current track.
 Unmarks same way as @command{emms-mark-forward} marks.
 @item % m
 @findex emms-mark-regexp
-Marks all tracks in the playlist matching the given regular expression.
-@item % u
-@findex emms-mark-unmark-regexp
-Unmarks same way as @command{emms-mark-regexp} marks.
+Marks all tracks in the playlist matching the given regular
+expression. A prefix argument means to unmark them instead. 
 @end table
 
 When tracks are marked you can operate on them:
@@ -1060,6 +1058,24 @@ Adds the marked tracks to the kill-ring, so that you can @command{yank}
 them into another playlist.
 @end table
 
+emms-mark is also intent to provide a way for user to select tracks
+for other command to operate on them. Currently,
+@file{emms-tag-editor.el} used the emms-mark to edit tags of selected
+tracks. Two function is useful for elisp programer to handle marked
+tracks.
+
+@defun emms-mark-do-with-marked-track
+This function take a function to perform on all marked tracks. A
+optional argument `move-flag' to tell the function to move forward
+line after calling given function. If the given function didn't change
+position, the second argument should set to non-nil.
+@end defun
+
+@defun emms-mark-mapcar-marked-track
+This function is very similar to `emms-mark-do-with-marked-track'
+except it collects result of given function (that's why named with
+`mapcar').
+@end defun
 
 @node Extending Emms
 @chapter Extending Emms