From c2159209b01e45095184d31404cb10d10b4bbbc9 Mon Sep 17 00:00:00 2001 From: Yoni Rabkin Date: Thu, 17 Apr 2014 17:21:59 -0400 Subject: * doc/emms.texinfo: Space out nodes. This makes editing a bit easier. --- doc/emms.texinfo | 100 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 96 insertions(+), 4 deletions(-) diff --git a/doc/emms.texinfo b/doc/emms.texinfo index 4c09cac..148f23d 100644 --- a/doc/emms.texinfo +++ b/doc/emms.texinfo @@ -17,7 +17,7 @@ @end direntry @copying - @copyright{} 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 + @copyright{} 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2014 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -160,6 +160,8 @@ allows you to define your own in a very simple way. The way Emms works is easy to customize with your own code or by using `M-x customize'. + + @node Installation @chapter Installation @@ -178,6 +180,8 @@ then in your ~/.emacs, you should do: * Compiling Emms:: Compiling Emms into Byte-Code. @end menu + + @node Compiling Emms @section Compiling Emms @@ -206,6 +210,8 @@ the appropriate permissions to do so on your system). Note that Emms is a light-weight and agile program, you can therefore run Emms just fine without byte compiling it. + + @node Simple Setup @chapter Simple Setup @@ -274,6 +280,8 @@ It is also worth noting that you can write your own Emms setup functions like the above by looking at the existing function definitions in @file{emms-setup.el}. + + @node Configuration @chapter Configuration @@ -318,6 +326,8 @@ Another way to change Emms variables is to use the M-x * Finding files and speed:: Finding files quickly or portably. @end menu + + @node Finding files and speed @section Finding files and speed @@ -340,6 +350,8 @@ have GNU/find installed. The method Emms will use is defined in the customisable variable @var{emms-source-file-directory-tree-function}. + + @node Quickstart Guide @chapter Quickstart Guide @@ -409,6 +421,8 @@ Now you can start exploring EMMS. It's probably best to begin with the basic commands (@pxref{Basic Commands}), the interactive playlists (@pxref{Interactive Playlists}), and the browser (@pxref{The Browser}). + + @node Getting Help @chapter Getting Help @@ -425,6 +439,8 @@ which mirrors this mailing address at gmane.emacs.emms.user. Emms also has a website at @url{http://www.gnu.org/software/emms/}. + + @node Formats and Freedom @chapter Formats and Freedom @@ -452,6 +468,8 @@ once is non-proprietary, is unencumbered by patents and has the source code for a reference implementation freely available. For more information about FLAC, go to @url{http://flac.sourceforge.net/}. + + @node Basic Commands @chapter Basic Commands @@ -546,6 +564,8 @@ non-nil, insert the description into the current buffer instead. This function uses @var{emms-show-format} to format the current track. @end defun + + @node The Core File @chapter The Core File @@ -562,6 +582,8 @@ playing music, generating playlists and defining players. * Core Functions:: Providing the basic functionality of Emms. @end menu + + @node User Variables @section User Variables @@ -591,6 +613,8 @@ A function that compares two tracks, and returns non-nil if the first track should be sorted before the second (see also @code{sort}). @end defopt + + @node Hooks @section Hooks @@ -630,6 +654,8 @@ Hook run when a player is paused or resumed. Use @var{emms-player-paused-p} to find the current state. @end defopt + + @node Core Functions @section Core Functions @@ -728,6 +754,8 @@ Seek ten seconds backward. For more basic commands defined in the core file see @xref{Basic Commands}. + + @node Sources @chapter Sources @@ -793,6 +821,8 @@ files) can play. Search for @var{regexp} and display the results in a locate buffer @end defun + + @node Simple Players @chapter Simple Players @@ -822,6 +852,8 @@ Sentinel for determining the end of process for the process @var{proc} and the sentinel string @var{str}. @end defun + + @node Playlists @chapter Playlists @@ -856,6 +888,8 @@ format is specified by @var{emms-source-playlist-default-format}. The current Emms playlist buffer is stored in the variable @var{emms-playlist-buffer}. + + @node Track Information @chapter Track Information @@ -903,6 +937,8 @@ track as argument. * Defining Info Methods:: Defining new info methods. @end menu + + @node Defining Info Methods @section Defining Info Methods @@ -926,6 +962,8 @@ the right time to provide track info. (add-to-list 'emms-info-functions 'emms-info-ogginfo) @end lisp + + @node Interactive Playlists @chapter Interactive Playlists @@ -1050,6 +1088,8 @@ 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. + + @node Markable Playlists @chapter Markable Playlists @@ -1134,6 +1174,8 @@ except it collects result of given function (that's why named with `mapcar'). @end defun + + @node APE / FLAC Commands @chapter APE / FLAC Commands @@ -1157,6 +1199,8 @@ Play next track from .cue file Play previous track from .cue file @end defun + + @node Bookmarks @chapter Bookmarks @@ -1175,6 +1219,8 @@ respectively. To clear all of the bookmarks for the current track invoke @kbd{M-x emms-bookmarks-clear}. + + @node GNU FM @chapter GNU FM @@ -1207,6 +1253,8 @@ appropriate variables: * GNU FM Streaming:: Streaming music from a GNU FM server. @end menu + + @node Uploading Track Information @section Uploading Track Information @@ -1231,6 +1279,8 @@ will be uploaded to the server when the track's playback ends. You can disable this behavior with @kbd{emms-librefm-scrobbler-disable}. + + @node GNU FM Streaming @section GNU FM Streaming @@ -1248,6 +1298,8 @@ Then invoke @kbd{emms-librefm-stream} and enter the URL of the station you wish to listen to, for example ``librefm://globaltags/Classical''. + + @node Extending Emms @chapter Extending Emms @@ -1264,6 +1316,8 @@ customise it to your needs. * More Complex Player:: Example of a complex player using @command{mpg321}. @end menu + + @node New Player @section New Player @@ -1275,6 +1329,8 @@ start with, but it shouldn't be hard to provide a function for your favourite player. We will start with an easy example that shows how we can use the @command{play} command under Unix to play our WAV files. + + @node Simple Player for `play' @section Simple Player for `play' @@ -1324,6 +1380,8 @@ has to take one song as argument and stop after playing that particular song. For any other concept you will need to customise emms a bit more... + + @node More Complex Player @section More Complex Player @@ -1368,10 +1426,10 @@ with the filename and set a filter. (defun emms-mpg321-remote-start () (unless (get-process ``mpg321-remote'') (setq emms-mpg321-remote-process - (start-process "mpg321-remote-process" - "*mpg321*" "mpg321" "-R" "abc")) + (start-process "mpg321-remote-process" + "*mpg321*" "mpg321" "-R" "abc")) (process-send-string "mpg321-remote-process" - (concat "l " (emms-track-name track))) + (concat "l " (emms-track-name track))) (set-process-filter emms-mpg321-remote-process 'emms-mpg321-remote-filter))) @end lisp @noindent @@ -1412,6 +1470,8 @@ from @file{emms-player-simple.el} Now we have a ready player and we could add commands like @command{emms-mpg321-remote-pause} for example. + + @node The Browser @chapter The Browser @@ -1440,6 +1500,8 @@ once so that the cache is fully populated. * Changing Looks:: Changing the tree structure, display format and faces. @end menu + + @node Browser Interface @section Browser Interface @@ -1626,6 +1688,8 @@ Lookup the album using Pitchfork. Lookup the album using Wikipedia. @end table + + @node Filtering Tracks @section Filtering Tracks @@ -1695,6 +1759,8 @@ Show all files that are not in the pending directory: (emms-browser-filter-only-dir "~/Media/pending") track))))) @end lisp + + @node Displaying Covers @section Displaying Covers @@ -1723,6 +1789,8 @@ The medium and large images can be set as well. You can download an example @uref{http://repose.cx/cover_small.jpg, `no cover' image}. + + @node Changing Looks @section Changing Looks @@ -1811,6 +1879,8 @@ They are in the format emms-browser--face, where type is one of initial "info-" part. For example, to change the artist face, type M-x @command{customize-face} @command{emms-browser-artist-face}. + + @node Sorting Playlists @chapter Sorting Playlists @@ -1849,6 +1919,8 @@ Sort playlist by year in ascending order. Sort playlist by notes in ascending order. @end defun + + @node Persistent Playlists @chapter Persistent Playlists @@ -1891,6 +1963,8 @@ If non-nil emms starts playing the current track after `emms-history-load' was invoked. The default value is nil. @end defopt + + @node Editing Tracks @chapter Editing Tracks @@ -1993,6 +2067,8 @@ Rename the file corresponding to track at point or all marked tracks according to the value of @code{emms-tag-editor-rename-format}. @end defun + + @node Emms Mode Line @chapter Emms Mode Line @@ -2037,6 +2113,8 @@ Display playing time on mode line. Remove playing time from mode line. @end defun + + @node Music Player Daemon @chapter Music Player Daemon @@ -2155,6 +2233,8 @@ To activate this, add the following to your .emacs. (setq emms-volume-change-function 'emms-volume-mpd-change) @end lisp + + @node Lyrics @chapter Lyrics @@ -2239,6 +2319,8 @@ Disable displaying Emms lyrics. Toggle displaying Emms lyrics. @end defun + + @node Volume @chapter Volume @@ -2296,6 +2378,8 @@ by six steps of @code{emms-volume-change-amount}, you would simply type @kbd{C-c + + + + + +}. + + @node Streaming Audio @chapter Streaming Audio @@ -2382,18 +2466,26 @@ bookmark under point. Note that this will only work if the @include gpl.texi @include fdl.texi + + @node Concept Index @unnumbered Concept Index @printindex cp + + @node Function Index @unnumbered Function Index @printindex fn + + @node Variable Index @unnumbered Variable Index @printindex vr + + @node Keybinding Index @unnumbered Keybinding Index @printindex ky -- cgit v1.2.3