[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/emms 28acd31 03/80: * doc/emms.texinfo: update quicksta
From: |
Stefan Monnier |
Subject: |
[elpa] externals/emms 28acd31 03/80: * doc/emms.texinfo: update quickstart |
Date: |
Wed, 17 Mar 2021 18:42:18 -0400 (EDT) |
branch: externals/emms
commit 28acd31383471ebd013bd28668e5f62106b184fa
Author: Yoni Rabkin <yoni@rabkins.net>
Commit: Yoni Rabkin <yoni@rabkins.net>
* doc/emms.texinfo: update quickstart
---
doc/emms.texinfo | 39 ++++++++++++++++++++-------------------
1 file changed, 20 insertions(+), 19 deletions(-)
diff --git a/doc/emms.texinfo b/doc/emms.texinfo
index 1480eba..840e38c 100644
--- a/doc/emms.texinfo
+++ b/doc/emms.texinfo
@@ -143,22 +143,22 @@ Emms, an online version of the manual is available at:
The basic functionality of Emms consists of three parts: The core, the
sources, and the players.
-The core resides in @file{emms.el}, and provides a simple playlist and the
-basic functionality to use all the other features of Emms. It provides
-the common user commands and interfaces for other parts. It thinks in
-tracks, where a track is the combination of a type and a name - e.g.
-the track type 'file has a name that is the file name. Other track
-types are possible.
+The core resides in @file{emms.el}, provides a simple playlist, and
+the basic functionality to use all the other features of Emms. It
+provides the common user commands and interfaces for other parts. It
+thinks in tracks, where a track is the combination of a type and a
+name - e.g. the track type 'file has a name that is the file
+name. Other track types are possible.
To get to tracks, the core needs sources. The file @file{emms-source-file.el}
provides simple sources to interact with the file system.
When Emms finally has the sources in the playlist, it needs a player
-to play them. @file{emms-player-simple.el} defines a few useful players, and
-allows you to define your own in a very simple way.
+to play them. @file{emms-player-simple.el} defines a few useful
+players and provides a straightforward way of providing your own.
-The Emms core comes with many additional features to extend its
-functionality.
+The Emms comes with many additional features to extend the
+functionality beyond the core.
The way Emms works is easy to customize with your own code or by using
`M-x customize' or by changing the variables directly.
@@ -172,7 +172,8 @@ This chapter demonstrates how to setup Emms so that you can
start
listening to your music without having to read all of the
documentation first. This is the tl;dr version of the manual.
-The first thing you have to do is telling Emacs where Emms is
+The first thing you do is to load Emms via GNU ELPA. But if you are
+installing manually, then start by telling Emacs where Emms is
located. Let's say you have it in @file{~/elisp/emms/}. So add this
line to your @file{.emacs}:
@@ -185,7 +186,7 @@ installation chapter, @xref{Installation}.
You'll then want to load Emms into Emacs. To achieve this you invoke
the @code{emms-all} setup function by adding the following three lines
-to your @file{.emacs}.
+to your Emacs initialization file.
@lisp
(require 'emms-setup)
@@ -208,16 +209,16 @@ the name of the file) of the music you listen to. Emms
can use a
number of pieces of software and libraries as sources for track info,
see @xref{Track Information} for more.
-The last thing to do is to tell Emms where your music is; the root
+The last thing to do is to tell Emms where is your music; the root
directory of our music collection. Let's say all your music is in
-@file{~/Music} or in subdirectories thereof.
+@file{~/Music} or in subdirectories thereof:
@lisp
(setq emms-source-file-default-directory "~/Music/")
@end lisp
-OK, now we've set up Emms. Reload your @file{.emacs} or restart Emacs to
-let the changes have an effect.
+OK, now we've set up Emms. Reload your Emacs initialization file or
+restart Emacs to let the changes have an effect.
Now we will add all our music to a playlist by invoking @kbd{M-x
emms-add-directory-tree RET ~/Music/ RET}. We do this because then
@@ -226,9 +227,9 @@ is also required for the Emms browser, @xref{The Browser}.)
To switch to the playlist buffer, invoke @kbd{M-x
emms-playlist-mode-go} or simply @kbd{M-x emms}. You may see that some
-tracks are displayed with their file name, but as Emms populates its
-tag cache, track by track, the filenames get replaced with the artist
-and track name of the file's tag.
+tracks are displayed with their file name, but as Emms asynchronously
+populates its tag cache, track by track, the filenames get replaced
+with the artist and track name of the file's tag.
Go ahead and navigate to a track and hit @kbd{RET} on it to start
playback.
- [elpa] externals/emms updated (a2738fe -> de0c407), Stefan Monnier, 2021/03/17
- [elpa] externals/emms e9eda54 01/80: Add native Emacs Lisp info method, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 28acd31 03/80: * doc/emms.texinfo: update quickstart,
Stefan Monnier <=
- [elpa] externals/emms dd301fb 02/80: * doc/developer-release.txt:, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 82a9086 04/80: * doc/emms.texinfo: add setup example, Stefan Monnier, 2021/03/17
- [elpa] externals/emms b7f6e50 08/80: Merge remote-tracking branch 'origin/docs', Stefan Monnier, 2021/03/17
- [elpa] externals/emms a431263 09/80: * doc/emms.texinfo: update copyright years, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 5c3226b 10/80: * doc/developer-release.txt: remove duplicate, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 50bdbcc 12/80: * emms-tag-editor.el: Add emms-tag-editor-pipe, Stefan Monnier, 2021/03/17
- [elpa] externals/emms bc5e516 14/80: Add id3v2 (MP3) support to emms-info-native, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 9c8d961 15/80: Simplify Ogg-related code, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 17e5c6a 05/80: * doc/emms.texinfo: setup examples, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 209077e 07/80: * doc/emms.texinfo: update manual, Stefan Monnier, 2021/03/17