[elpa] externals/emms 779f563 2/5: * emms.info: update

[Yoni Rabkin]

branch: externals/emms
commit 779f563d6b381bcac6ef81cf1d3eb928379dd4f7
Author: Yoni Rabkin <yoni@rabkins.net>
Commit: Yoni Rabkin <yoni@rabkins.net>

    * emms.info: update
---
 emms.info | 178 ++++++++++++++++++++++++++++++++------------------------------
 1 file changed, 93 insertions(+), 85 deletions(-)

diff --git a/emms.info b/emms.info
index 4c46802..32238b4 100644
--- a/emms.info
+++ b/emms.info
@@ -195,8 +195,8 @@ restart Emacs to let the changes have an effect.
 
    Now we will add all our music to a playlist by invoking 'M-x
 emms-add-directory-tree RET ~/Music/ RET'.  We do this because then Emms
-will read the tags of all your music files and caches them (this is also
-required for the Emms browser, *Note The Browser::.)
+will read the tags of all your music files and caches them (the cache is
+also required for the Emms browser, *Note The Browser::.)
 
    To switch to the playlist buffer, invoke 'M-x emms-playlist-mode-go'
 or simply 'M-x emms'.  You may see that some tracks are displayed with
@@ -798,12 +798,18 @@ chapter.
    Fundamentally, info methods are Emacs Lisp functions that are called
 for each track to provide information for that track.  Current info
 methods in Emms are restricted to tracks that are files; they do not
-work with stream URLs (*note Streaming Audio::).  Most of the methods
+work with stream URLs (*note Streaming Audio::).  Some of the methods
 require installation of some additional software that Emms can then call
 to read metadata from disk (*note Metadata Utilities::).  Finally, some
 methods work only with a limited set of media file formats such as Ogg
 or MP3, while some methods support a wide variety of formats.
 
+   If caching is enabled (it is by default) then the metadata for each
+track will be stored in the cache for faster retrieval.  That means if
+you change info method and want updated tracks, you will have to reset
+the cache 'M-x emms-cache-reset' and then repopulate with 'M-x
+emms-add-directory-tree RET ~/Music/ RET' or similar.
+
    Automatic track information retrieval is enabled by default in the
 'emms-all' setup level (*note Setup::).  That setup level configures
 Emms to use 'emms-info-native' and 'emms-info-cueinfo' methods, as they
@@ -3891,36 +3897,38 @@ Variable Index
 [index]
 * Menu:
 
-* emms-history-file:                     Persistent Playlists. (line 14)
-* emms-history-start-playing:            Persistent Playlists. (line 33)
-* emms-info-asynchronously:              Track Information.    (line 93)
-* emms-info-auto-update:                 Track Information.    (line 88)
-* emms-info-functions:                   Track Information.    (line 99)
-* emms-lyrics-coding-system:             Lyrics.               (line 36)
-* emms-lyrics-dir:                       Lyrics.               (line 27)
-* emms-lyrics-display-format:            Lyrics.               (line 32)
-* emms-lyrics-display-on-minibuffer:     Lyrics.               (line 21)
-* emms-lyrics-display-on-modeline:       Lyrics.               (line 24)
-* emms-lyrics-scroll-p:                  Lyrics.               (line 39)
-* emms-lyrics-scroll-timer-interval:     Lyrics.               (line 42)
-* emms-player-finished-hook:             Hooks.                (line 23)
-* emms-player-list:                      User Variables.       (line  8)
-* emms-player-paused-hook:               Hooks.                (line 29)
-* emms-player-started-hook:              Hooks.                (line  9)
-* emms-player-stopped-hook:              Hooks.                (line 11)
-* emms-playlist-cleared-hook:            Hooks.                (line 19)
-* emms-playlist-selection-changed-hook:  Hooks.                (line 17)
-* emms-playlist-source-inserted-hook:    Hooks.                (line 14)
-* emms-repeat-playlist:                  User Variables.       (line 15)
-* emms-show-format:                      User Variables.       (line 11)
-* emms-sort-lessp-function:              User Variables.       (line 21)
-* emms-source-file-default-directory:    Sources.              (line 13)
-* emms-tag-editor-formats:               Editing Tracks.       (line 55)
-* emms-tag-editor-rename-format:         Editing Tracks.       (line 73)
-* emms-tag-editor-tagfile-functions:     Editing Tracks.       (line 63)
-* emms-track-description-function:       User Variables.       (line 19)
-* emms-volume-change-amount:             Volume.               (line  9)
-* emms-volume-mode-timeout:              Volume.               (line 42)
+* emms-history-file:                     Persistent Playlists.
+                                                              (line  14)
+* emms-history-start-playing:            Persistent Playlists.
+                                                              (line  33)
+* emms-info-asynchronously:              Track Information.   (line  99)
+* emms-info-auto-update:                 Track Information.   (line  94)
+* emms-info-functions:                   Track Information.   (line 105)
+* emms-lyrics-coding-system:             Lyrics.              (line  36)
+* emms-lyrics-dir:                       Lyrics.              (line  27)
+* emms-lyrics-display-format:            Lyrics.              (line  32)
+* emms-lyrics-display-on-minibuffer:     Lyrics.              (line  21)
+* emms-lyrics-display-on-modeline:       Lyrics.              (line  24)
+* emms-lyrics-scroll-p:                  Lyrics.              (line  39)
+* emms-lyrics-scroll-timer-interval:     Lyrics.              (line  42)
+* emms-player-finished-hook:             Hooks.               (line  23)
+* emms-player-list:                      User Variables.      (line   8)
+* emms-player-paused-hook:               Hooks.               (line  29)
+* emms-player-started-hook:              Hooks.               (line   9)
+* emms-player-stopped-hook:              Hooks.               (line  11)
+* emms-playlist-cleared-hook:            Hooks.               (line  19)
+* emms-playlist-selection-changed-hook:  Hooks.               (line  17)
+* emms-playlist-source-inserted-hook:    Hooks.               (line  14)
+* emms-repeat-playlist:                  User Variables.      (line  15)
+* emms-show-format:                      User Variables.      (line  11)
+* emms-sort-lessp-function:              User Variables.      (line  21)
+* emms-source-file-default-directory:    Sources.             (line  13)
+* emms-tag-editor-formats:               Editing Tracks.      (line  55)
+* emms-tag-editor-rename-format:         Editing Tracks.      (line  73)
+* emms-tag-editor-tagfile-functions:     Editing Tracks.      (line  63)
+* emms-track-description-function:       User Variables.      (line  19)
+* emms-volume-change-amount:             Volume.              (line   9)
+* emms-volume-mode-timeout:              Volume.              (line  42)
 
 
 File: emms.info,  Node: Keybinding Index,  Prev: Variable Index,  Up: Top
@@ -3987,57 +3995,57 @@ Tag Table:
 Node: Top701
 Node: Introduction4336
 Node: Quickstart Guide5804
-Node: Installation8672
-Node: Compiling Emms9221
-Node: Setup9909
-Node: Configuration10895
-Node: Finding files and speed12370
-Node: Setup Examples13239
-Node: Getting Help15172
-Node: Formats and Freedom15750
-Node: Basic Commands16955
-Node: The Core File20336
-Node: User Variables20770
-Node: Hooks21746
-Node: Core Functions23172
-Node: Sources26172
-Node: Simple Players28305
-Node: Playlists29362
-Node: Track Information30643
-Node: Metadata Utilities35022
-Node: Defining Info Methods39694
-Node: Interactive Playlists41838
-Node: Markable Playlists44880
-Node: Extending Emms47351
-Node: New Player47787
-Node: Simple Player for `play'48176
-Node: More Complex Player49904
-Node: The Browser52911
-Node: Browser Interface53887
-Node: Filtering Tracks56301
-Node: Displaying Covers58079
-Node: Changing Looks60093
-Node: Sorting Playlists63071
-Node: Persistent Playlists64540
-Node: Editing Tracks65699
-Node: Emms Mode Line69373
-Node: Limiting70541
-Node: Music Player Daemon72880
-Node: Lyrics76393
-Node: Volume78441
-Node: Streaming Audio80229
-Ref: Streaming Audio-Footnote-180821
-Node: APE / FLAC Commands81172
-Node: Bookmarks81879
-Node: Managing Playlists82590
-Node: GNU FM83613
-Node: Uploading Track Information84967
-Node: GNU FM Streaming85849
-Node: Copying86349
-Node: The GNU FDL123866
-Node: Concept Index146254
-Node: Function Index151112
-Node: Variable Index166804
-Node: Keybinding Index169147
+Node: Installation8677
+Node: Compiling Emms9226
+Node: Setup9914
+Node: Configuration10900
+Node: Finding files and speed12375
+Node: Setup Examples13244
+Node: Getting Help15177
+Node: Formats and Freedom15755
+Node: Basic Commands16960
+Node: The Core File20341
+Node: User Variables20775
+Node: Hooks21751
+Node: Core Functions23177
+Node: Sources26177
+Node: Simple Players28310
+Node: Playlists29367
+Node: Track Information30648
+Node: Metadata Utilities35358
+Node: Defining Info Methods40030
+Node: Interactive Playlists42174
+Node: Markable Playlists45216
+Node: Extending Emms47687
+Node: New Player48123
+Node: Simple Player for `play'48512
+Node: More Complex Player50240
+Node: The Browser53247
+Node: Browser Interface54223
+Node: Filtering Tracks56637
+Node: Displaying Covers58415
+Node: Changing Looks60429
+Node: Sorting Playlists63407
+Node: Persistent Playlists64876
+Node: Editing Tracks66035
+Node: Emms Mode Line69709
+Node: Limiting70877
+Node: Music Player Daemon73216
+Node: Lyrics76729
+Node: Volume78777
+Node: Streaming Audio80565
+Ref: Streaming Audio-Footnote-181157
+Node: APE / FLAC Commands81508
+Node: Bookmarks82215
+Node: Managing Playlists82926
+Node: GNU FM83949
+Node: Uploading Track Information85303
+Node: GNU FM Streaming86185
+Node: Copying86685
+Node: The GNU FDL124202
+Node: Concept Index146590
+Node: Function Index151448
+Node: Variable Index167140
+Node: Keybinding Index169609
 
 End Tag Table