- Makefile.am in doc/en wird nun auch erzeugt :-)

[ngircd-alex.git] / doc / sample-ngircd.conf

diff --git a/doc/sample-ngircd.conf b/doc/sample-ngircd.conf
index 303c4d05fb0e92004328b003d4785efaa9f9cf8a..021bb5b959bb52412cff590e1f4331960daf292d 100644 (file)
--- a/doc/sample-ngircd.conf
+++ b/doc/sample-ngircd.conf
@@ -1,4 +1,4 @@
-# $Id: sample-ngircd.conf,v 1.7 2002/03/29 23:41:23 alex Exp $
+# $Id: sample-ngircd.conf,v 1.9 2002/05/08 15:43:00 alex Exp $
 
 #
 # Das ist eine Beispiel-Konfiguration fuer den ngIRCd, die an die
@@ -6,6 +6,9 @@
 #
 # Kommentare werden mit "#" oder ";" eingeleitet.
 #
+# Autor: Alexander Barton, <alex@barton.de>
+# Erweiterungen von Ilja Osthoff, <ilja@glide.ath.cx>
+#
 
 [Global]
 
@@ -13,24 +16,29 @@
        # Im [Global]-Abschnitt der Konfigurationsdatei wird der Server
        # "an sich" konfiguriert. Notwendig ist nur die Variable "Name",
        # Info ist in der Regel ebengalls anzupassen. Fuer alle uebrigen
-       # Variablen koennen oft die Defaults benutzt werden.
+       # Variablen koennen oft die Defaults benutzt werden, d.h. hier
+       # muss die Variable nicht angegeben werden.
        #
 
        # Servername im IRC-Netz
        Name = irc.the.net
 
-       # Info-Text des Servers
+       # Info-Text des Servers. Dieser wird z.B. bei WHOIS- oder LINKS-
+       # Abfragen entsprechend mit ausgegeben.
        Info = Server Info Text
 
        # Ports, auf denen Verbindungen angenommen werden sollen. Es koennen
        # mehrere Ports mit "," getrennt angegeben werden. (Default: 6667)
        ;Ports = 6667, 6668, 6669
 
-       # Textdatei mit der "Message of the Day" (MOTD)
+       # Textdatei mit der "Message of the Day" (MOTD). Diese wird aus-
+       # gegeben, wenn sich ein User mit dem Server verbindet.
        ;MotdFile = /usr/local/etc/ngircd.motd
 
        # User-ID, unter der der Daemon laufen soll (dazu muss der Server
-       # jedoch mit root-Rechten gestartet werden)
+       # jedoch mit root-Rechten gestartet werden).
+       # ACHTUNG: Die Konfigurations- und MOTD-Datei muessen fuer diesen
+       # Benutzer lesbar sein, ansonsten schlaegt ein RESTART fehl!
        ;ServerUID = 65534
 
        # Group-ID, zu der der Daemon wechseln soll (hierzu muss der Server
@@ -68,22 +76,24 @@
 [Server]
 
        #
-       # In [Server]-Bloecken werden Server konfiguriert, zu denen dieser
-       # Server sich verbinden soll bzw. von denen Verbindungen angekommen
+       # In [Server]-Bloecken werden Server konfiguriert, zu denen sich
+       # dieser ngIRCd verbinden soll bzw. von denen Verbindungen angekommen
        # werden duerfen.
        # Es koennen mehrere Server konfiguriert werden, d.h. [Server]-
        # Bloecke koennen mehrfach vorkommen.
-       # Ist fuer einen Server ein Port konfiguriert, so versucht dieser
-       # Server die Gegenseite zu connectieren. Ist kein Port vorgegeben,
-       # so wartet dieser Server auf eine Verbindung der Gegenseite.
+       # Wenn man fuer einen Server einen Port angegeben hat, dann versucht
+       # sich der ngIRCd mit der Gegenseite zu verbinden. Hat man keinen
+       # Port konfiguriert, dann wartet der ngIRCd darauf, dass sich die
+       # Gegenseite mit ihm verbindet.
        #
        # Server-Gruppen:
-       # Fuer jeden Server kann (optinal!) eine Gruppe konfiguriert werden,
-       # zu der er gehoert (wird nur beachtet, wenn ein Port konfiguriert
-       # ist!): eine solche Server-Gruppe wird quasi als ein Server ange-
-       # sehen, der ngIRCd baut also nur eine Verbindung auf. Schlaegt die
-       # Verbindung zu einem Server in einer Gruppe fehl, so wird der
-       # naechste Server in der Gruppe probiert.
+       # Der ngIRCd unterstuetzt "Server-Gruppen": das bedeutet, man kann
+       # jedem Server, mit dem man sich verbinden will, einer Gruppe zu-
+       # ordnen. Wenn der ngIRCd sich dann mit einem Server aus der Gruppe
+       # verbinden will und keine Antwort erhaelt, dann wird der naechste
+       # Server aus der Gruppe versucht.
+       # Achtung: Gruppen werden nur beachtet, wenn man einen Port fur
+       # die Gegenseite angegeben hat!
        #
 
        # Hostname des Servers