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

diff --git a/m4/gengetopt/afh.m4 b/m4/gengetopt/afh.m4
index 6fd4ab69..9b8a6503 100644
--- a/m4/gengetopt/afh.m4
+++ b/m4/gengetopt/afh.m4
@@ -1,12 +1,17 @@
-args "--unamed-opts=audio_file --no-handle-version"
+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>
-option "chunk_table" c
+
+###################################
+section "printing meta information"
+###################################
+
+option "chunk-table" c
 #~~~~~~~~~~~~~~~~~~~~~
 "print also the chunk table"
 flag off
@@ -27,11 +32,68 @@ option "parser-friendly" p
 flag off
 details = "
 	Currently this option only affects the format of the chunk table,
-	so it has no effect if --chunk_table is not given.
+	so it has no effect if --chunk-table is not given.
 
 	The human-readable output (the default) consists of one output
 	line per chunk and the output contains also the chunk number,
 	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>