man/sndfile-metadata-get.1 : Improvements.

This commit is contained in:
Erik de Castro Lopo 2014-06-23 17:16:53 +10:00
parent 21cfbcc491
commit 9408b60155

View File

@ -7,30 +7,106 @@
.Sh SYNOPSIS
.Nm sndfile-metadata-get
.Op Ar options
.\"FIXME add the details here
.Ar file
.Nm sndfile-metadata-set
.Op Ar options
.\"FIXME add the details here
.Ar file
.Nm sndfile-metadata-set
.Op Ar options
.\"FIXME add the details here
.Ar input-file
.Ar output-file
.Ar input
.Ar output
.Sh DESCRIPTION
.Nm sndfile-metadata-get
and
.Nm sndfile-metadata-set
use libsndfile
.Pq Lk http://www.mega-nerd.com/libsndfile/
to retrieve metadata from or set metadata in a sound file.
displays bext and string metadata stored in an audio file.
The following options specify what to print.
.Pp
Run
.Dq sndfile-metadata-get --help
or
.Dq sndfile-metadata-set --help
for more information.
.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.
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 SEE ALSO
.Lk http://www.mega-nerd.com/libsndfile/
.Lk http://tech.ebu.ch/docs/tech/tech3285.pdf
.Sh AUTHORS
This manual page was written by
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com .
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com