1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
.TH LUSH "1" "October 2013" "lu-sh" "User Commands"
.SH NAME
lu-sh \- a license utility shell
.SH SYNOPSIS
.B lu-sh
[\fIOPTION\fR...] [\fIFILE]
.SH 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
.B licensing
program provides. lu-sh is an extended bash shell, with an alias for each of the licensing commands.
The effect is that
.B boilerplate foo.c
in the lu-sh shell is equivalent to typing
.B licensing boilerplate foo.c
in the system shell.
The available commands are:
.IP
notice: A simple script to write license notices to files.
.IP
boilerplate: Show or remove the boilerplate text at the top of a file.
.IP
help: Show some explanatory text for commands.
.IP
warranty: Show a disclaimer on use of this program.
.IP
welcome: Show the greeting.
.IP
copyright: Add or modify copyright notices in the working boilerplate.
.IP
cbb: Count boilerplate blocks in a file.
.IP
comment: Create a comment block out of some arbitrary text.
.IP
uncomment: Remove comment delimiters but leave the comment text.
.IP
prepend: Put one file onto the start of another.
.IP
choose: Pick license and comment style for the working boilerplate.
.IP
top: Add or modify the top line of the working boilerplate.
.IP
project: Add a project name to the current working boilerplate.
.IP
preview: Show the current working boilerplate.
.IP
apply: Prepend the current working boilerplate to a file.
.IP
new-boilerplate: Clear the current working boilerplate.
.IP
extra: Add or modify the pre-license text of the working boilerplate.
.IP
png-boilerplate: Show or remove the comment in a png file.
.IP
png-apply: Put the current working boilerplate into a PNG file.
.PP
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.
.SH "EXAMPLES"
This example puts a copyright and a GNU GPL notice in foo.c:
.IP
.B
licensing> echo "foo" > foo.c
.br
.B
licensing> choose gpl
.br
Selected.
.br
.B
gplv3+> choose c
.br
Selected.
.br
.B
/* gplv3+ */> copyright Yoyodyne Inc. 2005-2013 \-a
.br
Copyright (C) 2005-2013 Yoyodyne Inc.
.br
Added.
.br
.B
/* gplv3+ */> apply foo.c
.br
apply: foo.c -> Boilerplate added.
.br
.B
/* gplv3+ */>
.br
.SH "OPTIONS"
The options are the same as the bash shell.
.SH "FILES"
.B
~/.lu-shrc
- bash initialization file.
.br
Various files are kept in
.B
~/.licenseutils/.
.SH "REPORTING BUGS"
Report bugs to <https://sv.nongnu.org/bugs/?group=licenseutils>.
.SH "SEE ALSO"
The full documentation for
.B lu-sh
is maintained as a Texinfo manual. If the
.B info
and
.B lu-sh
programs are properly installed at your site, the command
.IP
.B info licenseutils
.PP
should give you access to the complete manual.
|
