xref: /netbsd-src/external/gpl2/gettext/dist/gettext-runtime/man/envsubst.1.html (revision 946379e7b37692fc43f68eb0d1c10daa0a7f3b6c)
1<html>
2<head>
3<meta name="generator" content="groff -Thtml, see www.gnu.org">
4<meta name="Content-Style" content="text/css">
5<title>ENVSUBST</title>
6</head>
7<body>
8
9<h1 align=center>ENVSUBST</h1>
10<a href="#NAME">NAME</a><br>
11<a href="#SYNOPSIS">SYNOPSIS</a><br>
12<a href="#DESCRIPTION">DESCRIPTION</a><br>
13<a href="#AUTHOR">AUTHOR</a><br>
14<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
15<a href="#COPYRIGHT">COPYRIGHT</a><br>
16<a href="#SEE ALSO">SEE ALSO</a><br>
17
18<hr>
19<!-- Creator     : groff version 1.17.2 -->
20<a name="NAME"></a>
21<h2>NAME</h2>
22<table width="100%" border=0 rules="none" frame="void"
23       cols="2" cellspacing="0" cellpadding="0">
24<tr valign="top" align="left">
25<td width="10%"></td><td width="90%">
26envsubst - substitutes environment variables in shell format strings</td></table>
27<a name="SYNOPSIS"></a>
28<h2>SYNOPSIS</h2>
29
30<table width="100%" border=0 rules="none" frame="void"
31       cols="2" cellspacing="0" cellpadding="0">
32<tr valign="top" align="left">
33<td width="10%"></td><td width="90%">
34<b>envsubst</b> [<i>OPTION</i>]
35[<i>SHELL-FORMAT</i>]</td></table>
36<a name="DESCRIPTION"></a>
37<h2>DESCRIPTION</h2>
38
39<table width="100%" border=0 rules="none" frame="void"
40       cols="2" cellspacing="0" cellpadding="0">
41<tr valign="top" align="left">
42<td width="10%"></td><td width="90%">
43Substitutes the values of environment
44variables.</td></table>
45
46<table width="100%" border=0 rules="none" frame="void"
47       cols="2" cellspacing="0" cellpadding="0">
48<tr valign="top" align="left">
49<td width="4%"></td><td width="96%">
50<b>Operation mode:</b></td></table>
51
52<table width="100%" border=0 rules="none" frame="void"
53       cols="2" cellspacing="0" cellpadding="0">
54<tr valign="top" align="left">
55<td width="10%"></td><td width="90%">
56<b>-v</b>, <b>--variables</b></td></table>
57
58<table width="100%" border=0 rules="none" frame="void"
59       cols="2" cellspacing="0" cellpadding="0">
60<tr valign="top" align="left">
61<td width="21%"></td><td width="79%">
62output the variables occurring in SHELL-FORMAT</td></table>
63
64<table width="100%" border=0 rules="none" frame="void"
65       cols="2" cellspacing="0" cellpadding="0">
66<tr valign="top" align="left">
67<td width="4%"></td><td width="96%">
68<b>Informative output:</b></td></table>
69
70<table width="100%" border=0 rules="none" frame="void"
71       cols="2" cellspacing="0" cellpadding="0">
72<tr valign="top" align="left">
73<td width="10%"></td><td width="90%">
74<b>-h</b>, <b>--help</b></td></table>
75
76<table width="100%" border=0 rules="none" frame="void"
77       cols="2" cellspacing="0" cellpadding="0">
78<tr valign="top" align="left">
79<td width="21%"></td><td width="79%">
80display this help and exit</td></table>
81
82<table width="100%" border=0 rules="none" frame="void"
83       cols="2" cellspacing="0" cellpadding="0">
84<tr valign="top" align="left">
85<td width="10%"></td><td width="90%">
86<b>-V</b>, <b>--version</b></td></table>
87
88<table width="100%" border=0 rules="none" frame="void"
89       cols="2" cellspacing="0" cellpadding="0">
90<tr valign="top" align="left">
91<td width="21%"></td><td width="79%">
92output version information and exit</td></table>
93
94<table width="100%" border=0 rules="none" frame="void"
95       cols="2" cellspacing="0" cellpadding="0">
96<tr valign="top" align="left">
97<td width="10%"></td><td width="90%">
98In normal operation mode, standard input is copied to
99standard output, with references to environment variables of
100the form $VARIABLE or ${VARIABLE} being replaced with the
101corresponding values. If a SHELL-FORMAT is given, only those
102environment variables that are referenced in SHELL-FORMAT
103are substituted; otherwise all environment variables
104references occurring in standard input are
105substituted.</td></table>
106
107<table width="100%" border=0 rules="none" frame="void"
108       cols="2" cellspacing="0" cellpadding="0">
109<tr valign="top" align="left">
110<td width="10%"></td><td width="90%">
111When <b>--variables</b> is used, standard input is ignored,
112and the output consists of the environment variables that
113are referenced in SHELL-FORMAT, one per line.</td></table>
114<a name="AUTHOR"></a>
115<h2>AUTHOR</h2>
116
117<table width="100%" border=0 rules="none" frame="void"
118       cols="2" cellspacing="0" cellpadding="0">
119<tr valign="top" align="left">
120<td width="10%"></td><td width="90%">
121Written by Bruno Haible.</td></table>
122<a name="REPORTING BUGS"></a>
123<h2>REPORTING BUGS</h2>
124
125<table width="100%" border=0 rules="none" frame="void"
126       cols="2" cellspacing="0" cellpadding="0">
127<tr valign="top" align="left">
128<td width="10%"></td><td width="90%">
129Report bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</td></table>
130<a name="COPYRIGHT"></a>
131<h2>COPYRIGHT</h2>
132
133<table width="100%" border=0 rules="none" frame="void"
134       cols="2" cellspacing="0" cellpadding="0">
135<tr valign="top" align="left">
136<td width="10%"></td><td width="90%">
137Copyright 2003-2006 Free Software Foundation, Inc.<br>
138This is free software; see the source for copying
139conditions. There is NO warranty; not even for
140MERCHANTABILITY or FITNESS FOR A PARTICULAR
141PURPOSE.</td></table>
142<a name="SEE ALSO"></a>
143<h2>SEE ALSO</h2>
144
145<table width="100%" border=0 rules="none" frame="void"
146       cols="2" cellspacing="0" cellpadding="0">
147<tr valign="top" align="left">
148<td width="10%"></td><td width="90%">
149The full documentation for <b>envsubst</b> is maintained as
150a Texinfo manual. If the <b>info</b> and <b>envsubst</b>
151programs are properly installed at your site, the
152command</td></table>
153
154<table width="100%" border=0 rules="none" frame="void"
155       cols="2" cellspacing="0" cellpadding="0">
156<tr valign="top" align="left">
157<td width="21%"></td><td width="79%">
158<b>info envsubst</b></td></table>
159
160<table width="100%" border=0 rules="none" frame="void"
161       cols="2" cellspacing="0" cellpadding="0">
162<tr valign="top" align="left">
163<td width="10%"></td><td width="90%">
164should give you access to the complete manual.</td></table>
165<hr>
166</body>
167</html>
168