xboard serial line (modem) support
----------------------------------

Even if the Unix machine on which you want to run xboard is not
directly on the Internet, if you can communicate with the ICS by
running a terminal emulator and dialing up (or otherwise connecting
through a serial line) to a machine that is on the Internet, you can
still use xboard, by following the instructions below.

NOTE: If you can run telnet on your Unix machine to connect to the
ICS, you don't need these instructions.  Even if you telnet or rlogin
to another machine first, you don't need these instructions.  You need
them only if your first hop off the Unix machine on which you will be
running xboard is over a serial line (modem) that is running just a
simple login session (not SLIP or PPP).  In all other cases, see the
xboard man page for instructions.  Most people who do need the
instructions in this file are folks with home PCs that run Linux but
are not on the Internet.

****** General case instructions *********************************

[Skip this and look further down if you have Linux.]

Give a command something like this:

	stty raw -echo ; xboard -ics -icscomm /dev/tty00 ; stty -raw echo

Here replace "/dev/tty00" with the name of the serial device that your
modem is connected to.

You might have to give another stty command first to change /dev/tty00
to be in the right mode.  Something like this:

	stty raw -echo 9600 > /dev/tty00

You might have to add a bunch more options.  See the man pages for
stty(1) and tty(4) if you run into problems.  Also, on some systems
stty works on its standard input instead of standard output, so you
have to put "<" instead of ">".

The need for these mysterious stty commands is why this stuff is not
in the regular xboard man page.  It would be possible to have xboard
do the setings by making the system calls itself, but the details vary
widely depending on whether you have a Berkeley or System-V derived
Unix, or one of the more recent hybrids.

****** Linux instructions *********************************

The following shell script for Linux is from Maarten Remkes.  If you
have problems with it, look at the general instructions above for a
little more help.  Maarten writes:

> Hi Tim
> 
> Here's the shell script I promised to send you which at least for me
> makes xboard3.1.0 work on a serial line on my Linux system.
> 
> There is only on little hitch .. but I'm not really sure whether that's
> xboard related at all. The problem is that sometimes, particularly when
> using programs like telnet (who uses telnet anyway :-)  backspaces aren't
> shown on the screen; they _are_ being sent however. No big deal anyway.
> 
> There appears to be no need to invoke yet another xterm to inquire about
> or configure the controlling xterm: this runs all fine from only one xterm.
> 
> There are quite a few stty settings for the modem; I am not sure whether
> they are all really needed but certainly they won't hurt and this combination
> does work for me.
> 
> Ok here goes:

##########################################################################
#!/bin/sh -f
# configure xterm and modem and fire up xboard

# configure controlling terminal
(
stty 2400
stty raw
stty -echo
stty opost
) < /dev/tty

# configure modem
(
stty 2400
stty raw
stty hupcl 
stty -clocal 
stty ignbrk 
stty ignpar 
stty ixon 
stty ixoff 
stty -iexten 
stty -echo
) < /dev/modem

xboard -ics -icscomm /dev/modem
##########################################################################
