Module Name: othersrc
Committed By: wiz
Date: Wed May 29 14:50:24 UTC 2013
Modified Files:
othersrc/usr.bin/window: window.1
Log Message:
- White space corrections;
- remove NetBSD OS specific notes regarding window(1) and tmux(1);
- extend `HISTORY' section, regarding window(1)'s removal from
NetBSD;
- bump date.
>From Bug Hunting.
To generate a diff of this commit:
cvs rdiff -u -r1.1.1.1 -r1.2 othersrc/usr.bin/window/window.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: othersrc/usr.bin/window/window.1
diff -u othersrc/usr.bin/window/window.1:1.1.1.1 othersrc/usr.bin/window/window.1:1.2
--- othersrc/usr.bin/window/window.1:1.1.1.1 Thu Feb 16 04:06:56 2012
+++ othersrc/usr.bin/window/window.1 Wed May 29 14:50:24 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: window.1,v 1.1.1.1 2012/02/16 04:06:56 jmmv Exp $
+.\" $NetBSD: window.1,v 1.2 2013/05/29 14:50:24 wiz Exp $
.\"
.\" Copyright (c) 1985, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -32,7 +32,7 @@
.\"
.\" @(#)window.1 8.2 (Berkeley) 12/30/93
.\"
-.Dd August 13, 2011
+.Dd May 29, 2013
.Dt WINDOW 1
.Os
.Sh NAME
@@ -49,21 +49,6 @@ implements a window environment on
.Tn ASCII
terminals.
.Pp
-Please note that
-.Nm
-is scheduled for removal on
-.Nx 7.0 .
-This is the last
-.Nx
-release that provides
-.Nm .
-Use
-.Xr tmux 1
-instead, or install the
-.Pa pkgsrc/misc/window
-package from
-.Xr pkgsrc 7 .
-.Pp
A window is a rectangular portion of the physical terminal
screen associated with a set of processes.
Its size and position can be changed by the user at any time.
@@ -102,14 +87,14 @@ and create the two default
windows instead.
.It Fl e Ar escape-char
Set the escape character to
-.Ar escape-char .
+.Ar escape-char .
.Ar Escape-char
can be a single character, or in the form
.Ic ^X
where
.Ar X
is any character, meaning
-.No control\- Ns Ar X .
+.No control\- Ns Ar X .
.It Fl f
Fast.
Don't perform any startup action.
@@ -129,7 +114,7 @@ This one-character
identifier, as well as a user definable label string, are displayed
with the window on the top edge of its frame.
A window can be designated to be in the
-.Ar foreground ,
+.Ar foreground ,
in which case it will always be
on top of all normal, non-foreground windows, and can be covered
only by other foreground windows.
@@ -169,7 +154,7 @@ entry tailored to this window is created
and passed as environment (see
.Xr environ 7 )
variable
-.Ev TERMCAP .
+.Ev TERMCAP .
The termcap entry contains the window's size and
characteristics as well as information from the physical terminal,
such as the existence of underline, reverse video, and other display
@@ -224,7 +209,7 @@ to
corresponding to the windows 1 to 9.
.Ic ^X
means
-.No control\- Ns Ar X ,
+.No control\- Ns Ar X ,
where
.Ar X
is any character.
@@ -638,7 +623,7 @@ as a statement, the parentheses surround
the argument list may be omitted.
Aliases return no value.
.El
-.Ss Builtin Functions
+.Ss Builtin Functions
The arguments are listed by name in their natural order.
Optional arguments are in square brackets
.Sq Op ""
@@ -679,12 +664,12 @@ Close the windows specified in
If
.Aq Ar window\-list
is the word
-.Ar all ,
+.Ar all ,
than all windows are closed.
No value is returned.
.It Ic cursormodes Ns Pq Bq Ar modes
Set the window cursor to
-.Ar modes .
+.Ar modes .
.Ar Modes
is the bitwise
or of the mode bits defined as the variables
@@ -705,7 +690,7 @@ sets the window cursors to blinking
reverse video.
.It Ic default_nline Ns Pq Bq Ar nline
Set the default buffer size to
-.Ar nline .
+.Ar nline .
Initially, it is
48 lines.
Returns the old default buffer size.
@@ -718,7 +703,7 @@ Returns
the first string in the old shell setting.
Default is no change.
Initially, the default shell is taken from the environment variable
-.Ev SHELL .
+.Ev SHELL .
.It Ic default_smooth Ns Pq Bq Ar flag
Set the default value of the
.Ar smooth
@@ -727,12 +712,12 @@ to the command
.Nm
(see below).
The argument is a boolean flag (one of
-.Ar on ,
-.Ar off ,
-.Ar yes ,
-.Ar no ,
-.Ar true ,
-.Ar false ,
+.Ar on ,
+.Ar off ,
+.Ar yes ,
+.Ar no ,
+.Ar true ,
+.Ar false ,
or a number,
as described above).
Default is no change.
@@ -754,7 +739,7 @@ No value is returned.
Default is the current window.
.It Ic escape Ns Pq Bq Ar escapec
Set the escape character to
-.Ar escape-char .
+.Ar escape-char .
Returns the old
escape character as a one-character string.
Default is no change.
@@ -781,7 +766,7 @@ is no change.
Set the label of
.Nm
to
-.Ar label .
+.Ar label .
Returns the old
label as a string.
Default for
@@ -803,11 +788,11 @@ The previous current window is returned.
Default is no change.
.It Ic source Ns Pq Ar filename
Read and execute the long commands in
-.Ar filename .
+.Ar filename .
Returns \-1 if the file cannot be read, 0 otherwise.
.It Ic terse Ns Pq Bq flag
Set terse mode to
-.Ar flag .
+.Ar flag .
In terse mode, the command window
stays hidden even in command mode, and errors are reported by
sounding the terminal's bell.
@@ -820,14 +805,14 @@ Returns the old terse flag.
Default is no change.
.It Ic unalias Ns Pq Ar alias
Undefine
-.Ar alias .
+.Ar alias .
Returns -1 if
.Ar alias
does not exist,
0 otherwise.
.It Ic unset Ns Pq Ar variable
Undefine
-.Ar variable .
+.Ar variable .
Returns -1 if
.Ar variable
does not exist,
@@ -841,20 +826,20 @@ Bo Ar ncol Bc , Bo Ar nline Bc , Bo Ar l
Bo Ar frame Bc , Bo Ar mapnl Bc , Bo Ar keepopen Bc , Bo Ar smooth Bc , \
Bo Ar shell Bc ) .
Open a window with upper left corner at
-.Ar row ,
+.Ar row ,
.Ar column
and size
-.Ar nrow ,
-.Ar ncol .
+.Ar nrow ,
+.Ar ncol .
If
.Ar nline
is specified,
then that many lines are allocated for the text buffer.
Otherwise, the default buffer size is used.
Default values for
-.Ar row ,
-.Ar column ,
-.Ar nrow ,
+.Ar row ,
+.Ar column ,
+.Ar nrow ,
and
.Ar ncol
are, respectively,
@@ -862,8 +847,8 @@ the upper, left-most, lower, or right-mo
screen.
.Ar Label
is the label string.
-.Ar Frame ,
-.Ar pty ,
+.Ar Frame ,
+.Ar pty ,
and
.Ar mapnl
are flag values
@@ -892,7 +877,7 @@ command (see above).
is a list of strings that will be used as the shell
program to place in the window (default is the program specified
by
-.Ar default_shell ,
+.Ar default_shell ,
see above).
The created window's identifier is returned as a number.
.It Ic write Ns ( Bo Ar window Bc , Bq Aq Ar string\-list )
@@ -983,3 +968,7 @@ The
.Nm
command appeared in
.Bx 4.3 .
+It was included in
+.Nx
+up to
+.Nx 7.0 .
