.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
.B \-b
Output the assignments in Bourne shell syntax (usable by Bourne,
POSIX, Korn, Z and Bourne Again shells).
.TP 5
.B \-c
Output the assignments in C shell syntax (usable by C and Terminal C
shells).
.TP 5
.B \-x
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.