aboutsummaryrefslogtreecommitdiff
path: root/doc/emms.texinfo
diff options
context:
space:
mode:
authorPetteri Hintsanen <petterih@iki.fi>2021-03-10 22:25:58 +0200
committerPetteri Hintsanen <petterih@iki.fi>2021-03-10 22:47:22 +0200
commita6f8461e1d9c65c8f71cbfbb379111d1a38871c1 (patch)
tree584148db9e031214eeff6c4c862bbb68345ee4e5 /doc/emms.texinfo
parent89ccb7d8ec0d73a0f0a15ac0910f500acf6f9031 (diff)
Use two-column tables in manual chapter 13
Tables look less cluttered than simple lists.
Diffstat (limited to 'doc/emms.texinfo')
-rw-r--r--doc/emms.texinfo153
1 files changed, 75 insertions, 78 deletions
diff --git a/doc/emms.texinfo b/doc/emms.texinfo
index 60b7d48..b23a44f 100644
--- a/doc/emms.texinfo
+++ b/doc/emms.texinfo
@@ -896,51 +896,49 @@ of formats.
Here is a list of all info methods distributed with Emms and their
software requirements:
-@itemize
+@table @code
-@item
-@code{emms-info-native} is a method implemented in Emacs Lisp. This
-is the only method that does not rely on external programs. It
-supports Ogg Vorbis, Opus, FLAC and MP3 files.
+@item emms-info-native
+This method is implemented completely in Emacs Lisp and hence does not
+require any external software. It supports Ogg Vorbis, Opus, FLAC and
+MP3 files.
-@item
-@code{emms-info-tinytag} is a method that uses a small Python library
-@code{tinytag}. This method supports MP3, OGG, OPUS, MP4, M4A,
-FLAC, WMA and WAV formats.
+@item emms-info-tinytag
+This method utilizes a small Python library @code{tinytag}. It
+supports MP3, Ogg Vorbis, Opus, MP4, M4A, FLAC, WMA and WAV formats.
-@item
-@code{emms-info-exiftool} is a method that uses @command{exiftool}
-utility written in Perl. This method supports dozens of media file
-formats.
+@item emms-info-exiftool
+This method calls @command{exiftool} utility written in Perl. It
+supports dozens of media file formats, far too many to list here.
-@item
-@code{emms-info-libtag} is a method that uses a small ``shim''
-executable @command{emms-print-metadata} around TagLib library. It
+@item emms-info-libtag
+This method calls a small ``shim'' executable
+@command{emms-print-metadata} built around TagLib library. It
supports MP3, Ogg Vorbis, Opus, FLAC, MPC, Speex, WavPack, TrueAudio,
WAV, AIFF, MP4 and ASF formats.
-@item
-@code{emms-info-metaflac} is a method that uses @command{metaflac}
-utility. It works only with FLAC files.
+@item emms-info-metaflac
+This method calls @command{metaflac} utility. It works only with FLAC
+files.
-@item
-@code{emms-info-mp3info} is a method that uses @command{mp3info}
-utility. It works only with MP3 files that have older id3v1 tags.
+@item emms-info-mp3info
+This method calls @command{mp3info} utility. It works only with MP3
+files that have older id3v1 tags.
-@item
-@code{emms-info-ogginfo} is a method that uses @command{ogginfo}
-utility. It supports Ogg Vorbis and Theora formats.
+@item emms-info-ogginfo
+This method calls @command{ogginfo} utility. It supports Ogg Vorbis
+and Theora formats.
-@item
-@code{emms-info-opusinfo} is a method that uses @command{opusinfo}
-utility. It works only with Opus files.
+@item emms-info-opusinfo
+This method calls @command{opusinfo} utility. It works only with Opus
+files.
-@item
-@code{emms-info-cueinfo} is a special info method that parses track
-information from an accompanying cue file for FLAC and APE files.
-@xref{APE / FLAC Commands}.
+@item emms-info-cueinfo
+This is a special method that parses track information from an
+accompanying cue file for FLAC and APE files (@pxref{APE / FLAC
+Commands}). It does not require any additional software.
-@end itemize
+@end table
To use any of the methods, add the method to
@code{emms-info-functions} list. For example:
@@ -1143,72 +1141,71 @@ symbols are keys that have an associated value stored in the
@dfn{metadata cache}. While info symbols can have arbitrary names,
the following symbols are recognized by Emms:
-@itemize @minus
+@table @code
+@item info-album
+Album title.
-@item
-@code{info-album}: Album title.
+@item info-albumsort
+Album title for collation.
-@item
-@code{info-albumsort}: Album title for collation.
+@item info-artist
+Artist name.
-@item
-@code{info-artist}: Artist name.
+@item info-artistsort
+Artist name for collation.
-@item
-@code{info-artistsort}: Artist name for collation.
+@item info-albumartist
+Album artist name.
-@item
-@code{info-albumartist}: Album artist name.
+@item info-albumartistsort
+Album artist name for collation.
-@item
-@code{info-albumartistsort}: Album artist name for collation.
+@item info-composer
+Composer name.
-@item
-@code{info-composer}: Composer name.
+@item info-composersort
+Composer name for collation.
-@item
-@code{info-composersort}: Composer name for collation.
+@item info-date
+Release date.
-@item
-@code{info-date}: Release date.
+@item info-originaldate
+Original release date.
-@item
-@code{info-originaldate}: Original release date.
+@item info-performer
+Performer name.
-@item
-@code{info-performer}: Performer name.
+@item info-title
+Track title.
-@item
-@code{info-title}: Track title.
+@item info-titlesort
+Track title for collation.
-@item
-@code{info-titlesort}: Track title for collation.
+@item info-tracknumber
+Track number.
-@item
-@code{info-tracknumber}: Track number.
+@item info-discnumber
+Disc number.
-@item
-@code{info-discnumber}: Disc number.
+@item info-year
+Release year.
-@item
-@code{info-year} - Release year.
+@item info-originalyear
+Original release year.
-@item
-@code{info-originalyear}: Original release year.
-
-@item
-@code{info-note}: Free-form notes.
+@item info-note
+Free-form note.
-@item
-@code{info-genre}: Genre.
+@item info-genre
+Genre.
-@item
-@code{info-label}: Record label.
+@item info-label
+Record label.
-@item
-@code{info-playing-time}: Seconds of playtime.
+@item info-playing-time
+Playing time in seconds.
-@end itemize
+@end table
@noindent
An info method does not need to add all of these symbols into the