.\" format with nroff|troff|groff -man
.TH SHCOMP 1
.fp 5 CW
.nr mH 5
.de H0
.nr mH 0
.in 5n
\fB\\$1\fP
.in 7n
..
.de H1
.nr mH 1
.in 7n
\fB\\$1\fP
.in 9n
..
.de H2
.nr mH 2
.in 11n
\fB\\$1\fP
.in 13n
..
.de H3
.nr mH 3
.in 15n
\fB\\$1\fP
.in 17n
..
.de H4
.nr mH 4
.in 19n
\fB\\$1\fP
.in 21n
..
.de OP
.nr mH 0
.ie !'\\$1'-' \{
.ds mO \\fB\\-\\$1\\fP
.ds mS ,\\0
.\}
.el \{
.ds mO \\&
.ds mS \\&
.\}
.ie '\\$2'-' \{
.if !'\\$4'-' .as mO \\0\\fI\\$4\\fP
.\}
.el \{
.as mO \\*(mS\\fB\\-\\-\\$2\\fP
.if !'\\$4'-' .as mO =\\fI\\$4\\fP
.\}
.in 5n
\\*(mO
.in 9n
..
.de SP
.if \\n(mH==2 .in 9n
.if \\n(mH==3 .in 13n
.if \\n(mH==4 .in 17n
..
.de FN
.nr mH 0
.in 5n
\\$1 \\$2
.in 9n
..
.de DS
.in +3n
.ft 5
.nf
..
.de DE
.fi
.ft R
.in -3n
..
.SH NAME
shcomp \- compile a shell script
.SH SYNOPSIS
\fBshcomp\fP\ [\ \fIoptions\fP\ ]\ [infile\ [outfile]]
.SH DESCRIPTION
Unless \fB\-D\fP is specified, \fBshcomp\fP takes a shell script, \fIinfile\fP,
and creates a binary format file, \fIoutfile\fP, that \fBksh\fP can read and
execute with the same effect as the original script\&.
.PP
Since aliases are processed as the script is read, alias definitions whose
value requires variable expansion will not work correctly\&.
.PP
If \fB\-D\fP is specified, all double quoted strings that are preceded by
\fB$\fP are output\&. These are the messages that need to be translated to
locale specific versions for internationalization\&.
.PP
If \fIinfile\fP is a simple command name, the shell script will be searched on
\fB$PATH\fP\&. It does not need execute permission to be found\&.
.PP
If \fIoutfile\fP is omitted, then the results will be written to standard
output\&. If \fIinfile\fP is also omitted, the shell script will be read from
standard input\&. However, \fBshcomp\fP will not read a script from your
keyboard unless \fIinfile\fP is given as \fB/dev/stdin\fP, and will refuse to
write binary data to a terminal in any case\&.
.SH OPTIONS
.OP D dictionary flag -
Generate a list of strings that need to be placed in a message catalog for
internationalization\&.
.OP n noexec flag -
Displays warning messages for obsolete or non\-conforming constructs\&.
.OP v verbose flag -
Displays input from \fIinfile\fP onto standard error as it reads it\&.
.SH EXIT\ STATUS
.H1 0
Successful completion\&.
.H1 >0
An error occurred\&.
.SH SEE\ ALSO
\fBksh\fP(1)
.SH IMPLEMENTATION
.H0 version
shcomp (AT&T Research) 93u+m/1\&.0\&.10+f0999ab7 2024\-08\-01
.H0 author
David Korn <dgk@research\&.att\&.com>
.H0 copyright
(c) 1982\-2012 AT&T Intellectual Property
.H0 copyright
(c) 2020\-2024 Contributors to ksh 93u+m
.H0 license
https://www\&.eclipse\&.org/org/documents/epl\-2\&.0/EPL\-2\&.0\&.html