This product is not designed to be installed by novices, but perhaps
they can do the job too, with a little thinking.

For infomation about switches, read the included manpage.

Smodem is a bidirectional filetransfer protocol with chat.
Porting smodem for Linux is a part of my DayDream/Unix-
project. DayDream is a conference-based bulletin board system (like
PCBoard, AmiExpress, Desire etc..) for Linux. It should also work on
other unices, at least it works on FreeBSD.

SModem is designed to be run by Minicom or DayDream BBS, but any
bbs software can use it.. Without -p parameter smodem uses stdio
as the terminal and doesn't open any kind of user interface, so
it's possible for dos users to transfer files by using smodem at
the unix end.


Installation
------------

To install SModem for use with minicom, you must apply the included patch
(minicom-hydra.patch) (try "patch -p0 <minicom-hydra.patch" in minicom
source directory.). There was a nasty bug in minicom, which caused it to
lock up after hydra-session.

Then you must install smodem to the list of filetransfer protocols. Here
are nice defaults:

 I  smodem     /usr/local/bin/smodem -p %l               N   D   Y   N
 J  smodem     /usr/local/bin/smodem -p %l               Y   U   Y   N
 ^  ^           ^                                                ^
 |  |           |                                                |
 |  |           |                                                +-- flags :)
 |  |           +------------------------------------------ command
 |  +------------------------------------------------------ protocol name
 +--------------------------------------------------------- protocol ID

I hope you got the point :)

Also make use you have /usr/share/terminfo/ available - smodem depends on it.
If smodem tells you that 'unknown terminal type blabalbla", try

ln -s /usr/lib/terminfo /usr/share/terminfo.


Known problems
--------------

 - No batch viewing like in amiga/dos version. This is because ncurses
   doesn't support overlapping windows.
 - Scandinavian characters don't work in chat. This is because forms doesn't
   allow them as input characters (it uses isprint(), and libc has a 
   "bug" - it thinks that '' is not a printable character!)
 - On some systems smodem doesn't work in stdio mode. Dunno why.

Changes
-------
  1.0beta -> 1.0
  ~~~~~~~~~~~~~~

     - Recompiled using ncurses 4.0
     - Fixed a bug which sometimes caused crashing with dos smodem.
     - Adding files to ul-batch supports wildcards now.

  1.0 -> 1.01 
  ~~~~~~~~~~~

     - Fixed some compatibility problems with ms-dos smodem :)

  1.01 -> 1.02
  ~~~~~~~~~~~~

     - Rewrote serial routines. Smodem should be much more reliable
       now.


Other
-----
Minicom kills smodem if you press ctrl-c when transfering file, so it's
not a wise thing to press ctrl-c. Use <ctrl-x> to abort transfer - ctrl-x
sends a proper abort-sequence to the other end too.

To contact me, mail: hydra@pato.vaala.fi (Antti Hyrynen)
                BBS: +358-8-5409139

