---
name: "lu-sh"
section: "1"
platform: "linux"
package: "licenseutils"
version: "0.0.9-8"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/lu-sh"
---

# lu-sh(1)

a license utility shell

## 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.*