.\" -*-nroff-*-
.TH xscsize 1 "15 November 1998" "Straylight/Edgeware" "xtoys"
.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 BUGS
Hopefully none.
.SH AUTHOR
Mark Wooding (mdw@distorted.org.uk).