tags 417606 +patch
thank you
Clint Adams wrote:
> If you just run "vorbiscomment" and read the usage info, that should
> cover it. A patch to add appropriate verbiage to the man page would be
> appreciated.
>
The attached patch should fix this.
> : | vorbiscomment -w foo.ogg
>
> or
>
> vorbiscomment -w foo.ogg </dev/null
>
> should do the trick
>
I actually found "vorbiscomment -w foo.ogg -c /dev/null" which works
fine and does not have the drawback of requiring to exec bash to handle
pipe/redirection. Anyway, if there's no undocumented option to replace
this "-c /dev/null", and if the manpage is complete with my patch above,
that will be fine.
Thanks,
Brice
---
vorbiscomment/vorbiscomment.1 | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
Index: vorbis-tools-1.1.1/vorbiscomment/vorbiscomment.1
===================================================================
--- vorbis-tools-1.1.1.orig/vorbiscomment/vorbiscomment.1 2007-04-05 21:12:52.000000000 +0200
+++ vorbis-tools-1.1.1/vorbiscomment/vorbiscomment.1 2007-04-05 21:26:33.000000000 +0200
@@ -33,7 +33,7 @@
.IP "-a"
Append comments.
.IP "-c commentfile"
-Take comments from a file. The file is the same format as is output by the the -l option: one element per line in 'tag=value' format.
+Take comments from a file. The file is the same format as is output by the the -l option or given to the -t option: one element per line in 'tag=value' format. If the file is /dev/null and -w was passed, the existing comments will be removed.
.IP "-h"
Show command help.
.IP "-l"
@@ -43,7 +43,7 @@
.IP "-t 'tag=value'"
Specify a new tag on the command line. Each tag is given as a single string. The part before the '=' is treated as the tag name and the part after as the value.
.IP "-w"
-Replace comments with the new set given either on the command line with -t or from a file with -c.
+Replace comments with the new set given either on the command line with -t or from a file with -c. If neither -c nor -t is given, the new set will be read from the standard input.
.IP "-R"
Read and write comments in utf8, rather than converting to the user's character set.
@@ -64,6 +64,13 @@
vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg
+To add a set of comments from the standard input:
+
+ vorbiscomment -a file.ogg
+ ARTIST=No One You Know
+ ALBUM=The Famous Album
+ <ctrl-d>
+
.SH SEE ALSO
See http://xiph.org/ogg/vorbis/doc/v-comment.html for documentation on the Ogg Vorbis tag format, including a suggested list of canonical tag names.
