From 1d79d0701c1b682534d17abbd20d3057fbe70d64 Mon Sep 17 00:00:00 2001 From: Ye Wenbin Date: Thu, 8 Mar 2007 14:13:00 +0000 Subject: Change document about emms-mark-regexp, and add more darcs-hash:20070308141340-94065-2368578753b8b9c1f500d22f5548c8f610cdd53b.gz --- emms.texinfo | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) (limited to 'emms.texinfo') 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 -- cgit v1.2.3