From 7ba4297a92e95af4ab61386bc889107678ec1e94 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=EFc=20Gomez?= Date: Tue, 8 Jan 2008 10:50:31 +0100 Subject: [PATCH] Documentation : - fix typos - include README.floodcontrol into README --- NEWS | 2 +- README | 57 ++++++++++++++++++++++++++++++++++----------- README.floodcontrol | 2 +- TODO | 1 - 4 files changed, 46 insertions(+), 16 deletions(-) diff --git a/NEWS b/NEWS index 0622db8..8d788de 100644 --- a/NEWS +++ b/NEWS @@ -29,6 +29,6 @@ certificates are now accepted as long as they are in store (therefore trusted). This makes the basic mode be more SSH like. Some extreme security zealots might want to be warned. -02-09-2007: as of now log parameters go in the user {} statment. This brakes +02-09-2007: as of now log parameters go in the user {} statment. This breaks every config and there is no backwrads compatibility as of now. Lots of internal changes, expect crashes. diff --git a/README b/README index dba9357..83162bb 100644 --- a/README +++ b/README @@ -16,6 +16,8 @@ Table of contents : B. Automated configuration III. Running bip IV. Using bip + A. Connecting your client(s) + B. Backlog and flood control @@ -119,22 +121,51 @@ III. RUNNING BIP IV. USING BIP - Then you want to use your regular irc client and connect to bip. Point - your client to the machine bip is running and set the proper port number - (defined in your bip.conf). You should then configure the client to use a - specific irc server password constructed this way: + A. CONNECTING YOUR CLIENT(S) - user:password:connection + Then you want to use your regular irc client and connect to bip. Point + your client to the machine bip is running and set the proper port number + (defined in your bip.conf). You should then configure the client to use a + specific irc server password constructed this way: + + user:password:connection + + The user is the name field of the "user" section, the password is the + password (*not* the hash) corresponding to the "password" field of the + same user section (which is the hash generated with bipmkpw) and the + connection is the "name" field of the "connection" subsection. This is + how bip authenticates you and puts your client to the correct network. + + Using the default (or sample file) configuration, logs are in ~/.bip/logs/ + + B. BACKLOG AND FLOOD CONTROL - The user is the name field of the "user" section, the password is the - password (*not* the hash) corresponding to the "password" field of the same - user section (which is the hash generated with bipmkpw) and the connection - is the "name" field of the "connection" subsection. This is how bip - authenticates you and puts your client to the correct network. + Bip has a backlogging system which will send back parts of the last logs + upon client connection. Depending on your configuration, that may mean a + *lot* of data sent back to your client. + + Users' messages will be replayed as if they were being sent at the moment + your client connects to bip, and if not disabled, system messages will + appear as coming from the "-bip" user. + + Considering that, you may want to disable your client's anti-flood system, + totally or not, depending on it's flexibility. + Since bip doesn't replay CTCP messages, you can safely let your client's + anti-flood system manage them. + + [Xchat] + If you're using Xchat, you can "disable" it by issuing these commands : + /set flood_msg_num = 1000 + /set flood_msg_time = 10 + In fact you'll tell xchat to activate its anti-flood system when you're + receiving more than 1000 messages in less than 10 seconds. + + If you forgot to set these, private messages may not appear in separate + tabs as usual. If so, simply issue a : + /set gui_auto_open_dialog on + - Using the default (or sample file) configuration, logs are in ~/.bip/logs/ - - Happy ircing! + Happy ircing! -- Arnaud Cornet and Loïc Gomez diff --git a/README.floodcontrol b/README.floodcontrol index 3d211a3..4b84ec8 100644 --- a/README.floodcontrol +++ b/README.floodcontrol @@ -10,7 +10,7 @@ coming from the "-bip" user. Considering that, you may want to disable your client's anti-flood system, totally or not, depending on it's flexibility. -Since bip doesn't relay CTCP messages, you can safely let your client's +Since bip doesn't replay CTCP messages, you can safely let your client's anti-flood system manage them. [Xchat] diff --git a/TODO b/TODO index 0c86683..e0e4923 100644 --- a/TODO +++ b/TODO @@ -42,7 +42,6 @@ Whoopie _____________ FAQ: -- no ciphers => check SSL key file - why I cannot add non-ssl servers with ssl-servers - why is my vhost not used when I connect (one IP)