Fri Jan 21 07:55:12 2011 UTC ()
Describe the new terminfo environment settings.


(roy)
diff -r1.23 -r1.24 src/share/man/man7/environ.7
cvs diff -r1.23 -r1.24 src/share/man/man7/environ.7 (expand / switch to unified diff)

--- src/share/man/man7/environ.7 2011/01/19 04:00:21 1.23
+++ src/share/man/man7/environ.7 2011/01/21 07:55:12 1.24
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: environ.7,v 1.23 2011/01/19 04:00:21 uwe Exp $ 1.\" $NetBSD: environ.7,v 1.24 2011/01/21 07:55:12 roy Exp $
2.\" 2.\"
3.\" Copyright (c) 1983, 1990, 1993 3.\" Copyright (c) 1983, 1990, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors 14.\" 3. Neither the name of the University nor the names of its contributors
@@ -19,27 +19,27 @@ @@ -19,27 +19,27 @@
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE. 28.\" SUCH DAMAGE.
29.\" 29.\"
30.\" @(#)environ.7 8.3 (Berkeley) 4/19/94 30.\" @(#)environ.7 8.3 (Berkeley) 4/19/94
31.\" 31.\"
32.Dd July 5, 2005 32.Dd January 21, 2011
33.Dt ENVIRON 7 33.Dt ENVIRON 7
34.Os 34.Os
35.Sh NAME 35.Sh NAME
36.Nm environ 36.Nm environ
37.Nd user process environment 37.Nd user process environment
38.Sh SYNOPSIS 38.Sh SYNOPSIS
39.Vt extern char ** Ns Dv environ ; 39.Vt extern char ** Ns Dv environ ;
40.Sh DESCRIPTION 40.Sh DESCRIPTION
41An array of strings called the 41An array of strings called the
42.Em environment 42.Em environment
43is made available by 43is made available by
44.Xr execve 2 44.Xr execve 2
45when a process begins. 45when a process begins.
@@ -178,56 +178,44 @@ When using the @@ -178,56 +178,44 @@ When using the
178.Xr rcmd 3 178.Xr rcmd 3
179function, this variable is used as the program to run instead of 179function, this variable is used as the program to run instead of
180.Xr rcmd 1 . 180.Xr rcmd 1 .
181.It Ev SHELL 181.It Ev SHELL
182The full pathname of the user's login shell. 182The full pathname of the user's login shell.
183.It Ev TERM 183.It Ev TERM
184The kind of terminal for which output is to be prepared. 184The kind of terminal for which output is to be prepared.
185This information is used by commands, such as 185This information is used by commands, such as
186.Xr nroff 1 186.Xr nroff 1
187.\" or 187.\" or
188.\" .Xr plot 1 188.\" .Xr plot 1
189which may exploit special terminal capabilities. 189which may exploit special terminal capabilities.
190See 190See
191.Pa /usr/share/misc/termcap 191.Pa /usr/share/misc/terminfo
192.Pq Xr termcap 5 192.Pq Xr terminfo 5
193for a list of terminal types. 193for a list of terminal types.
194.It Ev TERMCAP 194.It Ev TERMCAP
195The string describing the terminal in 195The string describing the terminal in
196.Ev TERM , 196.Ev TERM ,
197or, if it begins with a 197or, if it begins with a
198.Ql / , 198.Ql / ,
199the name of the termcap file. 199the name of the termcap file.
200See 200This is only checked if
201.Ev TERMPATH 201.Ev TERMINFO
202below, 202is not set.
203.Xr termcap 5 , 203.It Ev TERMINFO
204and 204The string describing the terminal in
205.Xr termcap 3 . 205.Ev TERM ,
206.It Ev TERMPATH 206or, if it begins with a
207A sequence of pathnames of termcap files, separated by colons or spaces, 207.Ql / ,
208which are searched for terminal descriptions in the order listed. 208the name of the terminfo file.
209Having no 
210.Ev TERMPATH 
211is equivalent to a 
212.Ev TERMPATH 
213of 
214.Pp 
215.Dl $HOME/.termcap:/usr/share/misc/termcap 
216.Pp 
217.Ev TERMPATH 
218is ignored if 
219.Ev TERMCAP 
220contains a full pathname. 
221.It Ev TIMEFORMAT 209.It Ev TIMEFORMAT
222A 210A
223.Xr strftime 3 211.Xr strftime 3
224format string that may be used by programs such as 212format string that may be used by programs such as
225.Xr dump 8 213.Xr dump 8
226for formatting timestamps. 214for formatting timestamps.
227.It Ev TMPDIR 215.It Ev TMPDIR
228The directory in which to store temporary files. 216The directory in which to store temporary files.
229Most applications use either 217Most applications use either
230.Pa /tmp 218.Pa /tmp
231or 219or
232.Pa /var/tmp . 220.Pa /var/tmp .
233Setting this variable will make them use another directory. 221Setting this variable will make them use another directory.
@@ -278,22 +266,23 @@ unless you know what you are doing. @@ -278,22 +266,23 @@ unless you know what you are doing.
278.Xr csh 1 , 266.Xr csh 1 ,
279.Xr ex 1 , 267.Xr ex 1 ,
280.Xr login 1 , 268.Xr login 1 ,
281.Xr man 1 , 269.Xr man 1 ,
282.Xr more 1 , 270.Xr more 1 ,
283.Xr sh 1 , 271.Xr sh 1 ,
284.Xr execve 2 , 272.Xr execve 2 ,
285.Xr _DIAGASSERT 3 , 273.Xr _DIAGASSERT 3 ,
286.Xr execle 3 , 274.Xr execle 3 ,
287.Xr malloc 3 , 275.Xr malloc 3 ,
288.Xr rcmd 3 , 276.Xr rcmd 3 ,
289.Xr system 3 , 277.Xr system 3 ,
290.Xr termcap 3 , 278.Xr termcap 3 ,
 279.Xr terminfo 3 ,
291.Xr audio 4 , 280.Xr audio 4 ,
292.Xr termcap 5 , 281.Xr terminfo 5
293.Xr nls 7 , 282.Xr nls 7 ,
294.Xr dump 8 283.Xr dump 8
295.Sh HISTORY 284.Sh HISTORY
296The 285The
297.Nm 286.Nm
298manual page appeared in 287manual page appeared in
299.Bx 4.2 . 288.Bx 4.2 .