[xiph-cvs] cvs commit: vorbis-tools/ogginfo ogginfo.1 Makefile.am

[Jack Moffitt]

jack        01/06/17 20:48:14

  Modified:    .        vorbis-tools.spec
               ogginfo  Makefile.am
  Added:       ogginfo  ogginfo.1
  Log:
  Added manpage for ogginfo, and make appropriate build system changes

Revision  Changes    Path
1.19      +1 -0      vorbis-tools/vorbis-tools.spec

Index: vorbis-tools.spec
===================================================================
RCS file: /usr/local/cvsroot/vorbis-tools/vorbis-tools.spec,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- vorbis-tools.spec	2001/06/18 02:24:25	1.18
+++ vorbis-tools.spec	2001/06/18 03:48:13	1.19
@@ -45,6 +45,7 @@
 /usr/bin/vorbiscomment
 /usr/share/man/man1/ogg123.1*
 /usr/share/man/man1/oggenc.1*
+/usr/share/man/man1/ogginfo.1*
 
 %clean 
 [ "$RPM_BUILD_ROOT" != "/" ] && rm -rf $RPM_BUILD_ROOT

1.2       +4 -0      vorbis-tools/ogginfo/Makefile.am

Index: Makefile.am
===================================================================
RCS file: /usr/local/cvsroot/vorbis-tools/ogginfo/Makefile.am,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Makefile.am	2001/06/18 02:24:25	1.1
+++ Makefile.am	2001/06/18 03:48:13	1.2
@@ -3,12 +3,16 @@
 AUTOMAKE_OPTIONS = foreign
 
 bin_PROGRAMS = ogginfo
+mandir = $(datadir)/man
+man_MANS = ogginfo.1
 
 INCLUDES = @OGG_CFLAGS@ @VORBIS_CFLAGS@
 
 ogginfo_LDADD = @VORBISFILE_LIBS@ @VORBIS_LIBS@ @OGG_LIBS@
 
 ogginfo_SOURCES = ogginfo.c
+
+EXTRA_DIST = $(man_MANS)
 
 debug:
         $(MAKE) all CFLAGS="@DEBUG@"

1.1                  vorbis-tools/ogginfo/ogginfo.1

Index: ogginfo.1
===================================================================
.\" Process this file with
.\" groff -man -Tascii ogginfo.1
.\"
.TH ogg123 1 "June 17, 2001" "" "Vorbis Tools"

.SH NAME
ogginfo \- gives information about Ogg files.

.SH SYNOPSIS
.B ogginfo
.I file1.ogg
.B ...
.I fileN.ogg

.SH DESCRIPTION
.B ogginfo
reads one or more Ogg files and decodes the comments contained within, writing
them to standard output, in a "attribute=value" format, one per line.
The first attribute printed will always be the
.B filename
of the stream. 
.B ogginfo
cannot accept URLs. 
.B ogginfo
will also print the 
.B length
of the file in seconds, and the
.B playtime
in a humanly-readable MM:SS format.


.SH OPTIONS
None.

.SH EXAMPLES

The
.B ogginfo
command line accepts as many filenames as your shell will allow.

.PP
Information about one file:
.RS
.B ogginfo track14.ogg
.RE



Will print:

.RS
.br
.B
filename=track14.ogg
.br
.B
title=If I Had $1000000
.br
.B
artist=Barenaked Ladies 
.br
.B
album=Gordon
.br
.B
tracknumber=14
.br
.B
length=267.040000
.br
.B
playtime=4:27
.RE

.PP
Information on multiple files:
.RS
.B ogginfo track1.ogg track2.ogg
.RE

.PP
Will print:

.RS
.br
.B
filename=track1.ogg
.br
.B
title=The Vorbis Theme
.br
.B
artist=Monty and The Wet Trouts
.br
.B
album=Musical Penguins 3
.br
.B
tracknumber=1
.br
.B
length=67.38383
.br
.B
playtime=1:07
.br
.B
filename=track2.ogg
.br
.B
title=Being for the Benefit of Mr. Fish
.br
.B
artist=Monty and The Wet Trouts
.br
.B
album=Musical Penguins 3
.br
.B
tracknumber=2
.br
.B
length=449.0000
.br
.B
playtime=7:29
.RE

.SH BUGS

The man page is longer than the source.

.SH AUTHOR

.TP
.br
JAmes Atwill <ogg at linuxstuff.org>

--- >8 ----
List archives:  http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.