From fff50f931cd9d2682834b16b34939e84e350dafb Mon Sep 17 00:00:00 2001 From: yonirabkin Date: Thu, 29 Sep 2005 20:52:00 +0000 Subject: manual work darcs-hash:20050929205222-be80e-df5516a7c609262ca7a0ed4ffc16a39569a6331f.gz --- emms.texinfo | 117 +++++++---------------------------------------------------- 1 file changed, 13 insertions(+), 104 deletions(-) diff --git a/emms.texinfo b/emms.texinfo index 613ab5c..297babc 100644 --- a/emms.texinfo +++ b/emms.texinfo @@ -19,7 +19,7 @@ Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no -Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A +Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". @end quotation @@ -190,15 +190,14 @@ just need the following line, which installs the core of Emms. -Now we need to do some configuration. -@c FIXME: Renaming of emms-default? New user levels? -The Emms module `emms-default' provides the function `emms-setup', -which is a way to quickly configure your Emms. You can add any number -of directories which contain media. The first argument is the -complexity level of the user interface. Here's an example: +Now we need to do some configuration. The Emms module `emms-setup' +provides the function `emms-setup', which is a way to quickly +configure your Emms. You can add any number of directories which +contain media. The first argument is the complexity level of the user +interface. Here's an example: @lisp -(require 'emms-default) +(require 'emms-setup) (emms-setup 'tiny "directory") @end lisp @@ -225,7 +224,7 @@ The (optional) directory is used for @cindex Configuration Example The following code fragment provides a minimal Emms setup without -using the layer of `emms-default'. It can maybe be used to better +using the layer of `emms-setup'. It can maybe be used to better understand the internals of Emms. You can see how Emms needs to know about players (these are defined in `emms-player-simple') and about sources for tracks (trivial file system based sources, such as this @@ -497,8 +496,8 @@ Declare that the current Emms player is finished. This should only be done by the current player itself. @end defun @defun emms-seek seconds -Seek the current player @var{seconds} seconds. This can be a floating -point number for sub-second fractions. It can also be negative to +Seek the current player @var{seconds} seconds. This can be a floating +point number for sub-second fractions. It can also be negative to seek backwards. @end defun @defun emms-seek-forward @@ -749,12 +748,12 @@ return an emms-info structure representing it. @chapter The Playlist Buffer @cindex playlist buffer -@c FIXME: maybe a re-write? +@c FIXME: Completely rewrite the playlist buffer thus introducing the +@c concept of multiple playlists to the people. @menu * Playlist Buffer:: Browsing buffer known by other players @end menu -@c FIXME: update this with the new keymap. @node Playlist Buffer @section Playlist buffer @@ -767,6 +766,7 @@ The playlist-buffer *Playlist* will be created and put into emms-pbi-mode, which give you some usefull keybinings @end table +@c New keymaps all around @table @kbd @item ? @kindex ? (Emms-pbi) @@ -927,97 +927,6 @@ Hook that is called when the face of the current line changes. Hook that is called when the song is manually changed. @end defopt -@c FIXME: what is the fate of these? I'll comment them out for the -@c time being. - -@c @node Playlist Manipulation -@c @section Playlist Manipulation - -@c The file @file{emms-pl-manip} offers various advanced playlist-manipulations functions for -@c Emms. - -@c Basically just load up this file, and check out some of these -@c functions. - -@c @defun vector-sort vec pred &optional beg end -@c Sort a vector @var{vec}, using the predicate @var{pred}, and return the new -@c vector. If @var{beg} and @var{end} are specified, sort only this subrange. - -@c @var{pred} is called with 2 elements and should return true, if the first is -@c less than the other. -@c @end defun -@c @defun emms-pl-manip-sort by pred -@c Sorts the Emms-playlist, by applying @var{by} as a function to each -@c filename in the list, and then comparing the results with @var{pred}. -@c @end defun -@c @defun emms-pl-manip-sort-by-filename - -@c @end defun -@c @defun emms-pl-manip-sort-by-name - -@c @end defun -@c @defun emms-pl-manip-sort-by-info-artist -@c Sort the playlist, using -@c @end defun -@c @defun emms-playlist-reshuffle -@c Reshuffle the playlist. -@c @end defun - -@c @node Scoring -@c @chapter Scoring - -@c Scoring allows you to assign scores to individual files and play media -@c according to your mood. - -@c When you load @file{emms-score}, you are set to a default mood 'emms-default-mood' -@c A mood is a one word string describing how you feel (like "funny", -@c "tired", "aggressive"...) Each mood have is own set of scoring rules. - -@c You can change your mood with M-x @command{emms-score-change-mood} - -@c Every music file start with a default score of 0 the command -@c emms-score-up-current and emms-score-down-current modify the score of -@c the file you are currently listening by 1 In addition, skipping a file -@c (with emms-skip) automatically score the file down. - -@c With scoring on (this mean the variable @var{emms-use-scoring} is t), emms -@c will compare the score of the file with your tolerance to decide if it -@c is played or not. - -@c The default tolerance level is 0 (or the variable -@c @var{emms-score-min-score}). This mean files with a score of 0 or more will -@c be played and files with a score of -1 or less will be skipped. - -@c You can change the tolerance (by 1) with -@c @command{emms-score-lower-tolerance} and @command{emms-score-be-more-tolerant}. - -@c @table @code -@c @findex emms-score -@c @item emms-score -@c Activate scoring -@c @findex emms-score-change-mood -@c @item emms-score-change-mood -@c Change current mood -@c @findex emms-score-up-current -@c @item emms-score-up-current -@c Score up the current track -@c @findex emms-score-down-current -@c @item emms-score-down-current -@c Score down the current track -@c @findex emms-score-up-file-on-line -@c @item emms-score-up-file-on-line -@c Score up file on line -@c @findex emms-score-down-file-on-line -@c @item emms-score-down-file-on-line -@c Score down file on line -@c @findex emms-score-be-more-tolerant -@c @item emms-score-be-more-tolerant -@c Lower minimum score -@c @findex emms-score-lower-tolerance -@c @item emms-score-lower-tolerance -@c Raise minimum score -@c @end table - @node Extending Emms @chapter Extending Emms -- cgit v1.2.3