From: Eric Gillespie <epg@pretzelnet.org>
Date: Sun, 6 Mar 2022 19:33:58 +0000 (-0600)
Subject: move comments to library
X-Git-Url: https://diplodocus.org/git/flac-archive/commitdiff_plain/a33146ed688d846422b0ba519fa75c2bbaf0d651

move comments to library
---

diff --git a/fa-encode b/fa-encode
index a4db1b6..e1d3a2c 100755
--- a/fa-encode
+++ b/fa-encode
@@ -15,53 +15,6 @@ TODO:  implement B<-d>
 
 =cut
 
-# POSIX.1-2017, Base Definitions, 3.282  Portable Filename Character Set says
-#   [A-Za-z0-9._-]
-# https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_282
-
-# Flac tags (set with `flac -T fieldname=...`) are Vorbis comments.
-# https://www.xiph.org/vorbis/doc/v-comment.html#fieldnames field names we care about:
-# - TITLE - Track/Work name
-# - VERSION - may be used to differentiate multiple versions of the same track title in a single collection. (e.g. remix info)
-# - ALBUM - The collection name to which this track belongs
-# - TRACKNUMBER - The track number of this piece
-# - ARTIST - The artist generally considered responsible for the track
-# - DATE - Date the track was recorded (XXX I use US release date)
-# https://age.hobba.nl/audio/mirroredpages/ogg-tagging.html (supposedly mirrored from http://reactor-core.org/ogg-tagging.html )
-# specifies more:
-# - DISCNUMBER - if part of a multi-disc album, put the disc number here
-# - VERSION - e.g. "live", "radio edit"
-# - PARTNUMBER - part number if a work is divided across tracks
-# - PART - part name e.g. "Oh sole mio"
-# https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html
-# - ALBUMARTIST - maps to ID3v2 TPE2
-
-# Input is a directory containing:
-# - trackNN.cdda.wav - WAV  format files ripped from CD-DA audio tracks where NN is track number 01 - 99
-# - tags - described below
-# - cover.front.jpeg - optional JPEG format file containing the album front cover
-
-# The tags file is composed of two blocks:
-# 1. album tags
-# 2. track tags
-# Album tags may be:
-# - ALBUM
-# - ARTIST
-# - DATE
-# - DISCNUMBER (optional)
-
-# Track tags may be any of the rest of the tags listed above, suffixed with
-# [N] where N is the track number.  ARTIST, and only ARTIST, may also appear
-# in the track tags.  In this case, it overrides the album artist.  In order
-# to add artists, the album artist must be listed again.  For example, Reba
-# McEntire's "The Heart Won't Lie" on the album "It's Your Call" features
-# Vince Gill, and is specified as:
-# ARTIST=Reba McEntire
-# ALBUM=It's Your Call
-# TITLE[5]=The Heart Won't Lie
-# ARTIST[5]=Reba McEntire
-# ARTIST[5]=Vince Gill
-
 package epg::flac::archive::encode;
 
 use v5.12;
diff --git a/tags.pl b/tags.pl
index 5969ae0..25c7d3a 100644
--- a/tags.pl
+++ b/tags.pl
@@ -1,5 +1,52 @@
 package epg::flac::archive::tags;
 
+# POSIX.1-2017, Base Definitions, 3.282  Portable Filename Character Set says
+#   [A-Za-z0-9._-]
+# https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_282
+
+# Flac tags (set with `flac -T fieldname=...`) are Vorbis comments.
+# https://www.xiph.org/vorbis/doc/v-comment.html#fieldnames field names we care about:
+# - TITLE - Track/Work name
+# - VERSION - may be used to differentiate multiple versions of the same track title in a single collection. (e.g. remix info)
+# - ALBUM - The collection name to which this track belongs
+# - TRACKNUMBER - The track number of this piece
+# - ARTIST - The artist generally considered responsible for the track
+# - DATE - Date the track was recorded (XXX I use US release date)
+# https://age.hobba.nl/audio/mirroredpages/ogg-tagging.html (supposedly mirrored from http://reactor-core.org/ogg-tagging.html )
+# specifies more:
+# - DISCNUMBER - if part of a multi-disc album, put the disc number here
+# - VERSION - e.g. "live", "radio edit"
+# - PARTNUMBER - part number if a work is divided across tracks
+# - PART - part name e.g. "Oh sole mio"
+# https://picard-docs.musicbrainz.org/en/appendices/tag_mapping.html
+# - ALBUMARTIST - maps to ID3v2 TPE2
+
+# Input is a directory containing:
+# - trackNN.cdda.wav - WAV  format files ripped from CD-DA audio tracks where NN is track number 01 - 99
+# - tags - described below
+# - cover.front.jpeg - optional JPEG format file containing the album front cover
+
+# The tags file is composed of two blocks:
+# 1. album tags
+# 2. track tags
+# Album tags may be:
+# - ALBUM
+# - ARTIST
+# - DATE
+# - DISCNUMBER (optional)
+
+# Track tags may be any of the rest of the tags listed above, suffixed with
+# [N] where N is the track number.  ARTIST, and only ARTIST, may also appear
+# in the track tags.  In this case, it overrides the album artist.  In order
+# to add artists, the album artist must be listed again.  For example, Reba
+# McEntire's "The Heart Won't Lie" on the album "It's Your Call" features
+# Vince Gill, and is specified as:
+# ARTIST=Reba McEntire
+# ALBUM=It's Your Call
+# TITLE[5]=The Heart Won't Lie
+# ARTIST[5]=Reba McEntire
+# ARTIST[5]=Vince Gill
+
 use v5.12;
 use warnings;