[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/emms a6f8461 76/80: Use two-column tables in manual cha
From: |
Stefan Monnier |
Subject: |
[elpa] externals/emms a6f8461 76/80: Use two-column tables in manual chapter 13 |
Date: |
Wed, 17 Mar 2021 18:42:34 -0400 (EDT) |
branch: externals/emms
commit a6f8461e1d9c65c8f71cbfbb379111d1a38871c1
Author: Petteri Hintsanen <petterih@iki.fi>
Commit: Petteri Hintsanen <petterih@iki.fi>
Use two-column tables in manual chapter 13
Tables look less cluttered than simple lists.
---
doc/emms.texinfo | 153 +++++++++++++++++++++++++++----------------------------
1 file 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
- [elpa] externals/emms d7110c0 67/80: * emms-player-simple.el: lexical declaration and fix, (continued)
- [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, 2021/03/17
- [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 <=