[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/emms f268b28 77/80: Miscellaneous small fixes to manual
From: |
Stefan Monnier |
Subject: |
[elpa] externals/emms f268b28 77/80: Miscellaneous small fixes to manual chapter 13 |
Date: |
Wed, 17 Mar 2021 18:42:34 -0400 (EDT) |
branch: externals/emms
commit f268b28a68de565c1d6447789eb49a1a37aef9bb
Author: Petteri Hintsanen <petterih@iki.fi>
Commit: Petteri Hintsanen <petterih@iki.fi>
Miscellaneous small fixes to manual chapter 13
---
doc/emms.texinfo | 37 ++++++++++++++++++++-----------------
1 file changed, 20 insertions(+), 17 deletions(-)
diff --git a/doc/emms.texinfo b/doc/emms.texinfo
index b23a44f..f5ac7a9 100644
--- a/doc/emms.texinfo
+++ b/doc/emms.texinfo
@@ -893,6 +893,12 @@ 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.
+Automatic track information retrieval is enabled by default in the
+@code{emms-all} setup level (@pxref{Setup}). That setup level
+configures Emms to use @code{emms-info-native} and
+@code{emms-info-cueinfo} methods, as they are the only methods that do
+not rely on additional software.
+
Here is a list of all info methods distributed with Emms and their
software requirements:
@@ -961,11 +967,6 @@ You can also use a combination of format-specific tools if
needed:
In this case both @code{emms-info-mp3info} and
@code{emms-info-ogginfo} will be called for each track.
-Automatic track information retrieval is enabled by default in the
-@code{emms-all} setup level (@pxref{Setup}). That setup uses only
-@code{emms-info-native}, as it is the only method which does not
-require external software.
-
There are a number of user variables which control the behavior of
@code{emms-info}:
@@ -999,12 +1000,12 @@ takes precedence.
@node Metadata Utilities
@section Metadata Utilities
-With the exception of @code{emms-info-native}, Emms info methods
-require external metadata utilities to read metadata from media files.
-If you plan to use a certain info method, make sure you have the
-corresponding utility installed. All of these utilities are free
-software, and most of them are included in free GNU/Linux
-distributions.
+With the exception of @code{emms-info-native} and
+@code{emms-info-cueinfo}, Emms info methods require external metadata
+utilities to read metadata from media files. If you plan to use a
+certain info method, make sure you have the corresponding utility
+installed. All of these utilities are free software, and most of them
+are included in free GNU/Linux distributions.
@subsubheading tinytag
@@ -1048,7 +1049,8 @@ popular audio formats. It is available at
@url{http://taglib.github.io/}. Because TagLib is a C++ library
instead of an executable program, you have to build and install a
small ``shim'' executable @command{emms-print-metadata} around it.
-Emms will then call this executable to read metadata from media files.
+@code{emms-info-libtag} will then call this executable to read
+metadata from media files.
To compile @command{emms-print-metadata} invoke
@@ -1061,12 +1063,13 @@ The resultant binary executable will be installed when
you invoke
@command{make install} as in @xref{Compiling Emms}.
+@noindent
It is of course also possible to install only the
@file{emms-print-metadata} binary where your system can find and
execute it without installing all of Emms via the make command.
Once @command{emms-print-metadata} is available, it is best to
-configure @code{emms-info-exiftool} as the sole info method for Emms,
+configure @code{emms-info-libtag} as the sole info method for Emms,
because competing and overlapping methods can cause confusion. To use
it, add the following into your Emacs initialization file:
@@ -1107,10 +1110,10 @@ add the following into your Emacs initialization file:
@subsubheading ogginfo
@command{ogginfo} is a small utility for extracting information about
-Ogg Vorbis files. It is part of Vorbis Tools source distribution
-available at @url{https://github.com/xiph/vorbis-tools}. The
-corresponding info method is @code{emms-info-ogginfo}. To use it, add
-the following into your Emacs initialization file:
+Ogg Vorbis and Theora files. It is part of Vorbis Tools source
+distribution available at @url{https://github.com/xiph/vorbis-tools}.
+The corresponding info method is @code{emms-info-ogginfo}. To use it,
+add the following into your Emacs initialization file:
@lisp
(require 'emms-info-ogginfo)
- [elpa] externals/emms 75ae932 36/80: Merge branch 'info-native', (continued)
- [elpa] externals/emms 75ae932 36/80: Merge branch 'info-native', Stefan Monnier, 2021/03/17
- [elpa] externals/emms d0c2888 44/80: * emms-cache.el: lexical, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 9c766b6 46/80: * emms-compat.el: lexical, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 80ac539 57/80: * emms-later-do.el: add lexical declaration, Stefan Monnier, 2021/03/17
- [elpa] externals/emms a31d1f8 60/80: * emms-librefm-stream.el: add lexical and fix warnings, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 60c6172 74/80: * emms-browser.el: add-to-list -> cl-pushnew, Stefan Monnier, 2021/03/17
- [elpa] externals/emms e16ac3d 78/80: Set new default info methods in emms-all, Stefan Monnier, 2021/03/17
- [elpa] externals/emms d7110c0 67/80: * emms-player-simple.el: lexical declaration and fix, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 58c949b 69/80: * emms-playing-time.el: add lexical and fix, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 6a5c7b1 73/80: * emms-browser.el: fix unused lexical variables and arguments, Stefan Monnier, 2021/03/17
- [elpa] externals/emms f268b28 77/80: Miscellaneous small fixes to manual chapter 13,
Stefan Monnier <=
- [elpa] externals/emms de0c407 80/80: * emms.info: new info, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 4b97340 06/80: * emms-tag-editor.el: remove hard-coding of program name, Stefan Monnier, 2021/03/17
- [elpa] externals/emms 35d503c 68/80: add lexical declarations, Stefan Monnier, 2021/03/17
- [elpa] externals/emms caa744d 72/80: * emms-player-mplayer.el: lexical declaration, deprecate emms-player-mpv-cmd-prog macro, Stefan Monnier, 2021/03/17
- [elpa] externals/emms e72fb7c 79/80: Merge branch 'info-native', Stefan Monnier, 2021/03/17
- [elpa] externals/emms 50c5f8e 59/80: * emms-librefm-scrobbler.el: add lexical declaration, Stefan Monnier, 2021/03/17
- [elpa] externals/emms a6f8461 76/80: Use two-column tables in manual chapter 13, Stefan Monnier, 2021/03/17