WTERM(1)			W-PROGRAMS			WTERM(1)

NAME

	wterm

SYPNOSIS

	wterm [-b] [-f <fontname>] [-g <geometry>] [-c] [-v] [-h] \
	      [program {args}]

DESCRIPTION

	 wterm is the *powerfull* terminal frontend for `w'...

	 harhar... <evil-grin> ;-)

	 well, it's a program emulating a `wterm' terminal to run a shell in
	it. you can specify which font to use with the `-f' option. for the
	moment the distribution only includes the original Atari system fonts,
	but if you've designed some others you can also use them as font
	loading works from W0R7 on.

	 the `wterm' terminal mainly has VT52 escape codes with four
	extentions:

	ESC g	to enter bold mode and

	ESC h	to clear bold and reverse mode, but not underline mode

	ESC i	to enter underline mode

	ESC m	to exit underline mode

	 you may use the sample termcap entry which is in the root dir
	of archive w1r1.tgz, it works well for me...

	 you may use the geometry option `-g' to use larger fonts with smaller
	screens than 80*25. the option takes an argument like:

		80,25,0,0

	 say, four values for columns, lines, x-position and y-position,
	seperated by `,'. in the case of wterm columns and lines are counted
	in characters, not pixels. the position part may either be ommitted
	(in which case you'll have to place the window) or may give the window
	position in pixels on the screen. if you give a negative number the
	value will be counted from the opposite border on instead of the upper
	left corner. note that -0 is explicitly a legal value. see manpage for
	scan_geometry for more info.

	 if you want this wterm to emulate the physical console, you may give
	the option `-c'. this will catch output done to the console by any
	possible program (including MiNT debugging output) and write it in the
	window. W1R1 with the XDD driver should be much saver than previous
	versions so you shouldn't need to worry about this. but then: it's your
	risk what you do or not. see README in xconout2 for some more info.

	 the default is a steady cursor. if you give option `-b' you'll get a
	blinking cursor instead.

	 if you rather want a visual bell than a beep for ASCII 7, you can
	give the `-v' option on the command line.

	 option `-h' stands for `help' and only shows you the usage line.

	 you may give the command to start at the end of the command line and
	can also pass any number of arguments to it. if you don't give a
	command the shell given by the environment variable SHELL is started.
	if this variable doesn't exist, the login shell from your /etc/passwd
	entry is used. if the specified program fails to exist, not very much
	will happen...

SEE ALSO

	scangeometry(3)

LAST CHANGED

	12/94 by TeSche, itschere@techfak.uni-bielefeld.de
