'\" t
.\"     Title: LIBLICENSE
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: June  4, 2008
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "LIBLICENSE" "1" "June 4, 2008" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
license \- program to specify and modify media file licenses
.SH "SYNOPSIS"
.HP \w'\fBlicense\fR\ 'u
\fBlicense\fR [\fB\fIfilename\fR\fR]
.SH "DESCRIPTION"
.PP
The liblicense package provides a
\fBlicense\fR
command to allow simple command\-line examination and manipulation of license information embedded in media files\&. The default action is to show the default license as configured in $HOME/\&.license\&. This default can be offered by applications that use liblicense when asking you what license you would like to release your work under\&.
.PP
In addition to showing you and allowing you to change the embedded license in a file, the
\fBlicense\fR
also can show and allow you to change the embedded "web statement URI", a link to a web page with information about the file that you can use to verify the embedded license\&.
.SH "OPTIONS"
.PP
These programs follow the usual
GNU
command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&. For a complete description, run the application with \-\-help\&.
.PP
\fB\-h\fR \fB\-\-help\fR
.RS 4
Show summary of options\&.
.RE
.PP
\fB\-v\fR \fB\-\-verbose\fR
.RS 4
Output more information about the actions of the program\&.
.RE
.PP
\fB\-q\fR \fB\-\-quiet\fR
.RS 4
Output less information about the actions of the program\&.
.RE
.PP
\fB\-a JURISDICTION\fR \fB\-\-list=JURISDICTION\fR
.RS 4
List all avialbale licenses in JURISDICTION (uses the generic jurisdiction if JURISDICTION is not specified)\&.
.RE
.PP
\fB\-\-set\-license\fR
.RS 4
Sets the license of the file (to the license specified by "\-l")\&.
.RE
.PP
\fB\-\-remove\-license\fR
.RS 4
Removes the embedded license metadata from the file\&.
.RE
.PP
\fB\-l URI\fR \fB\-\-license=URI\fR
.RS 4
When setting the license of a file or the default license preference, set it to URI\&.
.RE
.PP
\fB\-\-set\-web\-statement\fR
.RS 4
Sets the web statement link in the file (to the value specified by "\-w")\&.
.RE
.PP
\fB\-\-remove\-web\-statement\fR
.RS 4
Removes the embedded web statement metadata from the file\&.
.RE
.PP
\fB\-w URI\fR \fB\-\-web\-statement=URI\fR
.RS 4
When setting the web statement URI in a file, set it to URI\&.
.RE
.PP
\fB\-u MODULE\fR \fB\-\-use=MODULE\fR
.RS 4
Use the module called MODULE to interact with a file\&.
.RE
.PP
\fB\-m\fR
.RS 4
List the available modules and their capabilities\&. Modules are used to handle different media types\&.
.RE
.SH "AUTHOR"
.PP
This manual page was written by Asheesh Laroia
asheesh@asheesh\&.org\&. Permission is granted to copy, distribute and/or modify this document under the terms of the
GNU
Lesser General Public License, Version 2\&.1 or any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU Lesser General Public License can be found in /usr/share/common\-licenses/LGPL\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2008 Asheesh Laroia
.br