NAME

       lu-sh - a license utility shell

SYNOPSIS

       lu-sh [OPTION...] [FILE]

DESCRIPTION

       lu-sh  is a license utility shell used to add copyright and license notices to source code
       files and PNG files.  The commands that lu-sh recognizes are the same  commands  that  the
       licensing  program  provides.   lu-sh is an extended bash shell, with an alias for each of
       the licensing commands.

       The effect is that boilerplate foo.c in the lu-sh shell is equivalent to typing  licensing
       boilerplate foo.c in the system shell.

       The available commands are:

              notice: A simple script to write license notices to files.

              boilerplate: Show or remove the boilerplate text at the top of a file.

              help: Show some explanatory text for commands.

              warranty: Show a disclaimer on use of this program.

              welcome: Show the greeting.

              copyright: Add or modify copyright notices in the working boilerplate.

              cbb: Count boilerplate blocks in a file.

              comment: Create a comment block out of some arbitrary text.

              uncomment: Remove comment delimiters but leave the comment text.

              prepend: Put one file onto the start of another.

              choose: Pick license and comment style for the working boilerplate.

              top: Add or modify the top line of the working boilerplate.

              project: Add a project name to the current working boilerplate.

              preview: Show the current working boilerplate.

              apply: Prepend the current working boilerplate to a file.

              new-boilerplate: Clear the current working boilerplate.

              extra: Add or modify the pre-license text of the working boilerplate.

              png-boilerplate: Show or remove the comment in a png file.

              png-apply: Put the current working boilerplate into a PNG file.

       Some  of  the commands modify the current working boilerplate and some do not.  The prompt
       will change to reflect the currently selected commenting style, and the currently selected
       license.

EXAMPLES

       This example puts a copyright and a GNU GPL notice in foo.c:

              licensing> echo "foo" > foo.c
              licensing> choose gpl
              Selected.
              gplv3+> choose c
              Selected.
              /* gplv3+ */> copyright Yoyodyne Inc. 2005-2013 -a
              Copyright (C) 2005-2013 Yoyodyne Inc.
              Added.
              /* gplv3+ */> apply foo.c
              apply: foo.c -> Boilerplate added.
              /* gplv3+ */>

OPTIONS

       The options are the same as the bash shell.

FILES

       ~/.lu-shrc - bash initialization file.
       Various files are kept in ~/.licenseutils/.

REPORTING BUGS

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

SEE ALSO

       The full documentation for lu-sh is maintained as a Texinfo manual.  If the info and lu-sh
       programs are properly installed at your site, the command

              info licenseutils

       should give you access to the complete manual.