About...
--------

			 Modemu Version 0.0.1
			 ====================
				   
		Copyright (c) 1995, 1996 Toru Egashira

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


NOTICE
------

This program is, as the version number saids, in the ALPHA development
stage.  Don't expect the next version (if exists) will be compatible
with this version.  And especially, DON'T EXPECT IT IS SAFE.  (Of
course, the author thinks this version works well for his purpose --
BBS access via Internet.)


What is Modemu?
---------------

Modemu is a TELNET client with a modem-like user interface.  It can
redirect its I/O to a pty so that a comm program can handle the pty as
a tty with a real modem.


Compilation
-----------

On Linux, just type "make".  Other systems require some changes in
Makefile and/or sources.  "Make install" is not supported.  Just copy
the executable file "modemu" to a directory in your $PATH.  Only the
executable file is required to run.

Making SOCKSified or Termified Modemu also requires changes in
Makefile.  Revive some commented-out lines and rewrite directory
specifications to reflect your configurations.


Sample Usage
------------

1) Stand alone usage

  Invoked with no option,

  > modemu

  Modemu reads from standard input and writes to standard output.
  Input

  > atd"localhost

  (prompt ">" is not shown) and you will see your host's login prompt.
  When logout, you will get "NO CARRIER" indication.
  Then input

  > at%q

  to quit Modemu.

2) With a comm program

  (This example uses XC as the comm program. The author haven't tested
  any other programs.)

  Invoke with "-c" option,

  > modemu -c "xc -l tty%s"

  you see XC runs. Go to the terminal mode and input

  > atd"localhost

  Yes, Modemu makes the comm program a TELNET client.  Now you can use
  comm program's scripting and file xfer(*) facilities on TELNET.

  To quit Modemu, just quit the comm program.

(*) Almost all file xfer protocols require 8bit through connection,
which means Modemu must be in the binary transmission mode.  See %B
command description in man pages.


Any Ideas?
----------

Bug fixes/reports, comments, suggestions and useful usage examples are
welcome.  Send e-mails to:
	toru@jms.jeton.or.jp (preferably), or
	egashira@nwk.CL.nec.co.jp

Messages in Japanese are of course welcome.


History
-------

v0.0 (950406)
 - Initial public release.

v0.0.1 (960113)
 - Fixed the "connect()-2: .." bug.
   Merely the v0.0 of "fix1" applied, thus no new features are added.