--------------------------------
README.TXT for PINO 1.0 Build 58
--------------------------------


                                                     Vienna, 21/12/98 0:28


PLEASE EXCUSE THE SIMPLICITY OF THIS DOCUMENTATION BUT THIS IS A BETA-RELEASE
and further please excuse my english :) but I'm a native german speaker
and so...you know ;). But I wanna improve myself...promised :)


*************
What's PINO?*
*************

PINO is the Client for PINO-Server. It supports a history-list for the
text-field, several windows for private messages, an userlist,
saving of ChatLogs,...

You can also download the Server from the PINO-Homepage (http://pino.cjb.net).




*********************
Installation of PINO*
*********************

As you can read this file I suppose you have already unzipped the PINO-Archive.
Now there are four files:

   - PINO.EXE       The executable file
   - README.TXT     This documentation
   - LICENSE.TXT    The license information
   - HISTORY.TXT    The version history
   

To start the program just run PINO.EXE. Now you see the main-window of PINO.
To chat now, select "Connect" from the "Chat"-menu. Enter there the host (if the
Server is running on another port as 1995 specify it by adding a colon and
the port number) and then click OK.
Now you can:

  - Login to chat
  - Create a new Registration
  - Modify or delete an existing Registration
  - Display all rooms


To login select "Login" from the "Chat"-menu. Enter now the desired Nickname
and (if you have been registered) your Password. Select also the systemroom
in which you want to login. Then click OK.
For chatting enter your text or commands in the field above the two checkboxes.
Everything you write will be stored in a history-list which is accessible by
pressing either the "Down"- or the "Up"-Button on keyboard. The two checkboxes
are used for special notifications. If the first is checked you are informed
with a beep when someone sends a private message to you. The second informs
you when someone writes your nickname (not case sensitive).



To create a new Registration select "Registration-New" from the "Chat"-menu.
Enter there the desired Nickname, Password, email-address, Homepage-URL,
Friends and a Note (required is only "Nickname"). After that click OK. If
your Registration has been successful you'll be informed.

To modify an existing Registration select "Registration-Edit" from the
"Chat"-menu. Enter there your Nickname and Password. Then click OK. If
you have entered the correct data you'll see the Registrationdata. Modify it
and confirm with OK.

To delete an existing Registration select "Registration-Delete" from the
"Chat"-menu. Enter there your Nickname and Password. Then click OK. If you
have entered the correct data you'll be warned if you really want to do this.
Confirm this message by clicking YES.

To display all current existing rooms select "Rooms" from the "Chat"-menu.
You'll see in the next window the rooms with the users that belong to the room.
If a room is marked with an "X" it is closed. All other rooms can be entered by
clicking on "Go to". To update the list click "Refresh". If you want that the
list is being refreshed automatically check "Auto refresh". The list will be
refreshed all 30 seconds.



*******************************
Chat-commands for normal users*
*******************************

-a

This command is only available if you have been invited. You accept with it
an invitation.
--------------------------------------------------------------------------

-away [reason]

This command is used to show other users your absence. If someone sends you
a private message he will be notified that you can't answer immediately :).
--------------------------------------------------------------------------

-c

You can clear your textfield with this command.
--------------------------------------------------------------------------

-col [RGB-colorcode]

This command is used to change your color. It needs one parameter defining
your color as RGB-code. eg: Red=FF0000, Green=00FF00, Blue=0000FF
--------------------------------------------------------------------------

-f

If you're a registered user and have a friendslist this command will display
all online friends.
--------------------------------------------------------------------------

-follow [nickname]

Use this command to follow a Chatter. This means you enter the room (except
it is closed) where the user is.
--------------------------------------------------------------------------

-ig [nickname]

If someone gets on your nervs or floods the screen with unwanted informations
(and there is no ChatOP ;)) you can ignore him with this command. It is also
used to unignore someone.
--------------------------------------------------------------------------

-j [roomname]

If you want to enter another room use this command. If this room is locked
you will receive an error-message.
--------------------------------------------------------------------------

-me [text]

Use this command to do something. This means the text you have entered will
be displayed as follows:

When Hugo enters "-me blablabla"...this will be reformed to..."Hugo blablabla"
--------------------------------------------------------------------------

-q

Use this command to logout.
--------------------------------------------------------------------------

-s [text]

This command is used to shout. The text will be formatted as bold and italic.






*****************
Private messages*
*****************

If you want to write something to someone and only he shall read it send a
private message. For that enter /nickname text

Example: You want to send Hugo a private message. Do it as follows:

         /Hugo blablabla






**************************
Chat-commands for RoomOPs*
**************************

-gag [nickname]

With this command an user can be gaged and ungaged. If an user is gaged he
just can send private messages. You also don't see when he changes the color.
--------------------------------------------------------------------------

-i [nickname]

If you want to invite an user into a room (even if it's locked) then use
this command. He will get a Notification of this Invitation.
--------------------------------------------------------------------------

-k [nickname]

If you want to kick an user off the room use this command. It will kick him
into the kickroom defined by the Chat-Administrator.
--------------------------------------------------------------------------

-l

This command is used to lock and unlock a room. No user can enter a locked
room without an Invitation.
--------------------------------------------------------------------------

-op [nickname]

This command is used to appoint an user as RoomOP.






***********************************
Extended Chat-commands for ChatOPs*
***********************************


-ip [nickname]

You get the IP-Address of an user with this command.

-kh [nickname] [time in minutes]

Use this command if you want to kick an user off the Chat. The second optional
parameter defines the minutes which the IP of the user is banned.

-rop [nickname]

This command is used to remove RoomOP-Rights from an user.






*****************
What's a RoomOP?*
*****************

RoomOP is the synonym for Room-Operator. It means an user with an extended
Selection of commands. Each user (even unregistered) can become a RoomOP.
Either by opening an own room or by appointment by an other RoomOP or ChatOP.
When a RoomOP leaves the room he loses his RoomOP-State in this room.






*****************
What's a ChatOP?*
*****************

ChatOP is the synonym for Chat-Operator. A ChatOp has the same Selection of
commands as an RoomOP. But he also can read and ban your IP-Address and can
kick you off the Chat. To become a ChatOP you must be appointed by the
Administrator of the Chat.
