Vorbis dev - Nov 2007 - Re: [xiph-commits] r14188 - trunk/vorbis-tools/vorbiscomment

I don't agree with the s/Ogg Vorbis/Vorbis/. vorbiscomment does edit Ogg 
Vorbis files, not Vorbis streams in any other encapsulation.

 -r

On Mon, Nov 19, 2007 at 07:01:43AM -0800, ivo@svn.xiph.org
wrote:
> Author: ivo
> Date: 2007-11-19 07:01:43 -0800 (Mon, 19 Nov 2007)
> New Revision: 14188
> 
> Modified:
>    trunk/vorbis-tools/vorbiscomment/vorbiscomment.1
> Log:
> committed debian patch from #417606: vorbiscomment manpage is unclear about
clearing tags
> 
> Modified: trunk/vorbis-tools/vorbiscomment/vorbiscomment.1
> ==================================================================> ---
trunk/vorbis-tools/vorbiscomment/vorbiscomment.1	2007-11-19 14:45:07 UTC (rev
14187)
> +++ trunk/vorbis-tools/vorbiscomment/vorbiscomment.1	2007-11-19 15:01:43
UTC (rev 14188)
> @@ -1,10 +1,10 @@
>  .\" Process this file with
>  .\" groff -man -Tascii vorbiscomment.1
>  .\"
> -.TH VORBISCOMMENT 1 "December 24, 2001" "Xiph.org
Foundation" "Vorbis Tools"
> +.TH VORBISCOMMENT 1 "December 24, 2001" "Xiph.Org
Foundation" "Vorbis Tools"
>  
>  .SH NAME
> -vorbiscomment \- List or edit comments in Ogg Vorbis files
> +vorbiscomment \- List or edit comments in Vorbis files
>  
>  .SH SYNOPSIS
>  .B vorbiscomment
> @@ -27,23 +27,23 @@
>  
>  .SH DESCRIPTION
>  .B vorbiscomment
> -Reads, modifies, and appends Ogg Vorbis audio file metadata tags.
> +Reads, modifies, and appends Vorbis audio file metadata tags.
>  
>  .SH OPTIONS
>  .IP "-a, --append"
>  Append comments.
>  .IP "-c file, --commentfile file"
> -Take comments from a file. The file is the same format as is output by the
the -l option: one element per line in 'name=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, --help"
>  Show command help.
>  .IP "-l, --list"
> -List the comments in the ogg vorbis file.
> +List the comments in the Vorbis file.
>  .IP "-q, --quiet"
>  Quiet mode.  No messages are displayed.
>  .IP "-t 'name=value', --tag 'name=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, --write"
> -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, --raw"
>  Read and write comments in UTF-8, rather than converting to the user's
character set.
>  .IP "-V, --version"
> @@ -66,9 +66,16 @@
>  
>      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 TAG FORMAT
>  
> -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.
> +See http://xiph.org/ogg/vorbis/doc/v-comment.html for documentation on the
Vorbis tag format, including a suggested list of canonical tag names.
>  
>  .SH AUTHORS
>  
> 
> _______________________________________________
> commits mailing list
> commits@xiph.org
> http://lists.xiph.org/mailman/listinfo/commits

On 11/19/07, Ralph Giles <giles@xiph.org> wrote:
> I don't agree with the s/Ogg Vorbis/Vorbis/. vorbiscomment does edit
Ogg
> Vorbis files, not Vorbis streams in any other encapsulation.
Alright, let me clean that up.

Speaking of Vorbis Tools, Is this a good time to ask if new files with
Skeleton are working well for everyone?