diff src/libsndfile-1.0.27/man/sndfile-metadata-get.1 @ 40:1df64224f5ac

Current libsndfile source

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/libsndfile-1.0.27/man/sndfile-metadata-get.1	Tue Oct 18 13:22:47 2016 +0100
@@ -0,0 +1,116 @@
+.Dd November 2, 2014
+.Dt SNDFILE-METADATA-GET 1
+.Os
+.Sh NAME
+.Nm sndfile-metadata-get ,
+.Nm sndfile-metadata-set
+.Nd get or set metadata in a sound file
+.Sh SYNOPSIS
+.Nm sndfile-metadata-get
+.Op Ar options
+.Ar file
+.Nm sndfile-metadata-set
+.Op Ar options
+.Ar file
+.Nm sndfile-metadata-set
+.Op Ar options
+.Ar input
+.Ar output
+.Sh DESCRIPTION
+.Nm sndfile-metadata-get
+displays bext and string metadata stored in an audio file.
+The following options specify what to print.
+.Pp
+.Bl -tag -width bext-descriptionXXXX -compact
+.It Fl -all
+all metadata
+.It Fl -bext-description
+description
+.It Fl -bext-originator
+originator info
+.It Fl -bext-orig-ref
+originator reference
+.It Fl -bext-umid
+Unique Material Identifier
+.It Fl -bext-orig-date
+origination date
+.It Fl -bext-orig-time
+origination time
+.It Fl -bext-coding-hist
+coding history
+.It Fl -str-title
+title
+.It Fl -str-copyright
+copyright
+.It Fl -str-artist
+artist
+.It Fl -str-comment
+comment
+.It Fl -str-date
+creation date
+.It Fl -str-album
+album
+.It Fl -str-license
+license
+.El
+.Pp
+.Nm sndfile-metadata-set
+sets bext and string metadata in an audio file if the format supports it.
+If the file does not contain a BEXT chunk to be modified,
+the second synopsis must be used, where another output file
+capable of storing the metadata is created.
+This file is overwritten if it already exists.
+The following options take an argument specifying the metadata:
+.Pp
+.Bl -tag -width bext-coding-histXXXXXXX -compact
+.It Fl -bext-description
+description
+.It Fl -bext-originator
+originator
+.It Fl -bext-orig-ref
+originator reference
+.It Fl -bext-umid
+Unique Material Identifier
+.It Fl -bext-orig-date
+origination date
+.It Fl -bext-orig-time
+origination time
+.It Fl -bext-coding-hist
+coding history
+.It Fl -bext-time-raf
+time reference
+.It Fl -str-comment
+comment
+.It Fl -str-title
+title
+.It Fl -str-copyright
+copyright
+.It Fl -str-artist
+artist
+.It Fl -str-date
+date
+.It Fl -str-album
+album
+.It Fl -str-license
+license
+.El
+.Pp
+The following options take no argument:
+.Pp
+.Bl -tag -width bext-coding-histXXXXXXX -compact
+.It Fl -bext-auto-time-date
+Set the BEXT time and date to current.
+.It Fl -bext-auto-time
+Set the BEXT time to current.
+.It Fl -bext-auto-date
+Set the BEXT date to current.
+.It Fl -str-auto-date
+Set the string date to current.
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Lk http://www.mega-nerd.com/libsndfile/
+.Lk http://tech.ebu.ch/docs/tech/tech3285.pdf
+.Sh AUTHORS
+.An Erik de Castro Lopo Aq Mt [e-mail]