summaryrefslogtreecommitdiff
path: root/kit/makeSH.man
blob: ef8ed89e9afa0443886bcf6f8e4942c77b210a05 (plain)
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
.\" $Id: makeSH.man 3 2006-08-25 21:39:07Z rmanfredi $
.\"
.\"  Copyright (c) 1991-1997, 2004-2006, Raphael Manfredi
.\"  
.\"  You may redistribute only under the terms of the Artistic Licence,
.\"  as specified in the README file that comes with the distribution.
.\"  You may reuse parts of this distribution only within the terms of
.\"  that same Artistic Licence; a copy of which may be found at the root
.\"  of the source tree for dist 4.0.
.\"
.\" $Log: makeSH.man,v $
.\" Revision 3.0  1993/08/18  12:04:27  ram
.\" Baseline for dist 3.0 netwide release.
.\"
.\" 
.TH MAKESH 1 LOCAL
.SH NAME
makeSH \- a .SH script maker
.SH SYNOPSIS
.B makeSH
.I files
.SH DESCRIPTION
.I MakeSH
examines one or more scripts and produces a .SH file that, when run under sh,
will produce the original script.
The .SH script so produced has two sections containing code destined for
the output.
The first section has variable substitutions performed on it (taking values
from config.sh), while the second section does not.
MakeSH does not know which variables you want to have substituted, so it puts
the whole script into the second section.
It's up to you to insert any variable substitutions in the first section
for any values you want from config.sh.
.PP
You should run
.I makeSH
from within your top-level directory and use the relative path to the file
as an argument, so that the "Extracting ..." line printed while running
the produced .SH file later on will give that same path.
.SH AUTHOR
Larry Wall <lwall@netlabs.com>
.SH SEE ALSO
pat(1), metaconfig(1), makedist(1).
.SH BUGS
It could assume that variables from metaconfig's Glossary need to be
initialized in the first section, but I'm too lazy to make it do that.