<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kfinger "<application>kfinger</application>">
]>

<book lang="en">
<bookinfo>
<title>The KFinger Handbook</title>
<authorgroup>
<author>
<firstname>Andrea</firstname>
<surname>Rizzi</surname>
<affiliation>
<address><email>rizzi@kde.org</email></address>
</affiliation>
</author>
</authorgroup>
<date>June 23, 1999</date>
<releaseinfo>0.07.05</releaseinfo>
<abstract>
<para>This Handbook describes &kfinger; version 0.7.5.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KFinger</keyword>
<keyword>finger</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>In this version:
<itemizedlist>
<listitem>
<para>Timed auto finger</para>
</listitem>
<listitem>
<para>User list</para>
</listitem>
<listitem>
<para>Server list</para>
</listitem>
<listitem>
<para>Setup dialog</para>
</listitem>
<listitem>
<para>Ktalk launcher</para>
</listitem>
<listitem>
<para>New Html</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="kfingermainwindow">
<title>Kfinger Main window</title>

<para><graphic fileref="mainw.png"></graphic></para>

<para>In the kfinger main window you find:
<itemizedlist>
<listitem>
<para>The Menu Bar</para>
</listitem>
<listitem>
<para>The Tool Bar</para>
</listitem>
<listitem>
<para>The Status Bar</para>
</listitem>
<listitem>
<para>The Finger output</para>
</listitem>
</itemizedlist>
</para>

<sect1 id="menubar">
<title>Menu Bar</title>

<sect2 id="file">
<title>File:</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Finger Now:</emphasis> Execute finger reading User & Server from the ToolBar</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Talk...:</emphasis> Execute the TalkLauncher</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Quit:</emphasis> Quit!</para>
</listitem>
</itemizedlist>
</para>
</sect2>

<sect2 id="options">
<title>Options:</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Setup:</emphasis> Execute Setup</para>
</listitem>
</itemizedlist>
</para>
</sect2>

<sect2 id="help">
<title>Help:</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">About:</emphasis> About Kfinger</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Help:</emphasis> Execute KDEhelp</para>
</listitem>
</itemizedlist>
</para>
</sect2>
</sect1>

<sect1 id="toolbar">
<title>Tool Bar</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Button1:</emphasis> Execute finger</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Button2:</emphasis> Stop current finger session</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Button2:</emphasis> Execute TalkLauncher</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Button3:</emphasis> Time Auto finger (On/Off)</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Combo1:</emphasis> User</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Combo2:</emphasis> Server</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="statusbar">
<title>Status Bar</title>

<para>Contains messages or the status of the current kfinger session.</para>
</sect1>
</chapter>

<chapter id="kfingersetup">
<title>Kfinger Setup</title>

<para><emphasis remap="bf">Kfinger Setup window</emphasis></para>

<para><graphic fileref="setupw.png"></graphic></para>

<para>In the kfinger Setup tab dialog you find:
<variablelist>
<varlistentry>
<term>USER & SERVER Lists</term>
<listitem>
<para>To add an item to the server list (or user list) type the
name you want to add in the line editor, and press "Add". If you
want to insert an item in a particular position you must first select the position
in the list with the mouse. To remove an item select it and press "Remove".</para>
<para></para>
</listitem>
</varlistentry>
<varlistentry>
<term>AUTO FINGER WAIT-TIME</term>
<listitem>
<para>The check box activates and deactivates the auto finger feature. This feature
will execute the finger every nnn seconds so you will have updated information.
Use the slider to select the wait time between the finger sessions.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>TALK LAUNCHER SETUP</term>
<listitem>
<para>The talk launcher permits you to talk with a user logged into the server
by clicking on the Talk Launcher button & selecting the desired user.
Kfinger will then execute "Ktalk User@Server".</para>
<para><graphic fileref="formatw.png"></graphic></para>
<para>To get the values of User and Server, Ktalk use 3 methods:</para>
<para><itemizedlist>
<listitem>
<para>Scanf from finger output(FINGER OUTPUT)</para>
</listitem>
<listitem>
<para>Using the same value in ToolBar ComboBox(FINGER SERVER or USER)</para>
</listitem>
<listitem>
<para>Using a fixed value(FIXED)</para>
</listitem>
</itemizedlist>
</para>

<para><variablelist>
<varlistentry>
<term>Finger output</term>
<listitem>
<para>To select how Kfinger uses the values from finger's output you must press "Format.."
Kfinger can read 2 values using the C function scanf from finger output; the two values
are a string(the first value), and an integer(the second value). You must specify a format string for scanf
and an offset for the read string (how many characters must be ignored before start
to read). Then you have to create a format string for the output.</para>
<para><emphasis remap="bf">EXAMPLE:</emphasis></para>
<para>I have the following output with kfinger and I want to obtain a talkLauncher list where
the username is "root" and the server is "portNNN-ISDN.InterService.com" :
<screen>Name           tty      idle
Jack01           1        10
Mary             3         0
robert           4         0
</screen>
</para>
<para>To get the desired output, set the following parameters:
<itemizedlist>
<listitem>
<para>Lines to skip: 1</para>
</listitem>
<listitem>
<para>User: Fixed to "root"</para>
</listitem>
<listitem>
<para>Server: Finger output with the following settings:</para>
</listitem>
</itemizedlist>
</para>
<para><graphic fileref="formatex.png"></graphic></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para><literal remap="tt">Ce programme est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE; même sans la garantie implicite de MERCANTIBILITE ou de CONVENANCE POUR UN BUT PARTICULIER. Reportez-vous à la Licence Générale Publique GNU pour plus de détails.</literal></para>

<para><literal remap="tt">Vous devriez avoir reçu une copie de la Licence Générale Publique GNU avec ce programme; si ce n'est pas le cas, écrivez à la Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</literal></para>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
