initial commit into svn repository

git-svn-id: http://svn.klever.net/kin/T42/trunk@1 fe716a7a-6dde-0310-88d9-d003556173a8

6 files changed, 424 insertions, 0 deletions

diff --git a/help/T42.cnt b/help/T42.cnt
new file mode 100644
index 0000000..e30ddb8
--- a/dev/null
+++ b/help/T42.cnt
@@ -0,0 +1,16 @@
+:Base T42.hlp>Standard

+:Title T42

+1 T42

+2 About T42=About

+2 What's New=News

+2 Using T42=Using

+2 Options

+3 T42 Options=Options

+3 General Options=GeneralOptions

+3 Fonts=FontsOptions

+3 Sounds=SoundsOptions

+3 Secretary Options=SecretaryOptions

+2 Windows

+3 Main Window=MainWindow

+3 Conversation Window=ConversationWindow

+3 Announce Dialog=AnnounceDialog

diff --git a/help/T42.hpj b/help/T42.hpj
new file mode 100644
index 0000000..d7ad056
--- a/dev/null
+++ b/help/T42.hpj
@@ -0,0 +1,31 @@
+; This file is maintained by HCW. Do not modify this file directly.

+

+[OPTIONS]

+COMPRESS=12 Hall Zeck

+LCID=0x409 0x0 0x0 ; English (United States)

+REPORT=Yes

+TITLE=T42

+CNT=T42.cnt

+HLP=T42.HLP

+

+[FILES]

+T42.rtf

+

+[ALIAS]

+HIDD_ABOUTBOX=About

+HIDD_ANNOUNCE=AnnounceDialog

+HIDD_OPTIONS_FONTS=FontsOptions

+HIDD_OPTIONS_GENERAL=GeneralOptions

+HIDD_OPTIONS_SECRETARY=SecretaryOptions

+HIDD_OPTIONS_SOUNDS=SoundsOptions

+HIDD_REMOTE=RemoteDialog

+HIDD_T42_DIALOG=MainWindow

+HIDD_T42VIEW=ConversationWindow

+HIDR_MAINFRAME=MainWindow

+HIDR_T42FRAME=ConversationWindow

+

+[MAP]

+#include T42.hm

+

+[WINDOWS]

+Standard="",(1,1,698,940),20740,(r14876671),(r12632256),f2

diff --git a/help/T42.rtf b/help/T42.rtf
new file mode 100644
index 0000000..678738a
--- a/dev/null
+++ b/help/T42.rtf
@@ -0,0 +1,194 @@
+{\rtf1\ansi

+@{\footnote

+THIS FILE WAS AUTOMATICALLY GENERATED FROM XML DOCUMENT.

+DO NOT MODIFY THIS FILE DIRECTLY. EDIT XML DOCUMENT INSTEAD

+}

+{\fonttbl{\f0\froman Times New Roman;}{\f1\fswiss Arial;}{\f3\froman Symbol;}}{\colortbl;

+   \red0\green0\blue0;\red0\green0\blue255;\red0\green255\blue255;\red0\green255\blue0;

+   \red255\green0\blue255;\red255\green0\blue0;\red255\green255\blue0;\red255\green255\blue255;

+   \red0\green0\blue128;\red0\green128\blue128;\red0\green128\blue0;\red128\green0\blue128;

+   \red128\green0\blue0;\red128\green128\blue0;\red128\green128\blue128;\red192\green192\blue192;}

+  

+\pard\plain\keepn

+#{\footnote About}

+${\footnote About T42}

+{ \f1\fs18\b\sb120 About {\b T42}}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 {\b T42} is our {\i Win32} implementation of {\b\cf6 unix}{\b\cf6 ntalk} protocol.

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 It features:\pard

+\par \fi0\li0 \bullet   {\b Multihoming} - works properly on multihomed machines (ie. accepts connections/issues requests on all interfaces);

+\par \fi0\li0 \bullet   {\b Your personal secretary} - technically speaking, something like answering machine;

+\par \fi0\li0 \bullet   {\b Sleep function} - be notified of activities in backgrounded windows;\pard

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Designed to be compatible with our {\i TFTP} client/server, {\uldb {\b PumpKIN}}{\v %!ExecFile("http://www.klever.net/kin/pumpkin.html")}, that allows you to exchange files with your party while having talk sessions.

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 {\b {\i Enjoy!}}

+{

+\par\pard\plain\sb360\sa120 \f1\fs16 Copyright (c) 1998, 2002 {\uldb\cf0 Klever Group (http://www.klever.net/)}{\v %!ExecFile("http://www.klever.net/")}

+\par\qj\sb120\sa120Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

+\par The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

+\par \sa360 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

+}

+\par \sa0\sb120\ql \f1\fs16 Author: {\b\uldb\cf11 Michael Krelin ({\i hacker@klever.net})}{\v %!ExecFile("mailto:hacker@klever.net")}

+\par \sa0\sb0 Fan mail send to {\i\uldb gefilte@klever.net}{\v %!ExecFile("mailto:gefilte@klever.net")}

+\page

+

+\pard\plain

+#{\footnote News}

+${\footnote What's New}

+\par\pard\plain\f1\fs24\qc\cf2\b 1.5 - August 19th, 2002

+\par\pard\plain\fi0\li0\f1\fs18 \bullet  Change of license and opening the source

+\page

+

+\pard\plain\keepn

+#{\footnote Using}

+${\footnote Using T42}

+{ \f1\fs18\b\sb120 Using {\b T42}}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Once you've installed {\b T42}, run it from {\i Programs/Accessories/Klever Co.} menu. A small cup icon will appear in the notification tray area.

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Left-click on the icon will get you to the {\uldb Main Window}{\v MainWindow}, right-click  brings up the following menu:\pard

+\par \fi0\li0 \bullet   {\b Order some tea} - Initiates talk session. This will open new {\uldb Conversation Window}{\v ConversationWindow} and prompt you for request details.

+\par \fi0\li0 \bullet   {\b Away} - Toggle your away mode. It affects the way {\b T42} handles incoming calls. See {\uldb Main Window}{\v Mainwindow} for details.

+\par \fi0\li0 \bullet   {\b Show Main Window} - Toggle visibility of the {\uldb Main Window}{\v MainWindow} from which you can control some of {\b T42} options and read/maintain your recorded messages.

+\par \fi0\li0 \bullet   {\b Options} - Select this to bring up {\uldb Options dialog}{\v Options} so that you can customize {\b T42} to suit your needs.

+\par \fi0\li0 \bullet   {\b Exit} - This is not likely to happen, but if you want to exit {\b T42} and unload it from memory - that's what {\b Exit} is for.\pard

+\page

+

+\pard\plain\keepn

+#{\footnote MainWindow}

+${\footnote Main Window}

+{ \f1\fs18\b\sb120 Main {\b T42} Window}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Main Window is a {\b T42} Control Center, it's exactly mouse-click away from most of {\b T42} functions. It consists of\pard

+\par \fi0\li0 \bullet   {\b On Call} and {\b On Call when away} dropdown lists let you select the action to take when incoming call occurs in 'normal' and 'away' mode. Chose one of

+    \pard

+\par \fi0\li0 \bullet   {\i Prompt} - Ask you what to do before taking any actions;

+\par \fi0\li0 \bullet   {\i Secretary} - Relay incoming calls to your {\uldb personal secretary}{\v SecretaryOptions}. Some prefer to call it answering machine.

+\par \fi0\li0 \bullet   {\i Not here} - Tell the caller you're not here ({\i not logged in}) and terminate connection.

+\par \fi0\li0 \bullet   {\i Refuse} - Tell the caller you're not accepting messages and terminate connection.

+\par \fi0\li0 \bullet   {\i Ignore} - Pretend that you didn't notice.\pard

+\par \fi0\li0 \bullet   {\b Away} button toggles your away mode. When an incoming call occurs {\b T42} takes action based upon away mode and options selected in {\b On Call} and {\b On Call when away} dropdown lists.

+\par \fi0\li0 \bullet   {\b Tea} button initiates new talk session. This will open new {\uldb Conversation Window}{\v ConversationWindow} and prompt you for {\uldb request details}{\v RemoteDialog}.

+\par \fi0\li0 \bullet   {\b Options} button brings up {\uldb Configuration Dialog}{\v Options} that lets you customize {\b T42} according to your needs.

+\par \fi0\li0 \bullet   {\b Exit} - button closes {\b T42} windows and removes {\b T42} from memory.

+\par \fi0\li0 \bullet   {\b Help} button enters the help system. If you got this far, you probably don't need further explanations.

+\par \fi0\li0 \bullet   {\b Recorded messages} list this is the list of messages recorded by your secretary. Messages are sorted by age, last ones first. Unanswered messages have a brighter cup icon unless you've explicitly marked the message as processed (see below for details). Right-click on the list entry presents you with popup menu from which you can:

+    \pard

+\par \fi0\li0 \bullet   {\i Call back} the person who left the message. This is identical to initiating new talk session and entering caller's data manually. Note: if the caller has a dynamic IP address and have already disconnected from his ISP and reconnected back this may not work.

+\par \fi0\li0 \bullet   {\i Delete} selected message(s). If you don't need recorded message anymore you can throw it away by selecting this.

+\par \fi0\li0 \bullet   {\i Save to file..} menu option lets you save message into {\i RTF} file. Then you may print message text, import it into your {\b\cf6 MS Word} documents or do with it whatever you want.

+\par \fi0\li0 \bullet   {\i Mark as new} message lets you force message state to 'unprocessed' which means that it will have brighter cup icon in front of it which is supposed to help you keep track of messages that you need to take care of.

+\par \fi0\li0 \bullet   {\i Mark as processed} message is the reverse of {\i Mark as new} command.

+\par \fi0\li0 \bullet   {\i Empty Log} simply removes all messages from the log.\pard

+\par \fi0\li0 \bullet   {\b Message preview window} - the recorded message itself is shown in this window.\pard

+\page

+

+\pard\plain\keepn

+#{\footnote AnnounceDialog}

+${\footnote Announce Dialog}

+{ \f1\fs18\b\sb120 Announce Dialog Window}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 When incoming call occurs and you're set to get a prompt this dialog pops up. This dialog lets you chose what further actions you want {\b T42} to take and see the request details. The dialog looks like this:

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 \{bmct announce.bmp\}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Incoming call details are in {\b bold}. The details are:\pard

+\par \fi0\li0 \bullet   {\b callee name} - this is your name, or what caller thinks it is. ({\i kamel} in this example)

+\par \fi0\li0 \bullet   {\b tty} - terminal on which remote thinks you're logged on. This is not important for incoming requests. Normally this is only used on unix machines. ({\i tty0} in this example)

+\par \fi0\li0 \bullet   {\b caller's name} - local username and hostname/IP address of caller. ({\i hacker@localhost} in this example)\pard

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Use {\b Yes, I'd appreciate some milk} button to answer the call and establish talk connection with caller, {\b Not now, have a cup of tea with secretary} to relay the call to your secretary and {\b No, thanks, I'm out to coffee house} to ignore call.

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 If you don't answer in 30 seconds the call is relayed to the secretary.

+\page

+

+\pard\plain\keepn

+#{\footnote Options}

+${\footnote Options}

+{ \f1\fs18\b\sb120 Options}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Options is a tabbed dialog box where you're supposed to change {\b T42} settings. It consists of\pard

+\par \fi0\li0 \bullet   {\uldb General tab}{\v GeneralOptions} - tune general {\b T42} options. Not much to set there so far.

+\par \fi0\li0 \bullet   {\uldb Format tab}{\v FontsOptions} - set up text formats (fonts, colors, etc.) for various windows.

+\par \fi0\li0 \bullet   {\uldb Sounds tab}{\v SoundsOptions} - customize {\b T42} bells and whistles in this dialog.

+\par \fi0\li0 \bullet   {\uldb Secretary tab}{\v SecretaryOptions} - teach your secretary manners here.\pard

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Note: you might need to restart {\b T42} for some options to take effect.

+\page

+

+\pard\plain\keepn

+#{\footnote GeneralOptions}

+${\footnote General Options}

+{ \f1\fs18\b\sb120 General Options}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Currently you can only set up talk port here. Talk port is the UDP> port {\b\cf6 talk daemon} listens for incoming connections at. You can enter either number of port or service name (as specified in your {\b services} file) here. Do not change this if you don't know what you're doing and don't understand the instructions above.

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Note: you have to restart {\b T42} for this option to take effect.

+\page

+

+\pard\plain\keepn

+#{\footnote FontsOptions}

+${\footnote Fonts Options}

+{ \f1\fs18\b\sb120 Fonts}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Set up various fonts for {\b T42} to use according to your own preferences. There are three formats for you to set:\pard

+\par \fi0\li0 \bullet   {\b Local} - this is what your typing appears as.

+\par \fi0\li0 \bullet   {\b Remote} - this is what your party's typing should look like.

+\par \fi0\li0 \bullet   {\b System} - this is what system messages, like disconnection cause, etc. in talk windows look like.\pard

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 For each format you can set up {\b Font face}, {\b Font size}, {\b bold}, {\i italic}, {\ul underline}, {\strike strikeout} and {\b character set} to use. For some formats you can also set {\b foreground} and {\b background} colors.

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Note: these settings only affect new windows.

+\page

+

+\pard\plain\keepn

+#{\footnote SoundsOptions}

+${\footnote Sounds Options}

+{ \f1\fs18\b\sb120 Sounds}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 This is where you customize {\b T42} bells and whistles, specifically:\pard

+\par \fi0\li0 \bullet   {\b Bell in {\b T42} window} - the sound to produce when you or your party sends ASCII BELL characters ({\b Ctrl-G}).

+\par \fi0\li0 \bullet   {\b Prompt sound alert} the sound used to notify you of incoming call. You may also set {\b loop} for this sound to make it continuous for the {\uldb Announce Window}{\v AnnounceDialog} lifetime.

+\par \fi0\li0 \bullet   {\b Wake-up sound alert} the sound used to let you know that {\b T42} leaves {\b sleep mode} (see {\uldb Conversation Window}{\v ConversationWindow} for details).\pard

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 For each sound you can either specify {\b .WAV} file (use browse button to choose it) or internal sound from drop-down list. You can also use play button to check what it sounds like.

+\page

+

+\pard\plain\keepn

+#{\footnote SecretaryOptions}

+${\footnote Secretary Options}

+{ \f1\fs18\b\sb120 Secretary}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 This is the place to teach your secretary how to behave. The things you can ask for are:\pard

+\par \fi0\li0 \bullet   {\b Greeting message} - this is the message your secretary greets caller with. When greeting is transferred your secretary will automatically substitute time limit (see below) instead of {\b %t} and characters limit (see below) instead of {\b %c}.

+\par \fi0\li0 \bullet   After greeting the caller your secretary will record the message until the caller will exceed either {\b time limit} or {\b character} limit. You may choose to disable either or both limits.

+\par \fi0\li0 \bullet   You may also limit your secretary's ability to handle multiple calls to provide each caller with better service. Normally the optimal limit depends on your system resources and your callers' activities.\pard

+\page

+

+\pard\plain\keepn

+#{\footnote RemoteDialog}

+${\footnote Remote Dialog}

+{ \f1\fs18\b\sb120 Remote Dialog}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Whenever you want to issue talk request you're presented with a dialog in which you can enter your request details, it looks like this:

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 \{bmct invite.bmp\}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 The call details are:\pard

+\par \fi0\li0 \bullet   {\i Callee address} - The address is in the form {\b user@host}, {\i kamel@192.168.168.192} in this example.

+\par \fi0\li0 \bullet   {\i tty} - terminal line your party is logged on. It's only relevant when the callee is on unix system. If you don't know what to put in there - just leave it blank.

+\par \fi0\li0 \bullet   {\i Your username} - this is how your call will appear to caller. Just don't leave it empty.\pard

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Note: your party address is {\b not} your party's email address, even if it looks similar. {\b host} part is either hostname your party logged in or {\b IP address} of the host. If your party has {\b dynamically assigned} IP address, one way to determine it is too look up in the headers of e-mail sent {\b after} your party's established internet connection last time (i.e. very recent one) and find something like

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 Received: from 209.203.65.22 (ppp22.kross.klever.net [209.203.65.22]) by mail.elsinore.klever.net (8.8.7/8.8.7) with SMTP id RAA15788

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 In this case the IP address would be {\b 209.203.65.22} and the host name {\b ppp22.kross.klever.net}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 So, you're advised to talk to {\b whoever@209.203.65.22} or {\b whoever@ppp22.kross.klever.net}. You don't need to worry if your party has a static IP address.

+\page

+

+\pard\plain\keepn

+#{\footnote ConversationWindow}

+${\footnote Conversation Window}

+{ \f1\fs18\b\sb120 Conversation Window}

+\par\sa120\sb120\qj\pard \f1\fs18\sb120 This is the window where actual conversation takes place. It is split into two panes for you and for your party. It is split either horizontal or vertical. In the former case you type in the upper half and see what your party does in the lower. In case of vertical orientation your part is the leftmost one. All control actions are done via menu bar. Here goes an explanation for each command:\pard

+\par \fi0\li0 \bullet   {\b Tea}\pard

+\par \fi0\li0 \bullet   {\i Remote user} - initiate talk session for this window. You will be prompted for {\uldb your party's whereabouts}{\v RemoteDialog}.

+\par \fi0\li0 \bullet   {\i Close connection} - terminate talk session. This puts window into inactive state until you initiate new session.

+\par \fi0\li0 \bullet   {\i Re-connect} - re-initiate talk session to the same party, for instance if you've lost connection.

+\par \fi0\li0 \bullet   {\i Save} - if there was something important said you can save the whole conversation into RTF formatted file for future reference.

+\par \fi0\li0 \bullet   {\i Exit} - will close conversation window and terminate the connection.\pard

+\par \fi0\li0 \bullet   {\b Edit}\pard

+\par \fi0\li0 \bullet   {\i Copy} - copy currently selected text into windows clipboard.

+\par \fi0\li0 \bullet   {\i Paste} - paste window selection into your current conversation.\pard

+\par \fi0\li0 \bullet   {\b Sleep}\pard

+\par \fi0\li0 \bullet   {\i Sleep} - put your session to sleep. When your party shows some kind of activity {\b Wake-up action} will be taken (see below).

+\par \fi0\li0 \bullet   {\i Sleep on minimize} - check this if you want to activate sleep mode whenever you minimize conversation window.

+\par \fi0\li0 \bullet   {\i Minimize on sleep} - check this if you want to minimize window whenever you put it into sleep mode.

+\par \fi0\li0 \bullet   {\i Wake-up action} - Actions to take whenever remote user shows activity in sleep mode. Possible actions are:

+      \pard

+\par \fi0\li0 \bullet   Make sound - check this if you want {\b T42} to produce sound (as specified in {\uldb Sounds Options}{\v SoundsOptions}) whenever it leaves sleep mode.

+\par \fi0\li0 \bullet   Pop-up - check this if you want {\b T42} to bring conversation window to foreground and restore if it is minimized whenever it leaves sleep mode.\pard\pard

+\par \fi0\li0 \bullet   {\b Window}\pard

+\par \fi0\li0 \bullet   {\i Split equally} split local and remote panes in equal propotions.

+\par \fi0\li0 \bullet   {\i Save layout} - save window position, size and split proportions for future sessions.

+\par \fi0\li0 \bullet   {\i Autosave layout} - automatically save layout whenever you close conversation window.

+\par \fi0\li0 \bullet   {\i Horizontal split}/{\i Vertical split} - chose your orientation.

+\par \fi0\li0 \bullet   {\i Hide on minimize} - set {\b T42} to hide window into notification tray icon whenever you minimize it.\pard\pard

+\page

+}
\ No newline at end of file
diff --git a/help/T42.xml b/help/T42.xml
new file mode 100644
index 0000000..d59c255
--- a/dev/null
+++ b/help/T42.xml
@@ -0,0 +1,183 @@
+<?xml version="1.0"?>

+<winhelp>

+ <topic id="About" title="About T42">

+  <heading scroll="no">About <kin>T42</kin></heading>

+  <p><kin>T42</kin> is our <term>Win32</term> implementation of <product>unix</product> <product>ntalk</product> protocol.</p>

+  <p>It features:</p>

+  <ul>

+   <li><b>Multihoming</b> - works properly on multihomed machines (ie. accepts connections/issues requests on all interfaces);</li>

+   <li><b>Your personal secretary</b> - technically speaking, something like answering machine;</li>

+   <li><b>Sleep function</b> - be notified of activities in backgrounded windows;</li>

+  </ul>

+  <p>Designed to be compatible with our <term>TFTP</term> client/server, <kin href="http://www.klever.net/kin/pumpkin.html">PumpKIN</kin>, that allows you to exchange files with your party while having talk sessions.</p>

+  <p/>

+  <p><b><i>Enjoy!</i></b></p>

+  <license years="1998, 2002"/>

+  <credits/>

+ </topic>

+ <topic id="News" title="What's New">

+  <newsfor version="1.5" date="August 19th, 2002">

+   <ni>Change of license and opening the source</ni>

+  </newsfor>

+ </topic>

+ <topic id="Using" title="Using T42">

+  <heading scroll="no">Using <kin>T42</kin></heading>

+  <p>Once you've installed <kin>T42</kin>, run it from <i>Programs/Accessories/Klever Co.</i> menu. A small cup icon will appear in the notification tray area.</p>

+  <p>Left-click on the icon will get you to the <a href="#MainWindow">Main Window</a>, right-click  brings up the following menu:</p>

+  <ul>

+   <li><b>Order some tea</b> - Initiates talk session. This will open new <a href="#ConversationWindow">Conversation Window</a> and prompt you for request details.</li>

+   <li><b>Away</b> - Toggle your away mode. It affects the way <kin>T42</kin> handles incoming calls. See <a href="#Mainwindow">Main Window</a> for details.</li>

+   <li><b>Show Main Window</b> - Toggle visibility of the <a href="#MainWindow">Main Window</a> from which you can control some of <kin>T42</kin> options and read/maintain your recorded messages.</li>

+   <li><b>Options</b> - Select this to bring up <a href="#Options">Options dialog</a> so that you can customize <kin>T42</kin> to suit your needs.</li>

+   <li><b>Exit</b> - This is not likely to happen, but if you want to exit <kin>T42</kin> and unload it from memory - that's what <b>Exit</b> is for.</li>

+  </ul>

+ </topic>

+ <topic id="MainWindow" title="Main Window">

+  <heading scroll="no">Main <kin>T42</kin> Window</heading>

+  <p>Main Window is a <kin>T42</kin> Control Center, it's exactly mouse-click away from most of <kin>T42</kin> functions. It consists of</p>

+  <ul>

+   <li><b>On Call</b> and <b>On Call when away</b> dropdown lists let you select the action to take when incoming call occurs in 'normal' and 'away' mode. Chose one of

+    <ul>

+     <li><i>Prompt</i> - Ask you what to do before taking any actions;</li>

+     <li><i>Secretary</i> - Relay incoming calls to your <a href="#SecretaryOptions">personal secretary</a>. Some prefer to call it answering machine.</li>

+     <li><i>Not here</i> - Tell the caller you're not here (<i>not logged in</i>) and terminate connection.</li>

+     <li><i>Refuse</i> - Tell the caller you're not accepting messages and terminate connection.</li>

+     <li><i>Ignore</i> - Pretend that you didn't notice.</li>

+    </ul>

+   </li>

+   <li><b>Away</b> button toggles your away mode. When an incoming call occurs <kin>T42</kin> takes action based upon away mode and options selected in <b>On Call</b> and <b>On Call when away</b> dropdown lists.</li>

+   <li><b>Tea</b> button initiates new talk session. This will open new <a href="#ConversationWindow">Conversation Window</a> and prompt you for <a href="#RemoteDialog">request details</a>.</li>

+   <li><b>Options</b> button brings up <a href="#Options">Configuration Dialog</a> that lets you customize <kin>T42</kin> according to your needs.</li>

+   <li><b>Exit</b> - button closes <kin>T42</kin> windows and removes <kin>T42</kin> from memory.</li>

+   <li><b>Help</b> button enters the help system. If you got this far, you probably don't need further explanations.</li>

+   <li><b>Recorded messages</b> list this is the list of messages recorded by your secretary. Messages are sorted by age, last ones first. Unanswered messages have a brighter cup icon unless you've explicitly marked the message as processed (see below for details). Right-click on the list entry presents you with popup menu from which you can:

+    <ul>

+     <li><i>Call back</i> the person who left the message. This is identical to initiating new talk session and entering caller's data manually. Note: if the caller has a dynamic IP address and have already disconnected from his ISP and reconnected back this may not work.</li>

+     <li><i>Delete</i> selected message(s). If you don't need recorded message anymore you can throw it away by selecting this.</li>

+     <li><i>Save to file..</i> menu option lets you save message into <term>RTF</term> file. Then you may print message text, import it into your <product>MS Word</product> documents or do with it whatever you want.</li>

+     <li><i>Mark as new</i> message lets you force message state to 'unprocessed' which means that it will have brighter cup icon in front of it which is supposed to help you keep track of messages that you need to take care of.</li>

+     <li><i>Mark as processed</i> message is the reverse of <i>Mark as new</i> command.</li>

+     <li><i>Empty Log</i> simply removes all messages from the log.</li>

+    </ul>

+   </li>

+   <li><b>Message preview window</b> - the recorded message itself is shown in this window.</li>

+  </ul>

+ </topic>

+ <topic id="AnnounceDialog" title="Announce Dialog">

+  <heading scroll="no">Announce Dialog Window</heading>

+  <p>When incoming call occurs and you're set to get a prompt this dialog pops up. This dialog lets you chose what further actions you want <kin>T42</kin> to take and see the request details. The dialog looks like this:</p>

+  <p><image source="announce.bmp"/></p>

+  <p>Incoming call details are in <b>bold</b>. The details are:</p>

+  <ul>

+   <li><b>callee name</b> - this is your name, or what caller thinks it is. (<i>kamel</i> in this example)</li>

+   <li><b>tty</b> - terminal on which remote thinks you're logged on. This is not important for incoming requests. Normally this is only used on unix machines. (<i>tty0</i> in this example)</li>

+   <li><b>caller's name</b> - local username and hostname/IP address of caller. (<i>hacker@localhost</i> in this example)</li>

+  </ul>

+  <p>Use <b>Yes, I'd appreciate some milk</b> button to answer the call and establish talk connection with caller, <b>Not now, have a cup of tea with secretary</b> to relay the call to your secretary and <b>No, thanks, I'm out to coffee house</b> to ignore call.</p>

+  <p>If you don't answer in 30 seconds the call is relayed to the secretary.</p>

+ </topic>

+ <topic id="Options" title="Options">

+  <heading scroll="no">Options</heading>

+  <p>Options is a tabbed dialog box where you're supposed to change <kin>T42</kin> settings. It consists of</p>

+  <ul>

+   <li><a href="#GeneralOptions">General tab</a> - tune general <kin>T42</kin> options. Not much to set there so far.</li>

+   <li><a href="#FontsOptions">Format tab</a> - set up text formats (fonts, colors, etc.) for various windows.</li>

+   <li><a href="#SoundsOptions">Sounds tab</a> - customize <kin>T42</kin> bells and whistles in this dialog.</li>

+   <li><a href="#SecretaryOptions">Secretary tab</a> - teach your secretary manners here.</li>

+  </ul>

+  <p>Note: you might need to restart <kin>T42</kin> for some options to take effect.</p>

+ </topic>

+ <topic id="GeneralOptions" title="General Options">

+  <heading scroll="no">General Options</heading>

+  <p>Currently you can only set up talk port here. Talk port is the UDP> port <product>talk daemon</product> listens for incoming connections at. You can enter either number of port or service name (as specified in your <b>services</b> file) here. Do not change this if you don't know what you're doing and don't understand the instructions above.</p>

+  <p>Note: you have to restart <kin>T42</kin> for this option to take effect.</p>

+ </topic>

+ <topic id="FontsOptions" title="Fonts Options">

+  <heading scroll="no">Fonts</heading>

+  <p>Set up various fonts for <kin>T42</kin> to use according to your own preferences. There are three formats for you to set:</p>

+  <ul>

+   <li><b>Local</b> - this is what your typing appears as.</li>

+   <li><b>Remote</b> - this is what your party's typing should look like.</li>

+   <li><b>System</b> - this is what system messages, like disconnection cause, etc. in talk windows look like.</li>

+  </ul>

+  <p>For each format you can set up <b>Font face</b>, <b>Font size</b>, <b>bold</b>, <i>italic</i>, <u>underline</u>, <strike>strikeout</strike> and <b>character set</b> to use. For some formats you can also set <b>foreground</b> and <b>background</b> colors.</p>

+  <p>Note: these settings only affect new windows.</p>

+ </topic>

+ <topic id="SoundsOptions" title="Sounds Options">

+  <heading scroll="no">Sounds</heading>

+  <p>This is where you customize <kin>T42</kin> bells and whistles, specifically:</p>

+  <ul>

+   <li><b>Bell in <kin>T42</kin> window</b> - the sound to produce when you or your party sends ASCII BELL characters (<b>Ctrl-G</b>).</li>

+   <li><b>Prompt sound alert</b> the sound used to notify you of incoming call. You may also set <b>loop</b> for this sound to make it continuous for the <a href="#AnnounceDialog">Announce Window</a> lifetime.</li>

+   <li><b>Wake-up sound alert</b> the sound used to let you know that <kin>T42</kin> leaves <b>sleep mode</b> (see <a href="#ConversationWindow">Conversation Window</a> for details).</li>

+  </ul>

+  <p>For each sound you can either specify <b>.WAV</b> file (use browse button to choose it) or internal sound from drop-down list. You can also use play button to check what it sounds like.</p>

+ </topic>

+ <topic id="SecretaryOptions" title="Secretary Options">

+  <heading scroll="no">Secretary</heading>

+  <p>This is the place to teach your secretary how to behave. The things you can ask for are:</p>

+  <ul>

+   <li><b>Greeting message</b> - this is the message your secretary greets caller with. When greeting is transferred your secretary will automatically substitute time limit (see below) instead of <b>%t</b> and characters limit (see below) instead of <b>%c</b>.</li>

+   <li>After greeting the caller your secretary will record the message until the caller will exceed either <b>time limit</b> or <b>character</b> limit. You may choose to disable either or both limits.</li>

+   <li>You may also limit your secretary's ability to handle multiple calls to provide each caller with better service. Normally the optimal limit depends on your system resources and your callers' activities.</li>

+  </ul>

+ </topic>

+ <topic id="RemoteDialog" title="Remote Dialog">

+  <heading scroll="no">Remote Dialog</heading>

+  <p>Whenever you want to issue talk request you're presented with a dialog in which you can enter your request details, it looks like this:</p>

+  <p><image source="invite.bmp"/></p>

+  <p>The call details are:</p>

+  <ul>

+   <li><i>Callee address</i> - The address is in the form <b>user@host</b>, <i>kamel@192.168.168.192</i> in this example.</li>

+   <li><i>tty</i> - terminal line your party is logged on. It's only relevant when the callee is on unix system. If you don't know what to put in there - just leave it blank.</li>

+   <li><i>Your username</i> - this is how your call will appear to caller. Just don't leave it empty.</li>

+  </ul>

+  <p>Note: your party address is <b>not</b> your party's email address, even if it looks similar. <b>host</b> part is either hostname your party logged in or <b>IP address</b> of the host. If your party has <b>dynamically assigned</b> IP address, one way to determine it is too look up in the headers of e-mail sent <b>after</b> your party's established internet connection last time (i.e. very recent one) and find something like</p>

+  <p>Received: from 209.203.65.22 (ppp22.kross.klever.net [209.203.65.22]) by mail.elsinore.klever.net (8.8.7/8.8.7) with SMTP id RAA15788</p>

+  <p>In this case the IP address would be <b>209.203.65.22</b> and the host name <b>ppp22.kross.klever.net</b></p>

+  <p>So, you're advised to talk to <b>whoever@209.203.65.22</b> or <b>whoever@ppp22.kross.klever.net</b>. You don't need to worry if your party has a static IP address.</p>

+ </topic>

+ <topic id="ConversationWindow" title="Conversation Window">

+  <heading scroll="no">Conversation Window</heading>

+  <p>This is the window where actual conversation takes place. It is split into two panes for you and for your party. It is split either horizontal or vertical. In the former case you type in the upper half and see what your party does in the lower. In case of vertical orientation your part is the leftmost one. All control actions are done via menu bar. Here goes an explanation for each command:</p>

+  <ul>

+   <li><b>Tea</b>

+    <ul>

+     <li><i>Remote user</i> - initiate talk session for this window. You will be prompted for <a href="#RemoteDialog">your party's whereabouts</a>.</li>

+     <li><i>Close connection</i> - terminate talk session. This puts window into inactive state until you initiate new session.</li>

+     <li><i>Re-connect</i> - re-initiate talk session to the same party, for instance if you've lost connection.</li>

+     <li><i>Save</i> - if there was something important said you can save the whole conversation into RTF formatted file for future reference.</li>

+     <li><i>Exit</i> - will close conversation window and terminate the connection.</li>

+    </ul>

+   </li>

+   <li><b>Edit</b>

+    <ul>

+     <li><i>Copy</i> - copy currently selected text into windows clipboard.</li>

+     <li><i>Paste</i> - paste window selection into your current conversation.</li>

+    </ul>

+   </li>

+   <li><b>Sleep</b>

+    <ul>

+     <li><i>Sleep</i> - put your session to sleep. When your party shows some kind of activity <b>Wake-up action</b> will be taken (see below).</li>

+     <li><i>Sleep on minimize</i> - check this if you want to activate sleep mode whenever you minimize conversation window.</li>

+     <li><i>Minimize on sleep</i> - check this if you want to minimize window whenever you put it into sleep mode.</li>

+     <li><i>Wake-up action</i> - Actions to take whenever remote user shows activity in sleep mode. Possible actions are:

+      <ul>

+       <li>Make sound - check this if you want <kin>T42</kin> to produce sound (as specified in <a href="#SoundsOptions">Sounds Options</a>) whenever it leaves sleep mode.</li>

+       <li>Pop-up - check this if you want <kin>T42</kin> to bring conversation window to foreground and restore if it is minimized whenever it leaves sleep mode.</li>

+      </ul>

+     </li>

+    </ul>

+   </li>

+   <li><b>Window</b>

+    <ul>

+     <li><i>Split equally</i> split local and remote panes in equal propotions.</li>

+     <li><i>Save layout</i> - save window position, size and split proportions for future sessions.</li>

+     <li><i>Autosave layout</i> - automatically save layout whenever you close conversation window.</li>

+     <li><i>Horizontal split</i>/<i>Vertical split</i> - chose your orientation.</li>

+     <li><i>Hide on minimize</i> - set <kin>T42</kin> to hide window into notification tray icon whenever you minimize it.</li>

+    </ul>

+   </li>

+  </ul>

+ </topic>

+</winhelp>

diff --git a/help/announce.bmp b/help/announce.bmp
new file mode 100644
index 0000000..5c40627
--- a/dev/null
+++ b/help/announce.bmp
diff --git a/help/invite.bmp b/help/invite.bmp
new file mode 100644
index 0000000..7dac6bb
--- a/dev/null
+++ b/help/invite.bmp