[emms-help] Re: [patch] small manual update

[leon]

Great! thanks.

Yoni Rabkin Katzenell <address@hidden> writes:

 | The attached patch has been send to forcer.
 | 
 | Tue Dec 20 14:05:03 IST 2005  address@hidden
 |   * update manual to playlist-mode
 | 
 | 
 | New patches:
 | 
 | [update manual for playlist-mode
 | address@hidden {
 | hunk ./emms-playlist-mode.el 83
 | +    (define-key emms-playlist-mode-map (kbd "d") 
'emms-playlist-mode-kill-track)
 | hunk ./emms.texinfo 764
 | address@hidden C-x C-s
 | address@hidden emms-playlist-mode-save-buffer
 | -Save the current playlist buffer to a file.
 | address@hidden C-k
 | address@hidden emms-playlist-mode-kill-track
 | -Remove the track under point from the playlist buffer. Also available
 | -by pressing the @kbd{d} key.
 | address@hidden C-y
 | address@hidden emms-playlist-mode-yank
 | -Yank the last track killed back into the playlist buffer.
 | hunk ./emms.texinfo 777
 | address@hidden q
 | address@hidden bury-buffer
 | -Put the interactive playlist buffer at the end of the list of all
 | -buffers.
 | address@hidden ?
 | address@hidden describe-mode
 | -Describe the mode.
 | hunk ./emms.texinfo 782
 | address@hidden C-n
 | address@hidden emms-playlist-mode-select-next
 | -Go to the next track in the playlist. @kbd{C-p} completes this command
 | -by going to the previous track in the playlist using
 | address@hidden
 | hunk ./emms.texinfo 785
 | address@hidden q
 | address@hidden bury-buffer
 | +Put the interactive playlist buffer at the end of the list of all
 | +buffers.
 | address@hidden C-x C-s
 | address@hidden emms-playlist-mode-save-buffer
 | +Save the current playlist buffer to a file.
 | address@hidden ?
 | address@hidden describe-mode
 | +Describe the mode.
 | hunk ./emms.texinfo 797
 | +We can also edit the playlist using familiar GNU/Emacs commands:
 | +
 | address@hidden @kbd
 | address@hidden C-k
 | address@hidden emms-playlist-mode-kill-track
 | +Remove the track under point from the playlist buffer. Also available
 | +using the @kbd{d} key.
 | address@hidden C-y
 | address@hidden emms-playlist-mode-yank
 | +See the command @command{yank}
 | address@hidden C-w
 | address@hidden emms-playlist-mode-kill
 | +See the command @command{kill-region}
 | address@hidden M-y
 | address@hidden emms-playlist-mode-yank-pop
 | +See the command @command{yank-pop}.
 | address@hidden C-j
 | address@hidden emms-playlist-mode-insert-newline
 | +Insert a newline at point.
 | address@hidden table
 | +
 | +We can use the regular GNU/Emacs killing and yanking commands to move
 | +and copy tracks in between playlist buffers. We can use the same
 | +commands to insert arbitrary text into the playlist buffers together
 | +with the playlist tracks. Text which is not a track is ignored by the
 | +program and can therefore be used to include titles and annotations
 | +within the playlist.
 | +
 | hunk ./emms.texinfo 885
 | -(require 'emms-player-simple) 
 | +(require 'emms-player-simple)
 | hunk ./emms.texinfo 887
 | -(define-emms-simple-player play 
 | -                           '(file) 
 | -                           "\\artist-*.wav$" 
 | +(define-emms-simple-player play
 | +                           '(file)
 | +                           "\\artist-*.wav$"
 | }
 | 
 | Context:
 | 
 | [killing and yanking in the interactive playlist buffer
 | address@hidden 
 | [Killing and yanking
 | address@hidden 
 | [fix manual sectioning
 | address@hidden 
 | [Fix conflicts in emms-playlist-mode.el
 | address@hidden 
 | [Fix emms.texinfo for PDF output (thanks twb)
 | address@hidden 
 | [Added `emms-playlist-mode-go-popup' for popuping emms-playlist as a side
 | address@hidden
 |  window.
 | ] 
 | [emms-info-mp3info.el (emms-info-mp3find-arguments): use info-tracknumber 
instead of info-tracknum, so as to be consistent with ogginfo.
 | Trent Buck <address@hidden>**20051119150805
 |  emms-info.el: Update documentation.
 | ] 
 | [emms-source-file.el: add missing third clause to AUTOLOAD calls.
 | Trent Buck <address@hidden>**20051028142538] 
 | [emms-info-libtag.el: Fix a couple of typos.
 | Trent Buck <address@hidden>**20051119183945] 
 | [Implement an emms-info function using the libtag package.
 | Trent Buck <address@hidden>**20051119181528] 
 | [Finished rewriting manual
 | address@hidden 
 | [More manual work, but still only 71 percent done
 | address@hidden 
 | [Added support for toggling default action in streams
 | address@hidden 
 | [Added a hook for emms-streams
 | address@hidden 
 | [debian/emms.emacs-install: Leave symlinks in bytecode dir for 
find-library/function/variable.
 | Trent Buck <address@hidden>**20051027172739] 
 | [debian/rules: swap binary-indep and binary-arch bodies, since emms is 
packages as source code.
 | Trent Buck <address@hidden>**20051027150418] 
 | [Makefile (ChangeLog): Generate ChangeLog from darcs metadata.
 | Trent Buck <address@hidden>**20051027133919
 |  debian/rules (build-stamp): Have make generate the ChangeLog.
 |  (build-arch): Include ChangeLog and debian/changelog in debian package.
 | ] 
 | [Added simple player "playsound".
 | Trent Buck <address@hidden>**20051023012053] 
 | [Remove TODO from debian/docs.
 | Trent Buck <address@hidden>**20050912133353] 
 | [Don't attempt to dh_installchangelogs ChangeLog in debian/rules.
 | Trent Buck <address@hidden>**20050912125754] 
 | [Add prefix keys support.
 | address@hidden 
 | [manual 71% done
 | address@hidden 
 | [fix emms-info-ogginfo laguange
 | address@hidden 
 | [manual update (68% done)
 | address@hidden 
 | [emms-metaplaylist fix requested by Lukhas
 | address@hidden 
 | [A minor spell correction.
 | address@hidden 
 | [Make emms-mode-line-icon use the good function to get the current track
 | address@hidden 
 | [Rename `emms-playlist-save-active-as-m3u' to 
`emms-playlist-save-current-as-m3u'.
 | address@hidden 
 | [emms-playlist-sort.el: New file containing various playlist sort
 | address@hidden
 |  functions.
 | ] 
 | [emms-setup.el: Added `emms-playlist-sort' to `emms-devel'.
 | address@hidden 
 | [emms-setup.el: Moved `emms-lyrics' and `emms-playing-time' into
 | address@hidden
 |  `emms-all'.
 | ] 
 | [emms-lyrics.el: New function: `emms-lyrics-restore-mode-line'.
 | address@hidden 
 | [emms-playing-time.el: New function: `emms-playing-time-restore-mode-line'.
 | address@hidden 
 | [manual work (57% done)
 | address@hidden 
 | [emms.el: Should initialize `emms-player-paused-p' to nil at start. Or a
 | address@hidden
 |  pause + stop would make `emms-player-paused-p' be wrong.
 | ] 
 | [emms-mode-line.el: Made `emms-mode-line-alter' be compatible with
 | address@hidden
 |  `emms-track-updated-functions'.
 | ] 
 | [emms-mode-line.el: When artist or title info cann't be achieved, show
 | address@hidden
 |  file name without directory.
 | ] 
 | [emms-mode-line: Changed dead `emms-playlist-current-track-changed-hook'
 | address@hidden
 |  to `emms-track-updated-functions'.
 | ] 
 | [emms-playlist-mode-switch-buffer
 | address@hidden 
 | [Yet Another Installment of the manual re-write
 | address@hidden 
 | [emms-setup.el re-write
 | address@hidden 
 | [more manual re-writing
 | address@hidden 
 | [manual work
 | address@hidden 
 | [Another installment of manual changes
 | address@hidden 
 | [some manual fixes (just the start)
 | address@hidden 
 | [Rename emms-default.el to emms-setup.el.
 | address@hidden 
 | [emms.el (emms-playlist-new): Use interactive-p rather than
 | Michael Olson <address@hidden>**20050925165342
 |  called-interactively-p, since the latter is not available in Emacs21.
 | ] 
 | [emms-streams.el: Update `emms-info-file-info-song-artist' so that it
 | Michael Olson <address@hidden>**20050925160336
 |  can deal with the new interface.
 | ] 
 | [emms-playlist-mode.el: 3rd attempt to not clobber
 | Michael Olson <address@hidden>**20050924183844
 |  emms-playlist-buffer-p.
 | ] 
 | [List all the changes needed in the manual
 | address@hidden 
 | [Update tracks with a specific function, and provide 
emms-track-updated-functions
 | address@hidden 
 | [Adding emms-info-ogginfo.el and consiquently modifying emms-default
 | address@hidden 
 | [add emms-metaplaylist-mode.el
 | address@hidden 
 | [rollback patch to fix adding tracks.
 | address@hidden 
 | [emms-playing-time.el: 
 | address@hidden
 |  
 |  1 New functions: `emms-playing-time-enable',
 |  `emms-playing-time-disable', `emms-playing-time-toggle', for handling
 |  hook stuffs. 
 |  
 |  2 Removed `emms-playing-time-display-p' where unnecessary now. 
 |  
 |  3 Updated commentary and author name. :-)
 | ] 
 | [eemms-lyrics.el:
 | address@hidden
 |  
 |  1 New functions: `emms-lyrics-enable', `emms-lyrics-disable',
 |  `emms-lyrics-toggle', for handling hook stuffs.
 |  
 |  2 Removed `emms-lyrics-display-p' where unnecessary now. 
 |  
 |  3 Updated commentary and author name. :-)
 | ] 
 | [emms-lyrics.el: Fixed a bug in `emms-lyrics-start'.
 | address@hidden 
 | [emms-playing-time.el: Applied standard customization definitions.
 | address@hidden 
 | [emms-info-mp3info: Provide a way to configure the mp3info output coding 
system.
 | address@hidden 
 | [Add documentation of the define symbols for emms-info.el.
 | address@hidden 
 | [remove emms-metaplaylist-mode code from emms-playlist-mode
 | address@hidden 
 | [emms-playing-time: Since 'info-playing-time is an int now, changed
 | address@hidden
 |  `emms-playing-time-display' accordingly.
 | ] 
 | [emms-info-mp3info: Use number for 'info-playing-time.
 | address@hidden 
 | [emms-playing-time.el: Updated the playing-time retrieval method, so as
 | address@hidden
 |  to be able to display playing-time again.
 | ] 
 | [emms-playlist-mode: Make sure emms-playlist-buffer-p is set, since we
 | Michael Olson <address@hidden>**20050922132808
 |  destroy all local variables.
 | ] 
 | [emms-playlist-mode-go: Add buffer-live-p check to circumvent a
 | Michael Olson <address@hidden>**20050922132424
 |  "selecting deleted buffer" error.
 | ] 
 | [emms-player-mplayer.el: Set resume method to nil to just use pause.
 | address@hidden 
 | [fix emms-score.el and emms-info-ogg.el borkage
 | address@hidden 
 | [clean-up emms-info-ogg.el
 | address@hidden 
 | [fix ogg-info
 | address@hidden 
 | [emms-info-mp3info ignores files which are not mp3s
 | address@hidden 
 | [Don't set values mp3info has nothing for
 | address@hidden 
 | [later-do.el: Run timer after function did run to avoid stacking
 | address@hidden 
 | [Inefficiency removed: Update each track only once :P
 | address@hidden 
 | [Ignore read-onliness when updating a track in a playlist buffer
 | address@hidden 
 | [Use time-less-p instead of <= for times
 | address@hidden 
 | [later-do.el emms version
 | address@hidden 
 | [emms-streams shouldn't overwrite `emms-track-initialize-functions'
 | address@hidden 
 | [Typo fix (findo -> find)
 | address@hidden 
 | [emms-info-track-description: Fall back to old behavior if no title and 
artist
 | address@hidden 
 | [Hotfix for emms-streams due to info changed. Please fix later.
 | address@hidden 
 | [Fix emms-default.el, and ignore ogg stuff for now.
 | address@hidden 
 | [Remove emms-info-later-do.el
 | address@hidden 
 | [Fix emms-default.el for new emms-info.el
 | address@hidden 
 | [emms-info-mp3info.el updated for newest emms-info.el
 | address@hidden 
 | [emms-info.el rewrite.
 | address@hidden 
 | [later-do: Work even if the called function errors out.
 | address@hidden 
 | [emms-random: Use `emms-playlist-current-select-random'.
 | address@hidden 
 | [fixing track killing some more
 | address@hidden 
 | [use insert function for yanking
 | address@hidden 
 | [Fixed saving/loading for emms-playlist-mode, also added track updating
 | address@hidden 
 | [Added track updating to emms.
 | address@hidden 
 | [Added emms-playlist-mode-insert-function (fixed sorting and shuffling 
font-lock)
 | address@hidden 
 | [Make emms-playlist-current-clear an interactive function.
 | address@hidden 
 | [Fix bugs in lyrics and mode-line modes when switching songs, fix yanking in 
playlist buffer
 | address@hidden 
 | [Fix track switching error and interactive playlist yanking
 | address@hidden 
 | [Fix track switching error and interactive playlist yanking
 | address@hidden 
 | [Added 'emms-playlist-clear to the default key-map for emms-playlist-mode
 | address@hidden 
 | [Added 'emms-playlist-clear to default playlist keymap
 | address@hidden 
 | [Make `emms-playlist-clear' interactive so that I can map it to a key.
 | address@hidden 
 | [include streaming into emms-default and fix streaming info from within the 
*EMMS Streams* buffer
 | address@hidden 
 | [Make `with-current-emms-playlist' disable read-onlyness.
 | address@hidden 
 | [fix emms-streams.el and emms-player-mplayer.el
 | address@hidden 
 | [comment out emms-info-playlist breakage
 | address@hidden 
 | [emms-playlist-set-playlist-buffer: Ensure the selected buffer is a playlist.
 | address@hidden 
 | [Ignore read-onliness when opening a playlist-mode-buffer.
 | address@hidden 
 | [fixing errors after breakage
 | address@hidden 
 | [Big renaming for current buffer/current playlist distinction.
 | address@hidden
 |  All playlist functions which work on the current playlist now are named
 |  `emms-playlist-current-...'. Other functions named `emms-playlist-...'
 |  work on the current buffer.
 |  This affects the following functions:
 |  
 |  emms-playlist-clear => emms-playlist-current-clear
 |  emms-playlist-selected-track => emms-playlist-current-selected-track
 |  emms-playlist-select-next => emms-playlist-current-select-next
 |  emms-playlist-select-previous => emms-playlist-current-select-previous
 |  emms-playlist-select-random => emms-playlist-current-select-random
 |  emms-playlist-select-first => emms-playlist-current-select-first
 |  emms-playlist-select-last => emms-playlist-current-select-last
 |  emms-playlist-insert-source => emms-playlist-current-insert-source
 | ] 
 | [emms-playlist-new: No, it's a major mode, DONT pass an argument!
 | address@hidden 
 | [Making emms-default now emms-playlist-mode compatible
 | address@hidden 
 | [emms-playlist-new: Pass positive argument to mode function.
 | address@hidden 
 | [Renaming the "playlist" source to "streamlist".
 | address@hidden
 |  
 |  Things might be broken.
 | ] 
 | [clean-up pseudo font-locking
 | address@hidden 
 | ["font-locking" for inserted, unselected tracks
 | address@hidden 
 | [emms.el missing quote fix, emms-playlist-mode.el kill-track fix
 | address@hidden 
 | [Adding a bunch of FIXME tags for the playlist source
 | address@hidden
 |  
 |  When we come to a consensus on the naming, we'll just fix it.
 |  Yrk should have a word about it, stream-playlist sounds good.
 | ] 
 | [Fixing emms-playlist-mode-open-buffer
 | address@hidden 
 | [emms-playlist-select should not switch to the playlist buffer.
 | address@hidden 
 | [Renaming emms-playlist-save to emms-playlist-mode-save-buffer
 | address@hidden 
 | [Added docstrings and clean-up for emms-playlist-mode.el
 | address@hidden 
 | [A kinder, gentler emms-playlist-mode-go
 | address@hidden 
 | [clean-up and emms-playlist-mode-center-current
 | address@hidden 
 | [emms-player-mplayer.el: mplayer also knows rm, rmvb, mp4, ...etc.
 | address@hidden 
 | [multiple fixes to emms-playlist-mode.el
 | address@hidden 
 | [emms-show now knows when nothing is playing.
 | address@hidden 
 | [Inhibit read-only in `emms-playlist-insert-track'
 | address@hidden 
 | [mpd-updates
 | Michael Olson <address@hidden>**20050917021138
 |  emms-player-mpd.el: Add handler for 'resume.
 |  (emms-player-mpd-paused-p): Remove, since we already have
 |  emms-player-paused-p.
 |  (emms-player-mpd-pause): Use toggle instead of either play or
 |  pause.
 | ] 
 | [Making emms-playlist-mode-go respect emms-playlist-buffer
 | address@hidden 
 | [Add `emms-ensure-player-playing-p'
 | address@hidden 
 | [Adding emms-playlist-mode-save and -open
 | address@hidden 
 | [Small fixes
 | address@hidden 
 | [Be able to clear the playlist buffer even if it's killed.
 | address@hidden 
 | [Adding emms-playlist-save-active-as-m3u
 | address@hidden 
 | [Fixing a typo in emms-playlist-save-active
 | address@hidden 
 | [Docstrings for playlist saving functions
 | address@hidden 
 | [Adding m3u playlist format for saving.
 | address@hidden 
 | [Added emms-playlist-mode.el
 | address@hidden 
 | [Shuffle, sort and source-add don't move point anymore.
 | address@hidden 
 | [Provide source insertion
 | address@hidden 
 | [Cleaned up `emms-playlist-save' a bit
 | address@hidden 
 | [Adding emms-playlist-save and -active-save
 | address@hidden
 |  
 |  Opening will come soon.
 |  
 | ] 
 | [Fix emms-playlist-new and make emms-playlist-clear use it.
 | address@hidden 
 | [Removing the old emms-save-playlist
 | address@hidden 
 | [emms-source-add now checks for an as of yet unset marker, too.
 | address@hidden 
 | [Add `emms-playlist-buffer-p'.
 | address@hidden 
 | [emms-lyrics.el: Changed to `emms-player-seeked-hook' to
 | address@hidden
 |  `emms-player-seeked-functions', defined in `emms.el'.
 | ] 
 | [emms-playing-time.el: Changed to `emms-player-seeked-hook' to
 | address@hidden
 |  `emms-player-seeked-functions', defined in `emms.el'.
 | ] 
 | [emms.el: Fix seek bug in `emms-player-seek'.
 | address@hidden 
 | [emms-lyrics.el: Updated commentary and applied standard customization
 | address@hidden
 |  definitions.
 | ] 
 | [ogg-comment.el: Define macros before using them.
 | address@hidden 
 | [Add more mikmod command line args.
 | address@hidden 
 | [Added mikmod support (thanks to Martin Schoenmakers)
 | address@hidden 
 | [emms-playlist-new, emms-playlist-set-playlist-buffer: New commands.
 | address@hidden 
 | [Add `emms-player-simple-regexp'. Also, use it as appropriate.
 | address@hidden 
 | [Fixing typo in file regexps for gstreamer
 | address@hidden 
 | [Updated define-emms-simple-player examples in emms.texinfo
 | address@hidden 
 | [Call widen in shuffle and sort.
 | address@hidden 
 | [Added `emms-playlist-delete-track-function'.
 | address@hidden 
 | [Remove emms-playlist-kill-track.
 | address@hidden 
 | [Fix shuffling in combined sources.
 | address@hidden 
 | [Call `emms-shuffle' to shuffle a source.
 | address@hidden 
 | [Cleanup of the shuffle/sort stuff
 | address@hidden 
 | [emms-shuffle-all: Depend on the value of current, not of 
emms-player-playing-p
 | address@hidden 
 | [Don't make emms-playlist-sort and emms-playlist-shuffle interactive.
 | address@hidden 
 | [Keep the selected song correct for shuffling and sorting
 | address@hidden 
 | [Throw errors for `emms-next' and `emms-previous' at the end/beginning of 
the playlist
 | address@hidden 
 | [Added `emms-random�' (idea by twb)
 | address@hidden 
 | [Add shuffling and sorting.
 | address@hidden 
 | [Lots of condition-case fixes.
 | address@hidden 
 | [First attempt at reading playing time for .ogg
 | address@hidden
 |  
 |  Problem : it's a bit long to read the info now.
 |  We need to optimize that.
 |  
 | ] 
 | [Move gstreamer support into simple player.
 | address@hidden 
 | [Add pause and resume to the simple player.
 | address@hidden 
 | [emms-stream-info.el: Use emms-playlist-selected-track.
 | address@hidden 
 | [Removed old gstreamer wrappers
 | address@hidden 
 | [Added new generic wrapper for gstreamer
 | address@hidden 
 | [Fixed typo in emms.el
 | address@hidden
 |  
 |  Non quoted hook variable
 |  
 | ] 
 | [Rewrote emms-player-gstreamer
 | address@hidden 
 | [Typo: It's emms-playlist-insert-track, not ...-track-insert.
 | address@hidden 
 | [emms-player-mpd doesn't need emms-player-extensions anymore.
 | address@hidden 
 | [FAQ: Typo fix (Thes -> The)
 | address@hidden 
 | [Fixing the extensions problem.
 | address@hidden
 |  
 |  Just removed the requires, and added require mplayer
 |  in emms-default.
 |  
 | ] 
 | [Select a track after adding, too, if none is selected.
 | address@hidden 
 | [Rename emms-mpd.el to emms-player-mpd.el
 | address@hidden 
 | [Rename emms-lyric.el to emms-lyrics.el
 | address@hidden 
 | [Add speex support
 | address@hidden 
 | [Add pause and seek support to emms.el.
 | address@hidden
 |  This factors out the mplayer support into emms-player-mplayer.el,
 |  and removes emms-player-extensions.el.
 | ] 
 | [renaming the provide, Emacs complains otherwise
 | address@hidden 
 | [Fixed emms-mode-line-icon and -playing-time
 | address@hidden 
 | [Rename emms-gstreamer.el to emms-player-gstreamer.el
 | address@hidden 
 | [fixing emms-lyric.el and emms-mode-line.el
 | address@hidden
 |  
 |  I don't have any lyric file, so I can't test it. But 
 |  there are no errors :)
 |  
 |  
 | ] 
 | [emms.el (with-current-emms-playlist): Also recreate when the buffer is
 | address@hidden
 |  dead.
 | ] 
 | [emms.el (emms-next-noerror): Always return non-nil when
 | address@hidden
 |  `emms-playlist-select-next' doesn't error out.
 | ] 
 | [Playlist buffer rewrite
 | address@hidden 
 | [Initial commit (CVS 2005-09-11)
 | address@hidden 
 | Patch bundle hash:
 | a50bb2b4f5c8272433a335a5b05a573332ff9740
 | 
 | -- 
 | "Cut your own wood and it will warm you twice"

-- 
.:*~*:._.:*~*:._.:*~*:._.:*~*:._.:*~*:. 
.     *                               . 
.    /.\        Merry Christmas       . 
.   /..'\                             . 
.   /'.'\                  -- Leon    . 
.  /.''.'\                            . 
.  /.'.'.\                            . 
. /'.''.'.\                           . 
. ^^^[_]^^^                           . 
.:*~*:._.:*~*:._.:*~*:._.:*~*:._.:*~*:.