home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / network / conferences / ytalk.3.0.README < prev   
Encoding:
Text File  |  1994-03-17  |  6.5 KB  |  157 lines
  1.  
  2.  
  3.  
  4. YTalk(1)            UNIX Programmer's Manual             YTalk(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      ytalk - A multi-user chat program.
  10.  
  11. SYNOPSIS
  12.      ytalk [-x] [-s] username...
  13.  
  14. DESCRIPTION
  15.      YTalk V3.0 Patch Level 2
  16.  
  17.      YTalk is in essence a multi-user chat program.  It works
  18.      almost exactly like the UNIX talk program and even communi-
  19.      cates with the same talk daemon(s), but YTalk allows for
  20.      multiple connections.
  21.  
  22.      The username field may be formatted in several different
  23.      ways:
  24.           name          - some user on your machine
  25.           name@host     - some user on a different machine
  26.           name#tty      - some user on a particular terminal
  27.           name#tty@host - some user on a particular tty on a
  28.                           different machine
  29.           name@host#tty - same as "name#tty@host"
  30.  
  31.      You can specify multiple user names on the command line, ie:
  32.  
  33.           ytalk george fred@hissun.edu marc@grumpy.cc
  34.  
  35.      The -x option disables the X11 interface (described below).
  36.  
  37.      The -s option starts your YTalk window in a shell.
  38.  
  39.      For each user on the command line, YTalk will attempt to
  40.      connect to the talk daemon on the specified user's host and
  41.      determine if that user has left an invitation for you to
  42.      call.  If not, YTalk leaves an invitation for him and tells
  43.      his talk daemon to send an announcement to his screen.
  44.      There is not yet a dedicated YTalk daemon, but there will
  45.      be.  Right now, YTalk is able to communicate with BOTH
  46.      existing versions of UNIX talk daemons.  For any particular
  47.      host, YTalk will attempt to communicate with a talk daemon
  48.      the caller's host also supports.  If the two hosts have no
  49.      daemon in common, then UNIX talk will not function at all,
  50.      but a connection is possible through (and only through)
  51.      YTalk.
  52.  
  53.      Once a connection has been established between two users,
  54.      they can chat back and forth to their hearts' content.  The
  55.      connection is terminated when one of them hits control-C or
  56.      selects quit off the main menu.
  57.  
  58.      YTalk is perfectly compatible with UNIX talk and they can
  59.      even converse with each other without any problems.
  60.      However, many of the features of YTalk can only operate when
  61.      you are connected to a user who is also using YTalk.  For
  62.      the rest of this document, it will be assumed that all con-
  63.      nected users are using YTalk, unless otherwise stated.
  64.  
  65.      If you specified more than one user on the YTalk command
  66.      line, then YTalk will process and add each user to the
  67.      conversation as they respond to your invitation.  As each
  68.      new user enters the conversation, the screen is further sub-
  69.      divided into smaller and smaller windows, one for each con-
  70.      nected user.  Right now, the number of connected users is
  71.      limited by the number of lines on your terminal (or window),
  72.      for each connected user needs at least three lines.
  73.  
  74.      YTalk does implement primitive support of the X11 Windowing
  75.      System.  If the environment variable DISPLAY is set, then
  76.      YTalk attempts to connect to that X server.  Further details
  77.      about the X11 interface (and how to turn it off) are given
  78.      below.
  79.  
  80.      As each new user is added to the conversation, YTalk will
  81.      transmit information about that user to all other connected
  82.      YTalk users so that their screens will also subdivide and
  83.      incorporate the new user.  If the new user is using UNIX
  84.      talk, then information about him will NOT be transmitted,
  85.      for his screen would be unable to accept multiple connec-
  86.      tions.  I have given brief thought to allowing at least the
  87.      output of UNIX talk users to be transmitted to all connected
  88.      YTalk users, but I have not written any code to do so.  Note
  89.      that even though UNIX talk cannot handle multiple connec-
  90.      tions, it is still possible for YTalk to handle multiple
  91.      UNIX "talk" connections.  For example, george (using YTalk)
  92.      could communicate with fred and joe (both using UNIX talk),
  93.      but fred and joe would be unaware of each other.  The best
  94.      way to understand the limitations that UNIX "talk" places on
  95.      YTalk is to test various connections between the two and see
  96.      how things work.
  97.  
  98. ESCAPE MENU
  99.      Whenever you are using YTalk, you can hit the ESCAPE key to
  100.      bring up a menu which at this moment has these options:
  101.  
  102.              a: add a user
  103.              d: delete a user
  104.              o: options
  105.              s: shell
  106.              u: user list
  107.              w: output user to file
  108.              q: quit
  109.  
  110.      By choosing option "a", you are given the opportunity to
  111.      type the name of any user you wish to include into the
  112.      conversation.  Again, YTalk will accept an invitation from
  113.      that user if an invitation exists, or will leave an invita-
  114.      tion and ring the given user.
  115.  
  116.      By choosing option "d", you can select the name of a connec-
  117.      tion to terminate.
  118.  
  119.      By choosing option "o", you can view and/or modify any of
  120.      the YTalk options.  See the OPTIONS section below for a list
  121.      of YTalk options.
  122.  
  123.      By choosing option "s", you can invoke a shell in your YTalk
  124.      window.  All other users will see what happens in your
  125.      shell.  YTalk will automatically resize your window down to
  126.      the size of the smallest window you are connected to, in
  127.      order to ensure that all users always see the same thing.
  128.  
  129.      The "u" option displays a list of connected and unconnected
  130.      users, as well as their window sizes and what version of
  131.      talk software they are running.
  132.  
  133.      By choosing option "w", you can select any connected user
  134.      and type the name of a file, and all further output from
  135.      that user will be dumped to the specified file.  The file,
  136.      if it exists, will be OVERWRITTEN.  By choosing "w" and the
  137.      same user again, further output to the file will be ter-
  138.      minated.
  139.  
  140.      Oh, one other thing:  when user A attempts to ytalk to user
  141.      B, but user B is already ytalking with user C, user A's
  142.      YTalk program will realize that user B is already using
  143.      YTalk, and will communicate with user B's YTalk program
  144.      directly in order to initialize the conversation.  User B
  145.      will see a nice windowed message like:
  146.  
  147.           Do you wish to talk with user A?
  148.  
  149.      and he will be prompted for a yes/no answer.  This, in my
  150.      opinion, is much preferable to blitting the announcement
  151.      message and messing up user B's screen.
  152.  
  153.  
  154. RUNTIME OPTIONS
  155.      When you select Options off of the main menu, you are given
  156.      the opportunity to edit the YTalk options.  The current
  157.      op