add-comments is a shell script to add comments to an audio file regardless of
type.

Copyright (c) 2018 Tim Chadburn.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file "fdl.txt" which is part of this
package.

add-comments is a shell script to add comments to an audio file regardless of
type.

It is used like this:

add-comments COMMENT-FILE AUDIO-FILE ...

That is, the first argument is a text file containing the comments to be added
and the remaining arguments are audio files which the comments are to be added
to.

The contents of a standard comments file look like this:

LICENSE=http://creativecommons.org/licenses/by-sa/2.0/uk/
ARTIST=Tim Chadburn
COPYRIGHT=Tim Chadburn

Example usage would be this:

add-comments some-comments *.flac *.ogg

This script is implemented by other scripts which perform its functionality for
specific file formats. These scripts must have the name add-comment-EXT where
EXT is the file extension of the file format. For example add-comment-ogg or
add-comment-flac. add-comments will try to call such a script based on the
extension of the files it is given, therefore the scripts to implement
add-comments for specific file formats must be present in the user's PATH.

Presently the scripts supplied to do this for specific file formats are
add-comment-ogg and add-comment-flac.

The scripts performing the functionality for specific file formats are meant
to just add a single comment to a single file. They are called like this:

add-comment-EXT COMMENT FILE

For instance:

add-comment-ogg "ARTIST=Fluorescent" alone.ogg