fixes: - copyright year - fixed critical bug in the main _rawreceive() for() loop, messages were lost.
fixes:
- copyright year
- fixed critical bug in the main _rawreceive() for() loop, messages were lost.

changes:
- changed documentation tags in front of all methods to the phpDocumentator compatible format.
- renamed useSockets() to setUsetSockets()
  it will also now try to load the socket extension if it's not loaded.
- renamed disconnecttime() to setDisconnecttime().
- improved connect() errorhandling.
- changed login() parameters to $nick, $realname, $usermode = 0, $username = null, $password = null.
- changed join() parameters to $channelarray, $key = null.
- changed kick() parameters to $channel, $nicknamearray, $reason = null.
- changed listenFor() parameters to $messagetype
  return value is now the result, instead the of a reference to the result parameter.
- sendbuffer has now 3 queues: high, medium and low
  high sends 2 messages, then 1 of medium
  low is only send if high _and_ medium is empty.
- select() call for sockets is strongly optimized
- removed _lastmicrotimestamp, messagebuffer now uses a static variable for it.

new:
- phpDocumentator package tags.
- include() for messagehandler.php (needed for the new API).
- _usermode variable for tracking the usermode.
- _password variable for storing the password if reconnect() is used.
- _channelsynching variable for channelsynching support.
- setChannelSynching() method, for enabling the channel synching.
- _ctcpversion variable for adding own ctcp version string.
- setCtcpVersion() method, for changing the ctcp version reply string.
- _messagebuffersize variable, stores how much messages are in all messagequeues.
- _messagehandlerobject variable, reference to the messagehandler object.
- _mintimer variable, the lowest interval of all timers.
- _maxtimer variable the highest timer interval for select() calculation.
- _rxtimeout variable, stores the receive timeout setting.
- setReceiveTimeout() method, for changing the receive timeout.
- _txtimeout variable, stores the transmit timeout setting.
- setTransmitTimeout() method, for changing the transmit timeout.
- _selecttimeout variable, the timeout for the next select() call.
- _lastrx variable, last timestamp when data was received
- _lasttx variable, last timestamp when data was sent.
- _autoreconnect variable, setting for autoreconnect.
- setAutoReconnect() method, for enabling the autoreconnect feature.
- _channels variable, array with all channels we are joined, only if channelsynching is on.
- replycodes variable, array of all IRC replycodes as index the string names.
- nreplycodes variable, array of all IRC replycodes as index the numeric code.
- channel variable, a reference to _channels because $object->channel("#chan")->topic is not possible in PHP4 (ZE1).
- reconnect() method, it will reconnect and also join all channels.
- channel() method, getting a reference to the channel, only if channelsynching is on.
- _checktimeout() method, check if the connection timout, does reconnect if autoreconnect is on.
- _selecttimeout() method, returns the next select() timeout value.
- _calculateselecttimeout() method, calculates the highest timeout, that is possible.
- _updatemintimer() method, updates _mintimer with the lowest timer interval.
- _handlemessage() method, calls the messagehandler methods (new API).
- _handleactionhandler() method, actionhandler code that moved to its own method (existing API).
- _adduser() method, adds or updates user to a channel object, only if channelsynching is on.
- _removeuser() method, removes user from one or all channel objects, only if channelsynching is on.
- added ident, host, messageex and rawmessageex variables to the Net_SmartIRC_data class.
- class Net_SmartIRC_user, stores info about one user, only used if channelsynching is on.
- class Net_SmartIRC_channel, stores info about one channel, only used if channelsynching is on.


git-svn-id: 3c1acb010c2d6f5543cef21cf1b6ba7e28b045fa@110642 c90b9560-bf6c-de11-be94-00142212c4b1

pear/Net_SmartIRC