Translated source code comments.

diff --git a/src/ngircd/defines.h b/src/ngircd/defines.h
index 214b037cc1a9e44ec135c57723cae2fd89254648..1b7a1d0d02b79970f8b3a995804c69b7c4195b6d 100644 (file)
--- a/src/ngircd/defines.h
+++ b/src/ngircd/defines.h
@@ -8,7 +8,7 @@
  * (at your option) any later version.
  * Please read the file COPYING, README and AUTHORS for more information.
  *
- * $Id: defines.h,v 1.47 2005/01/17 13:01:34 alex Exp $
+ * $Id: defines.h,v 1.48 2005/01/17 13:14:36 alex Exp $
  *
  * Global defines of ngIRCd.
  */
@@ -19,67 +19,67 @@
 
 #define NONE -1
 
-#define FNAME_LEN 256                  /* max. Laenge eines Dateinamen */
+#define FNAME_LEN 256                  /* max. length of file name */
 
-#define LINE_LEN 256                   /* max. Laenge einer Konfigurationszeile */
+#define LINE_LEN 256                   /* max. length of a line in the configuration file */
 
-#define HOST_LEN 256                   /* max. Laenge eines Hostnamen */
+#define HOST_LEN 256                   /* max. lenght of fully qualified host names */
 
-#define MAX_LISTEN_PORTS 16            /* max. Anzahl von Listen-Ports */
+#define MAX_LISTEN_PORTS 16            /* max. count of listening ports */
 
-#define MAX_OPERATORS 16               /* max. Anzahl konfigurierbarer Operatoren */
+#define MAX_OPERATORS 16               /* max. count of configurable operators */
 
-#define MAX_SERVERS 16                 /* max. Anzahl konfigurierbarer Server ("Peers") */
+#define MAX_SERVERS 16                 /* max. count of configurable servers ("peers") */
 
-#define MAX_DEFCHANNELS 16             /* max. Anzahl vorkonfigurierbarerr Channels */
+#define MAX_DEFCHANNELS 16             /* max. count of preconfigurable channels */
 
-#define MAX_SERVICES 8                 /* maximum number of configurable services */
+#define MAX_SERVICES 8                 /* max. number of configurable services */
 
-#define CONNECTION_POOL 100            /* Anzahl Verbindungs-Strukturen, die blockweise alloziert werden */
+#define CONNECTION_POOL 100            /* size of default connection pool */
 
-#define CLIENT_ID_LEN 64               /* max. ID-Laenge; vgl. RFC 2812, 1.1 und 1.2.1 */
-#define CLIENT_NICK_LEN 10             /* max. Nick-Laenge; vgl. RFC 2812, 1.2.1 */
-#define CLIENT_PASS_LEN 21             /* max. Laenge des Passwortes */
-#define CLIENT_USER_LEN 9              /* max. Laenge des Benutzernamen ("Login") */
-#define CLIENT_NAME_LEN 32             /* max. Laenge des "langen Benutzernamen" */
-#define CLIENT_HOST_LEN 64             /* max. Laenge des Hostname */
-#define CLIENT_MODE_LEN 8              /* max. Laenge der Client-Modes */
-#define CLIENT_INFO_LEN 64             /* max. Infotext-Laenge (Server) */
-#define CLIENT_AWAY_LEN 128            /* max. Laenger der AWAY-Nachricht */
-#define CLIENT_FLAGS_LEN 100           /* max. Laenger der Client-Flags */
+#define CLIENT_ID_LEN 64               /* max. length of an IRC ID; see RFC 2812, 1.1 and 1.2.1 */
+#define CLIENT_NICK_LEN 10             /* max. nick length; see. RFC 2812, 1.2.1 */
+#define CLIENT_PASS_LEN 21             /* max. password length */
+#define CLIENT_USER_LEN 9              /* max. length of user name ("login") */
+#define CLIENT_NAME_LEN 32             /* max. length of "real names" */
+#define CLIENT_HOST_LEN 64             /* max. host name length */
+#define CLIENT_MODE_LEN 8              /* max. lenth of all client modes */
+#define CLIENT_INFO_LEN 64             /* max. length of server info texts */
+#define CLIENT_AWAY_LEN 128            /* max. length of away messages */
+#define CLIENT_FLAGS_LEN 100           /* max. length of client flags */
 
-#define CHANNEL_NAME_LEN 51            /* max. Laenge eines Channel-Namens, vgl. RFC 2812, 1.3 */
-#define CHANNEL_MODE_LEN 8             /* max. Laenge der Channel-Modes */
-#define CHANNEL_TOPIC_LEN 128          /* max. Laenge eines Channel-Topics */
+#define CHANNEL_NAME_LEN 51            /* max. length of a channel name, see. RFC 2812, 1.3 */
+#define CHANNEL_MODE_LEN 8             /* max. length of channel modes */
+#define CHANNEL_TOPIC_LEN 128          /* max. length of a channel topic */
 
-#define COMMAND_LEN 513                        /* max. Laenge eines Befehls, vgl. RFC 2812, 3.2 */
+#define COMMAND_LEN 513                        /* max. IRC command length, see. RFC 2812, 3.2 */
 
-#define READBUFFER_LEN 2048            /* Laenge des Lesepuffers je Verbindung (Bytes) */
-#define WRITEBUFFER_LEN 4096           /* Laenge des Schreibpuffers je Verbindung (Bytes) */
+#define READBUFFER_LEN 2048            /* size of the read buffer of a connection (bytes) */
+#define WRITEBUFFER_LEN 4096           /* size of the write buffer of a connection (bytes) */
 
 #ifdef ZLIB
-#define ZREADBUFFER_LEN 1024           /* Laenge des Lesepuffers je Verbindung (Bytes) */
-#define ZWRITEBUFFER_LEN 4096          /* Laenge des Schreibpuffers fuer Kompression (Bytes) */
+#define ZREADBUFFER_LEN 1024           /* compressed read buffer of a connection (bytes) */
+#define ZWRITEBUFFER_LEN 4096          /* compressed write buffer of a connection (bytes) */
 #endif
 
-#define PROTOVER "0210"                        /* implementierte Protokoll-Version (RFC 2813, 4.1.1) */
-#define PROTOIRC "-IRC"                        /* Protokoll-Suffix (RFC 2813, 4.1.1) */
-#define PROTOIRCPLUS "-IRC+"           /* Protokoll-Suffix f\9fr IRC+-Protokoll */
+#define PROTOVER "0210"                        /* implemented IRC protocol version (see RFC 2813, 4.1.1) */
+#define PROTOIRC "-IRC"                        /* protocol suffix (see RFC 2813, 4.1.1) */
+#define PROTOIRCPLUS "-IRC+"           /* protokol suffix for IRC+ protocol (see doc/Protocol.txt) */
 
 #ifdef IRCPLUS
-# define IRCPLUSFLAGS "CL"             /* IRC+-Flags, die immer zutreffen */
+# define IRCPLUSFLAGS "CL"             /* standard IRC+ flags */
 #endif
 
-#define STARTUP_DELAY 1                        /* Erst n Sek. nach Start zu anderen Servern verbinden */
-#define RECONNECT_DELAY 3              /* Server-Links erst nach 3 Sekunden versuchen, wieder aufzubauen */
+#define STARTUP_DELAY 1                        /* delay outgoing connections n seconds after startup */
+#define RECONNECT_DELAY 3              /* time to delay re-connect attempts (seconds) */
 
-#define USERMODES "aios"               /* unterstuetzte User-Modes */
-#define CHANMODES "biklImnoPtv"                /* unterstuetzte Channel-Modes */
+#define USERMODES "aios"               /* supported user modes */
+#define CHANMODES "biklImnoPtv"                /* supported channel modes */
 
-#define CONNECTED TRUE                 /* fuer die irc-xxx-Module */
+#define CONNECTED TRUE                 /* internal status codes */
 #define DISCONNECTED FALSE
 
-#define DEFAULT_AWAY_MSG "Away"                /* Away-Meldung fuer User von anderen Servern */
+#define DEFAULT_AWAY_MSG "Away"                /* away message for users connected to linked servers */
 
 #define CONFIG_FILE "/ngircd.conf"
 #define MOTD_FILE "/ngircd.motd"
@@ -88,14 +88,14 @@
 
 #define ERROR_DIR "/tmp"
 
-#define MAX_LOG_MSG_LEN 256            /* max. Laenge einer Log-Meldung */
+#define MAX_LOG_MSG_LEN 256            /* max. length of a log message */
 
-#define TOKEN_OUTBOUND -2              /* Kennzeichnung fuer ausgehende Server-Links im Aufbau */
+#define TOKEN_OUTBOUND -2              /* tag for outbound server links */
 
-#define NOTICE_TXTPREFIX ""            /* Kennzeichnung fuer Server-NOTICEs an User */
+#define NOTICE_TXTPREFIX ""            /* prefix for NOTICEs from the server to users */
 
 #ifdef RENDEZVOUS
-#define RENDEZVOUS_TYPE "_ircu._tcp."  /* Service type to register with Rendezvous */
+#define RENDEZVOUS_TYPE "_ircu._tcp."  /* service type to register with Rendezvous */
 #endif