.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
.TH NOTICE "1" "December 2013" "lu-sh" "User Commands"
.SH NAME
notice \- a utility for writing license notices to source files.
.SH SYNOPSIS
.B notice
[\fIOPTION\fR...] [\fIFILE\fR...]
.SH DESCRIPTION
The notice command is a simple way to add a boilerplate to a set of source-code files.  It is a wrapper script for the
.B licensing
program.

.SH "EXAMPLES"

The notice command is most often used like so:

.IP
.B
$ licensing notice \-c 'Yoyo,\ Inc.\ 2001' \-l gpl \-s c \-n *.[ch]
.br
.B
apply: foo.c -> Boilerplate applied.
.br
.B
apply: bar.c -> Boilerplate applied.
.br
.B
apply: qux.c -> Boilerplate applied.
.br
.B
apply: foo.h -> Boilerplate applied.
.br

.TP
This example applies the license notice for the latest version of the GPL in the C-commenting style to all of the .c and .h files in the current directory.  The copyright holder is Yoyo, Inc, in the year 2001.


.SH "OPTIONS"

.TP
\-n\fR
Don't retain .bak backup files.
.TP
\-c \fINAME-AND-YEAR\fR
Specify the copyright holder and years. The syntax for copyright years allows for years separated by a comma, and also ranges of years separated by a hyphen.  In most shells, the argument for this option must be enclosed in single quotes.
.TP
\-l \fILICENSE\fR
Specify the license notice to apply to the source-code files.  The supported licenses are: gpl, gplv3+, gplv3, gplv2+, gplv2, gplv1+, gplv1, lgpl, lgplv3+, lgplv3, lgplv2+, lgplv2, lgplv1+, lgplv1, agpl, agplv3+, agplv3, fdl, fdlv13+, fdlv13, fdlv12+, fdlv12, fdlv11+, fdlv11, all-permissive, bsd, bsd3clause, bsd2clause, apache, apachev2, mit, isc, and openbsd.
.TP
\-s \fICOMMENTING-STYLE\fR
Specify the commenting style.  The supported commenting styles are: c, c++, shell, scheme, texinfo, m4, haskell, groff, gettext, fortran, and pascal.
.TP
\-?, \fB\-\-help\fR
Give a list the available options.

.SH "REPORTING BUGS"
Report bugs to <https://sv.nongnu.org/bugs/?group=licenseutils>.

.SH "SEE ALSO"
The full documentation for
.B notice
is maintained as a Texinfo manual.  If the
.B info
and
.B licensing
programs are properly installed at your site, the command
.IP
.B info licenseutils notice
.PP
will give you access to the complete documentation for the notice command.