[Emms-patches] darcs patch: added the emms browser to the manual

[yoni-r]

Sun Aug 20 15:47:39 IDT 2006  address@hidden
  * added the emms browser to the manual

New patches:

[added the emms browser to the manual
address@hidden {
hunk ./emms.texinfo 64
-* Track Information::           More narrative track descriptions.
+* Track Information::        More narrative track descriptions.
hunk ./emms.texinfo 68
+* The Browser::         Advanced metadata browsing.
hunk ./emms.texinfo 942
-want to add to your argument. If you want to hear the wav file of
-your favourite artist in the most possible volume use the following
-line:
+want to add to your argument. If you want to hear the wav file of your
+favourite artist in the most possible volume use the following line:
hunk ./emms.texinfo 1016
-track as the simple player do. We wait until the process send the
-output ``@@P 0'' (the signal of mpg321 that the song ended) to the
+track as the simple player do. We wait until the process sends the
+output ``(at-sign)P 0'' (the signal of mpg321 that the song ended) to the
hunk ./emms.texinfo 1022
-  (when (string-match "@@P 0" output)
+  (when (string-match "(at-sign)P 0" output)
hunk ./emms.texinfo 1050
+
address@hidden The Browser
address@hidden The Browser
+
+The Browser allows you to browse the metadata cache and add tracks to
+your playlist. It includes a powerfull interactive mode.
+
+The Browser is defined in @file{emms-browser.el} and is included in
+the @command{emms-all} setup level. For more information about Emms
+setup levels see @xref{Simple Setup}.
+
+You can also manually add the Browser to your Emms setup by loading it
+explicitly with:
+
address@hidden
+(require 'emms-browser)
address@hidden lisp
+
+To be properly useful, you should do M-x
address@hidden to all the files you own at least
+once so that the cache is fully populated.
+
address@hidden
+* Browser Interface::     The interactive browser interface.
+* Filtering Tracks::      Displaying a subset of the tracks.
+* Displaying Covers::     Displaying album covers in the browser interface.
+* Changing Looks::        Changing the tree structure, display format and 
faces.
address@hidden menu
+
address@hidden Browser Interface
address@hidden Browser Interface
+
+The browser interface allows you to display and interact with your
+tracks in many different ways. There are a number of ways to start the
+browser.
+
address@hidden emms-smart-browse
+Display browser and playlist. Toggle between selecting browser,
+playlist or hiding both. Tries to behave sanely if the user has
+manually changed the window configuration.
address@hidden defun
+
address@hidden emms-browse-by-artist
+Display the browser and order the tracks by artist.
address@hidden defun
+
address@hidden emms-browse-by-album
+Display the browser and order the tracks by album.
address@hidden defun
+
address@hidden emms-browse-by-genre
+Display the browser and order the tracks by genre.
address@hidden defun
+
address@hidden emms-browse-by-year
+Display the browser and order the tracks by year.
address@hidden defun
+
+Once the Browser is displayed you can use it to managed your track
+collection and playlists. The Browser is interactive and has its own
+keybindings.
+
address@hidden @kbd
+
address@hidden C-j
address@hidden C-j (emms-browser)
address@hidden emms-browser-add-tracks-and-play
+Add all tracks at point, and play the first added track.
+
address@hidden RET
address@hidden RET (emms-browser)
address@hidden emms-browser-add-tracks
+Add all tracks at point.
+
address@hidden SPC
address@hidden SPC (emms-browser)
address@hidden emms-browser-toggle-subitems
+Show or hide (kill) subitems under the current line.
+
address@hidden 1
address@hidden 1 (emms-browser)
address@hidden emms-browser-collapse-all
+Collapse everything.
+
address@hidden 2
address@hidden 2 (emms-browser)
address@hidden emms-browser-expand-to-level-2
+Expand all top level items one level.
+
address@hidden 3
address@hidden 3 (emms-browser)
address@hidden emms-browser-expand-to-level-3
+Expand all top level items two levels.
+
address@hidden 4
address@hidden 4 (emms-browser)
address@hidden emms-browser-expand-to-level-4
+Expand all top level items three levels.
+
address@hidden C
address@hidden C (emms-browser)
address@hidden emms-browser-clear-playlist
+Clear the playlist.
+
address@hidden E
address@hidden E (emms-browser)
address@hidden emms-browser-expand-all
+Expand everything.
+
address@hidden d
address@hidden d (emms-browser)
address@hidden emms-browser-view-in-dired
+View the current directory in dired.
+
address@hidden q
address@hidden q (emms-browser)
address@hidden emms-browser-bury-buffer
+Bury the browser buffer.
+
address@hidden r
address@hidden r (emms-browser)
address@hidden emms-browser-goto-random
+Jump to a random track.
+
address@hidden /
address@hidden / (emms-browser)
address@hidden emms-isearch-buffer
+Isearch through the buffer.
+
address@hidden <
address@hidden < (emms-browser)
address@hidden emms-browser-previous-filter
+Redisplay with the previous filter.
+
address@hidden >
address@hidden > (emms-browser)
address@hidden emms-browser-next-filter
+Redisplay with the next filter.
+
address@hidden ?
address@hidden ? (emms-browser)
address@hidden describe-mode
+See the Emacs documentation for the function.
+
address@hidden C-/
address@hidden C-/ (emms-browser)
address@hidden emms-playlist-mode-undo
+Undo the previous playlist action.
+
address@hidden <C-return>
address@hidden <C-return> (emms-browser)
address@hidden emms-browser-add-tracks-and-play
+Add all tracks at point, and play the first added track.
+
address@hidden <backtab>
address@hidden <backtab> (emms-browser)
address@hidden emms-browser-prev-non-track
+Jump to the previous non-track element.
+
address@hidden <tab>
address@hidden <tab> (emms-browser)
address@hidden emms-browser-next-non-track
+Jump to the next non-track element.
+
address@hidden s A
address@hidden s A (emms-browser)
address@hidden emms-browser-search-by-album
+Search the collection by album.
+
address@hidden s a
address@hidden s a (emms-browser)
address@hidden emms-browser-search-by-artist
+Search the collection by artist.
+
address@hidden s s
address@hidden s s (emms-browser)
address@hidden emms-browser-search-by-names
+Search the collection by names.
+
address@hidden s t
address@hidden s t (emms-browser)
address@hidden emms-browser-search-by-title
+Search the collection by title.
+
address@hidden b 1
address@hidden b 1 (emms-browser)
address@hidden emms-browse-by-artist
+Browse the collection by artist.
+
address@hidden b 2
address@hidden b 2 (emms-browser)
address@hidden emms-browse-by-album
+Browse the collection by album.
+
address@hidden b 3
address@hidden b 3 (emms-browser)
address@hidden emms-browse-by-genre
+Browse the collection by genre.
+
address@hidden b 4
address@hidden b 4 (emms-browser)
address@hidden emms-browse-by-year
+Browse the collection by year.
+
address@hidden W a p
address@hidden W a p (emms-browser)
address@hidden emms-browser-lookup-album-on-pitchfork
+Lookup the album using Pitchfork.
+
address@hidden W a w
address@hidden W a w (emms-browser)
address@hidden emms-browser-lookup-album-on-wikipedia
+Lookup the album using Wikipedia.
address@hidden table
+
address@hidden Filtering Tracks
address@hidden Filtering Tracks
+
+If you want to display a subset of your collection (such as a
+directory of 80s music, only avi files, etc.) then you can extend the
+Browser by defining ``filters''.
+
+Show everything:
+
address@hidden
+(emms-browser-make-filter "all" 'ignore)
address@hidden lisp
+
+Set "all" as the default filter:
+
address@hidden
+(emms-browser-set-filter (assoc "all" emms-browser-filters))
address@hidden lisp
+
+Show all files (no streamlists, etc):
+
address@hidden
+(emms-browser-make-filter
+ "all-files" (emms-browser-filter-only-type 'file))
address@hidden lisp
+
+Show only tracks in one folder:
+
address@hidden
+(emms-browser-make-filter
+ "80s" (emms-browser-filter-only-dir "~/Mp3s/80s"))
address@hidden lisp
+
+Show all tracks played in the last month:
+
address@hidden
+(emms-browser-make-filter
+ "last-month" (emms-browser-filter-only-recent 30))
address@hidden lisp
+
+After executing the above commands, you can use M-x
+emms-browser-show-all, emms-browser-show-80s, etc to toggle between
+different collections. Alternatively you can use '<' and '>' to cycle
+through the available filters.
+
+The second argument to make-filter is a function which returns t if a
+single track should be filtered. You can write your own filter
+functions to check the type of a file, etc.
+
+Show only tracks not played in the last year:
+
address@hidden
+(emms-browser-make-filter "not-played"
+ (lambda (track)
+  (not (funcall (emms-browser-filter-only-recent 365) track))))
address@hidden lisp
+
+Show all files that are not in the pending directory:
+
address@hidden
+(emms-browser-make-filter
+ "all"
+ (lambda (track)
+   (or
+    (funcall (emms-browser-filter-only-type 'file) track)
+    (not (funcall
+          (emms-browser-filter-only-dir "~/Media/pending") track)))))
address@hidden lisp
+
address@hidden Displaying Covers
address@hidden Displaying Covers
+
+The browser will attempt to display cover images if they're
+available. By default it looks for images cover_small.jpg,
+cover_med.jpg, etc. Customize @var{emms-browser-covers} to use your
+own covers. Note that you'll probably want to resize your existing
+covers to particular sizes. Suggested sizes are 100x100 for small, and
+200x200 for medium.
+
+Also, Emacs by default will jump around a lot when scrolling a buffer
+with images. In order to prevent that, you can set
address@hidden and @var{scroll-down-aggressively} to the
+number ``0.0''.
+
+To show a 'no cover' image for albums which don't have a cover, add
+the following code to your .emacs:
+
address@hidden
+(setq emms-browser-default-covers
+  (list "/path/to/cover_small.jpg" nil nil)
address@hidden lisp
+
+The medium and large images can be set as well.
+
+You can download an example @uref{http://repose.cx/cover_small.jpg,
+`no cover' image}.
+
address@hidden Changing Looks
address@hidden Changing Looks
+
+The Browser's look can be customised. You can change the way the tree
+structure looks, the display format and display faces.
+
address@hidden Changing Tree Structure
+
+You can change the way the tree is displayed by modifying the function
address@hidden
+
+The following code displays artist->track instead of
+artist->album->track when you switch to the 'singles' filter:
+
address@hidden
+(defadvice emms-browser-next-mapping-type
+                                (after no-album (current-mapping))
+  (when (eq ad-return-value 'info-album)
+    (setq ad-return-value 'info-title)))
address@hidden lisp
+
address@hidden
+(defun toggle-album-display ()
+  (if (string= emms-browser-current-filter-name "singles")
+      (ad-activate 'emms-browser-next-mapping-type)
+    (ad-deactivate 'emms-browser-next-mapping-type)))
+
+(add-hook 'emms-browser-filter-changed-hook 'toggle-album-display)
address@hidden lisp
+
address@hidden Changing Display Format
+
+Format strings govern the way items are displayed in the browser and
+playlist. You can customize these if you wish.
+
address@hidden controls the format to use when no
+other format has been explicitly defined. By default, only track and
+albums deviate from the default.
+
+To customise the format of a particular type, find the name of the
+field you want to use (eg `info-artist', `info-title', etc), and
+insert that into emms-browser-<type>-format or
+emms-browser-playlist-<type>-format. For example, if you wanted to
+remove track numbers from tracks in both the browser and playlist, you
+could do:
+
address@hidden
+(defvar emms-browser-info-title-format "%i%n")
+(defvar emms-browser-playlist-info-title-format
+  emms-browser-info-title-format)
address@hidden lisp
+
+The format specifiers available include:
+
address@hidden @w
address@hidden
+%i    indent relative to the current level
address@hidden
+%n    the value of the item - eg -info-artist might be ``pink floyd''
address@hidden
+%y    the album year
address@hidden
+%A    the album name
address@hidden
+%a    the artist name of the track
address@hidden
+%t    the title of the track
address@hidden
+%T    the track number
address@hidden
+%cS   a small album cover
address@hidden
+%cM   a medium album cover
address@hidden
+%cL   a big album cover
address@hidden itemize
+
+Note that if you use track-related items like %t, it will take the
+data from the first track.
+
address@hidden Changing Display Faces
+
+The faces used to display the various fields are also customizable.
+They are in the format emms-browser-<type>-face, where type is one of
+"year/genre", "artist", "album" or "track". Note that faces lack the
+initial "info-" part. For example, to change the artist face, type M-x
address@hidden @command{emms-browser-artist-face}.
}

Context:

[browser: move from emms-devel to emms-all
Damien Elmes <address@hidden>**20060819175220] 
[emms-player-mpd: Get rid of error messages when closing the MusicPD process 
after playing the last track in the playlist.
Michael Olson <address@hidden>**20060818050516] 
[emms-score.el: Make use of `emms-player-next-function'.
address@hidden 
[browser: only display '. ' if there's a valid track number
Damien Elmes <address@hidden>**20060817160007] 
[browser: add documentation for a bunch of features
Damien Elmes <address@hidden>**20060817154518] 
[emms.el: Provide and use `emms-player-next-function'.
address@hidden 
[browser: add last-played support
Damien Elmes <address@hidden>**20060817144049
 You can now define filters to display only tracks played in the last
 week, month, etc.
] 
[The coding system of choice is utf-8, not legacy-1
address@hidden 
[AUTHORS: Removed zeus, he said he never did anything big to emms, only
address@hidden
 mp3player, and that code is long gone.
] 
[emms-info-ogginfo.el: Add check for retrieving ogginfo.
address@hidden 
[added emms-with-excluded-directories to emms-source-file
address@hidden 
[emms-player-mpd: Really kill the client process, as documented, instead of 
waiting for it to time out.
Michael Olson <address@hidden>**20060811185849] 
[emms-player-mpd: Make supported formats regexp customizable.
Michael Olson <address@hidden>**20060811184859] 
[emms-playing-time: Don't require emms-info-mp3info, since none of its 
functions are used directly.
Michael Olson <address@hidden>**20060806022659] 
[emms-player-mpd: Emacs21 fix.
Michael Olson <address@hidden>**20060806022640] 
[emms-player-mpd: Use better logic for last patch.
Michael Olson <address@hidden>**20060804185308] 
[emms-player-mpd: Correctly fetch track data when using remote MusicPD server.
Michael Olson <address@hidden>**20060804183813] 
[Set correct SEPARATORS parameter for split-string.
address@hidden 
[emms-player-mpd: Use better algorithm to detect whether the user has requested 
a stop or whether we have run out of tracks.  Thanks to dds for the report.
Michael Olson <address@hidden>**20060803030044] 
[emms-cache: Replace use of 'utf-8 with emms-cache-file-coding-system.
Michael Olson <address@hidden>**20060802035000] 
[emms-cache: Change default coding system to utf-8.  Fix byte-compilation 
warning.
Michael Olson <address@hidden>**20060801024119] 
[emms-info-mp3info.el: New function, emms-iconv, for converting string
address@hidden
 between different coding systems. The conversion is necessary when
 emms-info-mp3info-coding-system is different from
 emms-cache-file-coding-system.
] 
[emms-cache.el: New variable, emms-cache-file-coding-system, which will
address@hidden
 allow user to set cache file's coding system explicitly.
] 
[emms-player-mpd: Add support for updating MusicPD's database and improve 
documentation.
Michael Olson <address@hidden>**20060730223147] 
[emms-streams: Don't prompt for fd.  Determine it automatically instead.
Michael Olson <address@hidden>**20060730220232] 
[emms-player-mpd: Allow a password to be sent to the MusicPD server.
Michael Olson <address@hidden>**20060730215000] 
[emms-info: On second thought, with remote players, info should be fetched even 
when the file does not exist on the local system.  So we should always fetch 
info when file-mtime is nil.
Michael Olson <address@hidden>**20060729022523] 
[emms-info: If the file does not exist, don't update its info and file-mtime.  
This fixes an error.
Michael Olson <address@hidden>**20060727183504] 
[Makefile: Don't split info output
address@hidden 
[browser: add some documentation related to singles and filters
Damien Elmes <address@hidden>**20060726181758] 
[browser: fix a few cover bugs
Damien Elmes <address@hidden>**20060726143832] 
[add more lookup functions, a filter-changed hook, and fix an indent problem
Damien Elmes <address@hidden>**20060719114958] 
[browser: fix keybindings
Damien Elmes <address@hidden>**20060710182403] 
[browser: add next/previous filter support
Damien Elmes <address@hidden>**20060710180451] 
[browser: improve filtering, update docs
Damien Elmes <address@hidden>**20060710172313] 
[mplayer: -playlist must be the last arg when streaming
Damien Elmes <address@hidden>**20060710143807] 
[mplayer: use really-quiet (might help on video files with lots of errors?)
Damien Elmes <address@hidden>**20060710142405] 
[mplayer: use quiet mode (stops skipping when emacs is busy)
Damien Elmes <address@hidden>**20060710141939] 
[resolve bug reported by sebatian about the q key
address@hidden 
[browser: use generated name on top level enteries
Damien Elmes <address@hidden>**20060706112523
 this fixes a bug where 'various' albums end up being classified under
 the first author of the first various album
] 
[playlist: don't assume there's a track at point
Damien Elmes <address@hidden>**20060706095138
 this makes RET on an group heading play the first track instead of
 failing
] 
[browser: don't use text-mode-map as parent
Damien Elmes <address@hidden>**20060706073532] 
[browser: add lookup of artist/album in wikipedia
Damien Elmes <address@hidden>**20060706073102] 
[browser: add filtering support (see comments at top)
Damien Elmes <address@hidden>**20060706063045] 
[browser: lvl is a bad name (fixes a bug)
Damien Elmes <address@hidden>**20060705134200] 
[browser: don't rely on target to determine track properties
Damien Elmes <address@hidden>**20060705133450
 Using 'track means that the format string symbols aren't generated
 properly.
 
 Note that these recent changes means that the browser and the playlist
 share the same face. It's not too hard to change this - what do you
 think? Should the browser and playlist track face be different?
] 
[browser: propertize playlist tracks in formatting code
Damien Elmes <address@hidden>**20060705131640] 
[browser: refactor level handling code
Damien Elmes <address@hidden>**20060705114748
 - remove insert-track-function, it's not needed
 - playlist indentation is now handled the same way as the browser,
   using format strings
 - dynamically bind the relative level to make the above work
 - indent tracks a little more to make them visibly "under" albums
] 
[browser: indent albums, don't propertize indent
Damien Elmes <address@hidden>**20060704153422] 
[browser: make faces dependent on type, not level
Damien Elmes <address@hidden>**20060704140109
 
 also renamed the faces - you'll need to customize them again if you've
 customized them before.
] 
[browser: set missing elements to 'misc' to prevent failure
Damien Elmes <address@hidden>**20060704131400] 
[browser: add no-cover documentation
Damien Elmes <address@hidden>**20060704125634] 
[browser: don't need point-at-bol, code has been refactored
Damien Elmes <address@hidden>**20060704044315] 
[browser: add default covers, fix bug
Damien Elmes <address@hidden>**20060704044020] 
[browser: beginnings of format string support
Damien Elmes <address@hidden>**20060702091318] 
[emms-browser: Use point-at-bol instead of line-beginning-position for XEmacs 
compatibility.
Michael Olson <address@hidden>**20060702033721] 
[cache: set coding cookie in cache file
Damien Elmes <address@hidden>**20060702030320] 
[Fix more XEmacs issues.
Michael Olson <address@hidden>**20060702020302] 
[Allow player to set the exact elapsed time of a track.  emms-player-mpd and 
emms-player-mpg321-remote both need this.
Michael Olson <address@hidden>**20060702012131] 
[Make emms-cache and emms-browser work with XEmacs.
Michael Olson <address@hidden>**20060702001247] 
[browser: bind 'C' to clear the playlist from the browser window.
address@hidden 
[browser: d for dired (missing half)
Damien Elmes <address@hidden>**20060630124050] 
[browser: add 'd' to open dired on the current directory
Damien Elmes <address@hidden>**20060629175424] 
[browser: fix bug with custom cover fetching function
Damien Elmes <address@hidden>**20060629141356] 
[browser: cover display, compilation support,more
Damien Elmes <address@hidden>**20060629132444
 - added optional rendering of cover images in the browser and playlist
   (see http://repose.cx/dump/browser-images.png)
 - display artist name if browsing by album
 - add `emms-browser-get-track-field-function', which allows you to
   customise the way the browser sorts the cache into various albums,
   artists, etc. includes a function (not on by default) which finds
   the artist name by the directory, not tag info - this prevents
   making lots of top level artist entries for artists who only appear
   on a compilation
] 
[emms-browser: add C-j as an alternative to C-RET for console users
address@hidden 
[emms-playlist-mode-window-width defcustom + emms-playlist-mode-center-when-go
address@hidden 
[make M-> act like a normal Emacs buffer for emms-playlist-mode
address@hidden 
[emms-last-played: Count the number of times a track has been played.
address@hidden
 
 By default, EMMS will now store the number of times you play a track.
] 
[emms-cache.el: fix missing paren in emms-cache-sync
address@hidden 
[emms-browser.el: fix bad keybinding for emms-browser-goto-random
address@hidden 
[cache: readability fix
Damien Elmes <address@hidden>**20060625110138] 
[cache: rename function, remove obsolete one, only mark dirty if necessary
Damien Elmes <address@hidden>**20060625105130] 
[emms-cache.el: Move the pruning code inside emms-cache-refresh.
address@hidden 
[emms-browser.el: emms-browser-goto-random moves the point to a random line in 
the browser.
address@hidden 
[browser: another read-only bug
Damien Elmes <address@hidden>**20060623171252] 
[browser: fix bug with read-only buffer
Damien Elmes <address@hidden>**20060623150933] 
[browser: more search stuff
Damien Elmes <address@hidden>**20060623150406
 - fix bug where we clobber emms-browser-buffer
 - clear search on new search
 - add new keybindings - 's a', 's s', etc. to search for different fields.
] 
[browser: preliminary browsing support
Damien Elmes <address@hidden>**20060623142837] 
[README: added a note about compiling emms-print-metadata, since it apparently 
wasn't obvious...
address@hidden 
[browser: use the filename if no useful metadata is available
Damien Elmes <address@hidden>**20060622112720] 
[browser: uniquify track names, mpg321-remote: restart dead process
Damien Elmes <address@hidden>**20060622111421] 
[cache: add a routine to refresh metadata info
Damien Elmes <address@hidden>**20060622114528] 
[function name change + testing emms-patches mailing-list
address@hidden 
[README: fix a small typo
Damien Elmes <address@hidden>**20060620091959] 
[README : Advanced configuration : added item about seeking.
address@hidden 
[emms-player-mplayer.el: Enable mplayer's slave mode for seek support by
address@hidden
 default.
] 
[AUTHORS: Update William's info.
address@hidden 
[browser: bugfixes, sort/display by year
Damien Elmes <address@hidden>**20060618122507
 - fix a bug with add-and-play on a single file
 - display album year if available
 - sort albums first by year
 - add c-1, c-2 etc keybindings to quickly browse by artist, album,
   etc. (conflicts with standard keybindings - assumption is that
   digit-argument is probably not very useful in the browser mode)
] 
[define-emms-simple-player: Check for existence of the player executable.
address@hidden 
[emms-player-mpd: Make the playable-p function return nil if we cannot start a 
connection to mpd.
Michael Olson <address@hidden>**20060616233847] 
[Rename `emms-score-show' to `emms-score-show-playing'. Add
address@hidden
 `emms-score-show-file-on-line'.
] 
[browser: put track number first (better for compilation albums)
Damien Elmes <address@hidden>**20060616153258] 
[browser: fix centering when adding new tracks to the playlist
Damien Elmes <address@hidden>**20060616132746] 
[browser: remember position when hitting 1,2,3 etc
Damien Elmes <address@hidden>**20060616131926] 
[browser: collapse before expanding (expand-to-level-2, etc)
Damien Elmes <address@hidden>**20060616110612] 
[browser: fix sorting on tracks without a track number
Damien Elmes <address@hidden>**20060616110222] 
[mpg321-remote: fix race condition
Damien Elmes <address@hidden>**20060616103159] 
[mpg321-remote: fix bug related to the player stopping
Damien Elmes <address@hidden>**20060616011318] 
[Add Adam Sjoegren (copyright got assigned)
address@hidden 
[mpg321-remote: defvar mask-stop-message
Damien Elmes <address@hidden>**20060615094217] 
[add player-mpg321-remote
Damien Elmes <address@hidden>**20060615063027
 - allows seeking in files
 - handles files with errors in them (the mpg321 simple version skips
   over the files)
] 
[browser: fix for the tracknumber fix patch
Damien Elmes <address@hidden>**20060615051156] 
[browser: handle nil track numbers
Damien Elmes <address@hidden>**20060615023650] 
[playlist: enable undo, add extra undo binding
Damien Elmes <address@hidden>**20060615022826] 
[browser: require emms-playlist-sort
Damien Elmes <address@hidden>**20060615015543] 
[playlist-mode: add 'C' to clear playlist
Damien Elmes <address@hidden>**20060615013417] 
[info: display progress when adding async
Damien Elmes <address@hidden>**20060615012854] 
[browser: make defcustom lines user variables
Damien Elmes <address@hidden>**20060615013606] 
[browser: expand/collapse levels, tab through entries
Damien Elmes <address@hidden>**20060614180725] 
[browser: refactor data format, bugfixes; emms: add emms-track-p
Damien Elmes <address@hidden>**20060614160048
 
 Subitems are now stored in a tree of "bdata" objects, which is
 generated when initially displaying the buffer. This makes rendering
 simpler and also fixes some bugs where tracks were not being sorted
 correctly in the browser and/or the playlist.
 
 Adding items to the playlist now inserts 'group' names when you add a
 whole album, artist, etc at a time. These names will be thrown away if
 you run emms-shuffle. The sorting routines will correctly sort the
 buffer, throwing away the group tags, but then throw an error because
 the buffer is not the size they expected it to be. Other playlist
 manipulation routines like next/previous should skip over the group
 names - if they don't, it's a bug in the playlist code.
 
 An example of the new interface is at:
 http://repose.cx/dump/emms-browser.png
] 
[emms-lyrics.el: Fix file-exists-p error when finding lyrics file for
address@hidden
 streams. At present, will just take care of tracks with 'file type.
] 
[debian: add changelog for 2.0-2
address@hidden 
[debian: Install info file as well
address@hidden 
[added the section "Finding files and speed" to the manual
address@hidden 
[fix bug in emms-playlist-mode-center-current
address@hidden 
[browser: sorting, bugfixes
Damien Elmes <address@hidden>**20060612051800
 - add sorting for subitems (albums, tracks, etc)
 - make isearching expand the current entry automatically
 - rename subitems-exist to subitems-visible (clearer)
] 
[removed superfluous comment (actually testing darcs send)
address@hidden 
[updated manual about emms-foobar-file prefix toggling
address@hidden 
[emms-cache: add pruning support, make save/load interactive
Damien Elmes <address@hidden>**20060611095400] 
[Use better exclude regexp, so that people can load music files with '#' in the 
middle of the name.
Michael Olson <address@hidden>**20060610230507] 
[emms-info: Never return 0 for info-mtime, since emms-time-less-p does not like 
this.  Use nil instead.
Michael Olson <address@hidden>**20060610230409] 
[Add mpd volume settings to custom
Martin Schoenmakers <address@hidden>**20060609231150
 
 Small patchlet so mpd users can use custom to change the volume setting
 backend to use the appropriate volume functions.
] 
[browse subcategories (eg artist->album->title)
Damien Elmes <address@hidden>**20060609185950
 - subcategories can now be expanded and contracted, and added to
   playlist
 - see the new keybindings at the top of the file
 - add new faces for the various sublevels (only the dark background
   colours are useful at the moment - any light background users want
   to fix that?)
 - fix a bug in emms-smart-browse with (recenter)
] 
[emms-player-mpd: Add functionality to dump MusicPD data into the EMMS cache.  
This allows for easy integration with emms-browser.el.
Michael Olson <address@hidden>**20060609043831] 
[emms-player-mpd: Rename volume functions to better match the namespace created 
by emms-volume.el.
Michael Olson <address@hidden>**20060609043643] 
[emms-player-mpd: Fix minor bug when importing the current MusicPD playlist 
into EMMS.
Michael Olson <address@hidden>**20060609043538] 
[emms-setup: Get rid of pointless compiler warning.
Michael Olson <address@hidden>**20060609042002] 
[update emms-cache.el commentary
Damien Elmes <address@hidden>**20060609064935] 
[emms-cache: Small compiler fix.
Michael Olson <address@hidden>**20060609041606] 
[emms-cache: Add standard enable/disable/toggle interface and do a docfix for 
emms-cache-set-function.
Michael Olson <address@hidden>**20060609040108] 
[Standardize copyright notices.  Add COPYING file.  Mention license in README.
Michael Olson <address@hidden>**20060608194123] 
[Fix compiler warnings in emms-cache.el.
Michael Olson <address@hidden>**20060608184612] 
[emms-metaplaylist-mode: Fix bug introduced by the recent emms-playlist-mode 
overhaul.  Add faces for light backgrounds.
Michael Olson <address@hidden>**20060608143846] 
[NEWS is new
address@hidden 
[refactor browser mode creation code
Damien Elmes <address@hidden>**20060608123618
 - make the rendering function (browse-by-artist, etc) responsible for
   the mode name
 - fix a bug where the wrong buffer is used
] 
[browser sorting, and bug fixes
Damien Elmes <address@hidden>**20060608105253
 - sort tracks when they're added to the playlist
 - fix a bug where we didn't uniquify the buffer
 - distinguish between files and urls
 - modify emms-playlist-sort to accept an optional region
] 
[update modeline when changing browsing method
Damien Elmes <address@hidden>**20060608094037] 
[avoid rebuilding the browser window each time
Damien Elmes <address@hidden>**20060608092623] 
[small typo fix
Damien Elmes <address@hidden>**20060608032546] 
[fix RET on trailing \n
Damien Elmes <address@hidden>**20060608090703
 \n isn't propertized which means hitting RET on a playlist or browser
 entry fails. this patch moves the point before trying to read the
 properties.
] 
[add a metadata browser - emms-browser.el
Damien Elmes <address@hidden>**20060608084400
 * preliminary work on a metadata browser - still alpha, but it's
   useable for me
 * also updated my email address in emms-cache.el (whoops)
] 
[emms-playlist-mode: Facify tracks on startup.
address@hidden 
[emms.el: Change directory to / before starting the player.
address@hidden 
[emms-playlist-mode: When making new overlays, do not allow the rear to 
advance.  This prevents some display issues.  If we really need to modify the 
text there, we should be using (insert-before-markers).
Michael Olson <address@hidden>**20060607215212] 
[Make emms-property-region bulletproof.
Michael Olson <address@hidden>**20060607215113] 
[Fix typo in emms-property-region
address@hidden 
[emms.el, simplified emms-property-region considerably.
address@hidden 
[Very basic support for recording the time you last played a track.
address@hidden
 
 * emms-last-played.el: New file.
   Nothing fancy right now, more to come soon.
 * emms-setup.el: emms-devel now requires and setups emms-last-played.
] 
[Mark the cache as dirty for each modification.
address@hidden 
[fix damien elmes's email address
Damien Elmes <address@hidden>**20060607154000] 
[emms.el: The currently playing marker now should stay where it is, even for 
yanks
address@hidden 
[emms-playlist-mode: Stop overlay from being attached to text inserted before it
address@hidden 
[emms sources now switch add/play behavior when a prefix argument is supplied.
address@hidden 
[Add autoloads to emms-setup.el
address@hidden 
[Typo, defvar => defcustom for emms-cache-set-function
address@hidden 
[Cleaned up the cached code in emms.el a bit
address@hidden 
[refactor caching code into emms-cache.el
Damien Elmes <address@hidden>**20060607125345
 * caching support is now provided via two function vars in emms.el,
   emms-cache-get-function and emms-cache-set-function
 * (emms-standard) or above will enable caching support
 * you'll need to remove .emms-cache or s/emms-info-cache/emms-cache-db/
] 
[emms-info: Fix bug that occurs after clearing the current playlist and trying 
to re-add songs to it.
Michael Olson <address@hidden>**20060606144439] 
[emms-playlist-mode doesn't need overlay compatibility anymore
address@hidden 
[emms-playlist-mode.el - now with less overlay!
address@hidden 
[AUTHORS: fixed Lucas' e-mail address
address@hidden 
[info-cache-dirty/coding
Damien Elmes <address@hidden>**20060605163339
 
 * mark the info cache as dirty when it's modified, so we don't have to
   write it out all the time
 * save the cache as mule-utf-8 - comments? i'm not sure if this is
   correct
] 
[AUTHORS: Damien Elmes address updated
address@hidden 
[emms-info caching (thanks to Damien Elmes)
address@hidden 
[Sort file names from `emms-source-file-directory-tree-function'.
address@hidden 
[Add some sources for inserting playlists without inserting their contents, and 
likewise for directories of playlist files.  Exclude some files and directories 
from being added when walking directories.
Michael Olson <address@hidden>**20060604195602] 
[emms-player-mpd: Differentiate between files and URLs when it makes sense to 
do so.
Michael Olson <address@hidden>**20060604195449] 
[Miscellaneous minor cleanups.
Michael Olson <address@hidden>**20060604195311] 
[Make sure we never have an empty track description when inserting a song into 
a playlist buffer.
Michael Olson <address@hidden>**20060604194940] 
[Remove debian-extras package as requested by ftpmasters (debian)
address@hidden 
[Put volume options in their own customize group.
Martin Schoenmakers <address@hidden>**20060601193853
 
 Added a separate emms-volume group for customize and put things there instead
 of in the main thing.
] 
[Make handling of multiple playlist buffers less error-prone.
Michael Olson <address@hidden>**20060531203810] 
[emms-volume.el: Cosmetic stuff, defvar -> defcustom
address@hidden 
[emms-volume.el: Minor cosmetic cleanup
address@hidden 
[emms-volme.el: Add some requires.
address@hidden 
[emms-volume-amixer.el: Provide a way to set the control for amixer
address@hidden 
[AUTHORS: Add Martin Schoenmakers. Welcome! :-)
address@hidden 
[Add emms-volume and emms-volume-amixer.
Martin Schoenmakers <address@hidden>**20060530223500
 
 New files: emms-volume.el provides some general volume changing things,
 including a minor mode to more easily change volume when not in the
 EMMS buffer. emms-volume-amixer.el is a backend using amixer.
 
] 
[emms-streams: Re-add space after prompt and use completion for type.
Michael Olson <address@hidden>**20060530190620] 
[emms-streams: When the user wants emms-streams to play the selected stream 
instead of add it, create our own playlist buffer.  When quitting, if we own 
the current playlist buffer, kill it.
Michael Olson <address@hidden>**20060530144243] 
[allow nonzero ogginfo exit plus some reindenting
Martin Schoenmakers <address@hidden>**20060530130411
 
 When ogginfo gave a nonzero value on exit, any valid data would get tossed
 if there was any. This prevented emms from showing info for files that are
 tagged but a bit odd.
 
 Also reindented emms-info-ogginfo accordingly, which incidentally removed
 some tabs in favour of spaces.
 
] 
[emms-streams: Re-implement yank and kill so that they do the right thing with 
emms-stream-list.
Michael Olson <address@hidden>**20060530045429] 
[emms-streams: Implement kill and yank.
Michael Olson <address@hidden>**20060530040114] 
[emms-streams: Make hitting RET on a URL do the right thing, improve cursor 
movement, and mark the buffer as unmodified after performing a save.
Michael Olson <address@hidden>**20060529030043] 
[emms-player-mpd: Make seek work correctly.
Michael Olson <address@hidden>**20060525033120] 
[emms-player-mpd: Use more robust method of detecting whether we need to 
force-feed MusicPD our playlist.
Michael Olson <address@hidden>**20060525014253] 
[emms-playlist-mode: Make "d" kill the entire line.  This seems to be a good 
compromise of those who use C-k and those who want more standard object-killing 
behavior.
foo**20060524200008] 
[emms-player-mpd: When showing the currently-playing song, prepend the name of 
the radio station, if it exists.
foo**20060524195911] 
[emms-player-mpd: Fix bug that caused unconditional reloading of the entire 
MusicPD playlist whenever the track was changed manually.
Michael Olson <address@hidden>**20060524061655] 
[emms-player-mpd: Overhaul for streamlist support, and fix a few miscellaneous 
issues.
Michael Olson <address@hidden>**20060524055707] 
[emms-player-mpd: Add a few checks to make sure that the given buffer exists 
before trying to do anything with it.
Michael Olson <address@hidden>**20060517035419] 
[emms-source-playlist: Do not expand names of files in playlists, as this can 
cause problems with emms-player-mpd in some configurations.
Michael Olson <address@hidden>**20060516081257] 
[emms-playlist-mode: Implement the option (disabled by default) of opening a 
new EMMS buffer for a playlist, when hitting RET on one.
Michael Olson <address@hidden>**20060510040730] 
[emms-playlist-mode.el: Don't put a period after the mode map. This hangs 21.4 
on display.
address@hidden 
[TAG 2.0
address@hidden 
Patch bundle hash:
782484defbfa3f5b7faffd0bd29d72bf82e7d4ee