X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=m4%2Fgengetopt%2Fafh.m4;h=9b8a650326069df5ad449d617f44449a0bf5156c;hp=ebc1d1cfa751f3e8ce6f2b8a96923c7c628362f1;hb=5e12f77a5b2a76c8a6f19a96958e0992962573db;hpb=d9e05a6585d795e44847608a8a6ee424a7604b74

diff --git a/m4/gengetopt/afh.m4 b/m4/gengetopt/afh.m4
index ebc1d1cf..9b8a6503 100644
--- a/m4/gengetopt/afh.m4
+++ b/m4/gengetopt/afh.m4
@@ -1,11 +1,16 @@
 args "--unamed-opts=audio_file --no-handle-version --no-handle-help"
 
-purpose "Print information about audio file(s)."
+purpose "Print information about audio file(s)"
 
 include(header.m4)
 include(loglevel.m4)
 
 <qu>
+
+###################################
+section "printing meta information"
+###################################
+
 option "chunk-table" c
 #~~~~~~~~~~~~~~~~~~~~~
 "print also the chunk table"
@@ -34,4 +39,61 @@ details = "
 	the duration and the size of each chunk. The parser-friendly
 	output prints only the offsets, in one line.
 "
+
+#############################
+section "modifying meta tags"
+#############################
+
+option "modify" m
+#~~~~~~~~~~~~~~~~
+"modify (rather than print) tags"
+flag off
+details = "
+	When this option is given, para_afh creates the result file
+	as a temporary copy of the given file(s), but with meta
+	tags changed according to the options below. On errors,
+	the temporary file is removed, leaving the original file
+	unchanged. On success, if --backup is given, the original
+	file is moved away. Finally the temporary file is renamed to
+	the name of the original file.
+"
+
+option "backup" b
+"create backup of the original file"
+flag off
+details = "
+	The backup suffix is '~', i.e. a single tilde character is appended
+	to the given file name.
+"
+
+option "year" y
+#~~~~~~~~~~~~~~
+"set the year tag"
+string typestr="year"
+optional
+
+option "title" t
+#~~~~~~~~~~~~~~~
+"set the title tag"
+string typestr="title"
+optional
+
+option "artist" a
+#~~~~~~~~~~~~~~~~
+"set the artist/author tag"
+string typestr="artist"
+optional
+
+option "album" A
+#~~~~~~~~~~~~~~~
+"set the album tag"
+string typestr="album"
+optional
+
+option "comment" C
+#~~~~~~~~~~~~~~~~~
+"set the comment tag"
+string typestr="comment"
+optional
+
 </qu>