Update emms-lastfm-client.el (code + manual).

1 files changed, 43 insertions, 8 deletions

diff --git a/doc/emms.texinfo b/doc/emms.texinfo
index 302572d..e5190b0 100644
--- a/doc/emms.texinfo
+++ b/doc/emms.texinfo
@@ -2291,23 +2291,58 @@ access your Last.fm account.
 @node Last.fm Radio
 @section Last.fm Radio
 
-Currently the only music streaming service provided by
-emms-lastfm-client is Last.fm's "play similar artists". More services
-will be implemented Real Soon Now.
+To show information about the currently playing track invoke:
+@kbd{M-x emms-lastfm-client-show}.
+
+There are three ratings you can submit while streaming audio from
+Last.fm: ``love''-ing a track, skipping to the next song (simply
+skipping also counts as a form of ``scrobbing'') and ``ban''-ing
+(which also skips).
+
+@kbd{M-x emms-lastfm-client-love-track}: ``love'' the currently
+streaming track.
+
+@kbd{M-x emms-lastfm-client-track-advance}: Skip to the next streaming
+track.
+
+@kbd{M-x emms-lastfm-client-ban-track}: ``ban'' the currently
+streaming track.
 
 Note that Last.fm streams cannot be paused or replayed. Doing so may
 cause Last.fm to suspend your account.
 
-To play the Similar-Artists stream invoke @kbd{M-x
-emms-lastfm-client-play-similar-artists}. Then enter the name of the
+There are a number of stations you can tune into:
+
+@kbd{M-x emms-lastfm-client-play-similar-artists}: Play
+Similar-Artists stream. You will be prompted to enter the name of the
 artist. The input will auto-complete from the Emms cache. If an artist
 is not in the Emms cache and has a name with spaces, use @kbd{C-q
 Space} to enter literal spaces.
 
-To show information about the currently playing track invoke @kbd{M-x
-emms-lastfm-client-show}.
+There are personal streams you can tune into:
+
+@kbd{M-x emms-lastfm-client-play-library}: Your Last.fm Library.
+
+@kbd{M-x emms-lastfm-client-play-loved}: Your ``loved'' tracks.
+
+@kbd{M-x emms-lastfm-client-play-neighborhood}: Your ``neighborhood''.
+
+You can use similar commands to tune into other people's streams. For
+each of these commands you will be prompted for the Last.fm username
+of the person whose radio you wish to hear.
+
+@kbd{M-x emms-lastfm-client-play-user-library}: A Last.fm user's
+Library.
+
+@kbd{M-x emms-lastfm-client-play-user-loved}: A Last.fm user's
+``loved'' tracks.
+
+@kbd{M-x emms-lastfm-client-play-user-neighborhood}: A Last.fm user's
+``neighborhood''.
 
-To skip a track invoke @kbd{M-x emms-lastfm-client-track-advance}.
+The submission process isn't instantaneous. A high latency Internet
+connection may produce annoying ``freezes'' while Emacs synchronously
+communicates with the Last.fm servers.
 
 @node Streaming Audio
 @chapter Streaming Audio