aboutsummaryrefslogtreecommitdiff
path: root/emms.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'emms.texinfo')
-rw-r--r--emms.texinfo75
1 files changed, 27 insertions, 48 deletions
diff --git a/emms.texinfo b/emms.texinfo
index 8b07ec5..1ef3173 100644
--- a/emms.texinfo
+++ b/emms.texinfo
@@ -96,7 +96,7 @@ Installation
Info Tags
* Ogg Info:: Reading ogg info tags
-* MP3 Info:: Reading mp3 info tags
+* mp3 Info:: Reading mp3 info tags
@end detailmenu
Extending Emms
@@ -619,16 +619,15 @@ Sentinel for determining the end of process for the process @var{proc}
and the sentinel string @var{str}.
@end defun
-@c FIXME finish writing this
@node Playlists
@chapter Playlists
@cindex organizing tracks and media
-Emms uses an Emacs buffer to store a list of media tracks to be
-played. We call it a ``playlist buffer'' or an ``Emms playlist
-buffer''. Emms then proceeds to play the media tracks from top to
-bottom until it reaches the end of the playlist buffer.
+Emms uses Emacs buffers to store the media tracks for playing. We call
+one such buffer a ``playlist buffer'' or an ``Emms playlist
+buffer''. Emms then proceeds to play the media tracks in the buffer
+from top to bottom until the end of the playlist.
The name of the playlist buffer is defined in the variable
@var{emms-playlist-buffer-name} and is set to be an invisible Emacs
@@ -674,7 +673,7 @@ Then you register it with emms-info, by adding it to
If you wish to use 'emms-info-mp3info' you will need the mp3info
program which is available at http://www.ibiblio.org/mp3info/.
-Otherwise Emms will display an error when you attempt to access MP3
+Otherwise Emms will display an error when you attempt to access mp3
info.
@lisp
@@ -682,52 +681,32 @@ info.
@end lisp
@noindent
-There are already two predefined methods for retrieving info
+Emms is distributed with two predefined methods for retrieving
+info. These and all other methods for retrieving info from media
+tracks are managed by the `emms-info' feature defined in the file
+@file{emms-info.el}.
@menu
-* Ogg Info:: Reading ogg info tags
-* MP3 Info:: Reading mp3 info tags
+* Ogg Info:: Reading Ogg info tags
+* mp3 Info:: Reading mp3 info tags
@end menu
-@c FIXME: check that these still exist
-@defun emms-info-get-cached track
-Return cached info for the track @var{track}, nil of no cache.
-@end defun
-@defun emms-info-set-cached
-Set cached info for @var{track} to @var{info}
-@end defun
-@defun emms-info-method-for track
-Return an info-method suitable for @var{track}.
-@end defun
-@defun emms-info-get track &optional dont-use-cached
-Return an emms-info structure representing the track @var{track}.
-if @var{dont-USE-CACHED} is non-nil, then always read from the file.
-@end defun
-@defun emms-info-get-multiple callback tracks &optional dont-use-cached
-Asynchronously get all info tags from the tracks in the listlaw
-@var{tracks}. For each file, call @var{callback} with the track and the info
-structure.
-@end defun
-@defun emms-info-set track info
-Set the info of the file @var{track} to the emms-info structure @var{info}.
-@end defun
-@defun emms-info-file-info-song-artist track
-Returns a description of @var{track}, build from it's comments.
-If @var{emms-info-methods-list} indicates how to retrieve special info
-about it, use this. Otherwise returns the name alone.
-@end defun
+There are a number of user variables which control the behaviour of
+`emms-info'.
-@defopt emms-info-methods-list
-List of info-methods. You need to set this!
+@defopt emms-info-auto-update
+Non-nil when Emms should update track information if the file changes.
+This will cause hard drive activity on track loading. If this is too
+annoying for you, set this variable to nil.
@end defopt
-@defopt emms-info-cache
-Boolean value, indicating whether or not to use a cache for
-info-structures.
+@defopt emms-info-asynchronously
+Non-nil when track information should be loaded asynchronously. This
+requires the feature `later-do' which is provided by the file
+@file{later-do.el}, which should come with Emms.
@end defopt
-@defopt emms-info-get-multiple-idletime
-The number of seconds emacs should be idle to get the next info.
-Increase this if emacs becomes unresponsive when building the
-playlist.
+@defopt emms-info-functions
+Functions which add information to tracks. Each is called with a
+track as argument.
@end defopt
@c FIXME: update this to emms-info-ogginfo.el
@@ -758,8 +737,8 @@ Retrieve an emms-info structure as an ogg-comment
@end defun
@c FIXME: update this for the latest version of mp3info
-@node MP3 Info
-@section MP3 Info
+@node mp3 Info
+@section mp3 Info
This code has been adapted from code found in mp3player.el, written by
Jean-Philippe Theberge @email{jphiltheberge@@videotron.ca}, Mario Domgoergen