repo: ngircd
action: commit
revision: 
path_from: 
revision_from: 1519afa391d7cb33957892fded23e1b1e178f1f3:
path_to: 
revision_to: 

commit 1519afa391d7cb33957892fded23e1b1e178f1f3
Author: Alexander Barton 
Date:   Thu Dec 4 11:14:26 2008 +0100

    doc/Services.txt: explain which IRC Services versions are compatible

diff --git a/doc/Services.txt b/doc/Services.txt

--- a/doc/Services.txt
+++ b/doc/Services.txt
@@ -14,7 +14,7 @@ At the moment, ngIRCd doesn't implement a "special IRC services interface".
 But services acting as a "regular server" are supported, either using the IRC
 protocol defined in RFC 1459 or RFC 2812.

-Services have been tested using "IRC Services" version 5.x of Andrew Church,
+Services have been tested using "IRC Services" version 5.x by Andrew Church,
 homepage: . This document describes setting up
 ngIRCd and these services.

@@ -25,7 +25,7 @@ Setting up ngIRCd
 The "pseudo server" handling the IRC services is configured as a regular
 remote server in the ngircd.conf(5). In addition the variable "ServiceMask"
 should be set, enabling this ngIRCd to recognize the "pseudo users" as IRC
-services insted of regular IRC users.
+services instead of regular IRC users.

 Example:

@@ -39,9 +39,17 @@ Example:
 Setting up IRC Services 5.1.x
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-IRC Services 5.1.x can be used with ngIRCd using the "rfc1459" protocol
-module. At least the following settings have to be tweaked, in addition to all
-the settings marked as required by IRC Services:
+IRC Services 5.1.3 and above can be used with ngIRCd using the "rfc1459"
+protocol module.
+
+Please note that versions up to and including 5.1.3 contain a bug that
+sometimes causes IRC Services to hang on startup. There are two workarounds:
+ a) send the services process a HUP signal ("killall -HUP ircservices")
+ b) apply this patch to the IRC Services source tree:
+    
+
+At least the following settings have to be tweaked, in addition to all the
+settings marked as required by IRC Services:

 In ircservices.conf:

@@ -57,3 +65,6 @@ In modules.conf:

 The documentation of IRC Services can be found here:
 
+
+Please let us know if you are successfully using other IRC service packages or
+which problems you encounter, thanks!

-----END OF PAGE-----