[xtoys] / xscsize.1

.TH xscsize 1 "15 November 1998" "Edgeware tools"
.SH NAME
xscsize \- return size of an X display to a shell script
.SH SYNOPSIS
.B xscsize
.RB [ \-bcx ]
.RB [ \-d
.IR display ]
.SH DESCRIPTION
The
.B xscsize
program interrogates an X display and writes the size of the root
window to standard output in the form of a shell variable assignment
statement.  The dimensions are returned in the
.B XWIDTH
and
.B XHEIGHT
variables.
.PP
Command line options can be used to force output in either Bourne or C
shell syntax.  In the absence of any explicit instructions,
.B xscsize
looks at the
.B SHELL
environment variable to help make its mind up.
.PP
Typical use would be something like
.RS 5
.ft B
.nf
eval `xscsize`
.ft R
.fi
.SS OPTIONS
.TP 5
.BI "\-d, \-\-display " display
Choose which display to connect to.
.TP 5
.B \-b, --bourne-shell
Output the assignments in Bourne shell syntax (usable by Bourne,
POSIX, Korn, Z and Bourne Again shells).
.TP 5
.B \-c, --c-shell
Output the assignments in C shell syntax (usable by C and Terminal C
shells).
.TP 5
.B \-x, --export
Output a variable export command, so that the screen size is inherited
by child processes.  The default is to just set local shell variables.
.SH ENVIRONMENT
.TP
.B XWIDTH
Set to the width of the display in pixels.
.B XHEIGHT
Set to the height of the display in pixels.
.B SHELL
Used to decide the nature of the calling shell.  If absent, a Bourne
shell is assumed.
.SH AUTHOR
Mark Wooding (mdw@nsict.org).
.SH BUGS
Hopefully none.
Commit	Line	Data
90b2c5d4	1	.TH xscsize 1 "15 November 1998" "Edgeware tools"
	2	.SH NAME
	3	xscsize \- return size of an X display to a shell script
	4	.SH SYNOPSIS
	5	.B xscsize
	6	.RB [ \-bcx ]
	7	.RB [ \-d
	8	.IR display ]
	9	.SH DESCRIPTION
	10	The
	11	.B xscsize
	12	program interrogates an X display and writes the size of the root
	13	window to standard output in the form of a shell variable assignment
	14	statement. The dimensions are returned in the
	15	.B XWIDTH
	16	and
	17	.B XHEIGHT
	18	variables.
	19	.PP
	20	Command line options can be used to force output in either Bourne or C
	21	shell syntax. In the absence of any explicit instructions,
	22	.B xscsize
	23	looks at the
	24	.B SHELL
	25	environment variable to help make its mind up.
	26	.PP
	27	Typical use would be something like
	28	.RS 5
	29	.ft B
	30	.nf
	31	eval `xscsize`
	32	.ft R
	33	.fi
	34	.SS OPTIONS
	35	.TP 5
f3b35b6b	36	.BI "\-d, \-\-display " display
	37	Choose which display to connect to.
	38	.TP 5
	39	.B \-b, --bourne-shell
90b2c5d4	40	Output the assignments in Bourne shell syntax (usable by Bourne,
	41	POSIX, Korn, Z and Bourne Again shells).
	42	.TP 5
f3b35b6b	43	.B \-c, --c-shell
90b2c5d4	44	Output the assignments in C shell syntax (usable by C and Terminal C
	45	shells).
	46	.TP 5
f3b35b6b	47	.B \-x, --export
90b2c5d4	48	Output a variable export command, so that the screen size is inherited
	49	by child processes. The default is to just set local shell variables.
	50	.SH ENVIRONMENT
	51	.TP
	52	.B XWIDTH
	53	Set to the width of the display in pixels.
	54	.B XHEIGHT
	55	Set to the height of the display in pixels.
	56	.B SHELL
	57	Used to decide the nature of the calling shell. If absent, a Bourne
	58	shell is assumed.
	59	.SH AUTHOR
	60	Mark Wooding (mdw@nsict.org).
	61	.SH BUGS
	62	Hopefully none.