Updated documentation.

[ngircd-alex.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 47b4c377fc4a50bc3e63d0f64ef0ad5148b1a8ca..86ba971abb551b1d8368e719aea30691be6e6d93 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -14,9 +14,16 @@
 I. Upgrade Information
 ~~~~~~~~~~~~~~~~~~~~~~
 
+Differences to version 0.6.x
+
+- Some options of the configure script have been renamed:
+    --disable-syslog  ->  --without-syslog
+    --disable-zlib    ->  --without-zlib
+  Please call "./configure --help" to review the full list of options!
+
 Differences to version 0.5.x
 
-- Starting with version 0.6.0, other servers are identified using asyncronous
+- Starting with version 0.6.0, other servers are identified using asynchronous
   passwords: therefore the variable "Password" in [Server]-sections has been
   replaced by "MyPassword" and "PeerPassword".
 
@@ -27,8 +34,8 @@ Differences to version 0.5.x
 II. Standard Installation
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-ngIRCd is developed for UNIX-like systems, which means that the installation
-on modern UNIX-like systems witch are supported by GNU autoconf and GNU
+ngIRCd is developed for UNIX-based systems, which means that the installation
+on modern UNIX-like systems that are supported by GNU autoconf and GNU
 automake ("configure") should be no problem.
 
 The normal installation procedure after getting (and expanding) the source
@@ -39,25 +46,28 @@ files (using a distribution archive or CVS) is as following:
   3) make
   4) make install
 
+
 1): "autogen.sh"
 
 The first step, autogen.sh, is only necessary if the configure-script isn't
 already generated. This never happens in official ("stable") releases in
-tar.gz-archieves, but when using CVS.
+tar.gz-archives, but when using CVS.
 
-This step is therefore only interesting for developpers.
+This step is therefore only interesting for developers.
 
 autogen.sh produces the Makefile.in's, which are necessary for the configure
 script itself, and some more files for make. To run autogen.sh you'll need
-GNU autoconf and GNU automake (in recent versions!).
+GNU autoconf and GNU automake (use recent versions! autoconf 2.53 and
+automake 1.6.1 are known to work).
 
 Again: "end users" do not need this step!
 
-4): "./configure"
 
-The configure-script is used to detect local system dependancies.
+2): "./configure"
+
+The configure-script is used to detect local system dependencies.
 
-In the perfect case, configure should recognize all needed libraries, header
+In the perfect case, configure should recognise all needed libraries, header
 files and so on. If this shouldn't work, "./configure --help" shows all
 possible options.
 
@@ -65,12 +75,14 @@ In addition, you can pass some command line options to "configure" to enable
 and/or disable some features of ngIRCd. All these options are shown using
 "./configure --help", too.
 
-5): "make"
+
+3): "make"
 
 The make command uses the Makefiles produced by configure and compiles the
 ngIRCd daemon.
 
-6): "make install"
+
+4): "make install"
 
 Use "make install" to install the server and a sample configuration file on
 the local system. Normally, root privileges are necessary to complete this
@@ -79,7 +91,7 @@ overwritten.
 
 This files will be installed by default:
 
-- /usr/local/sbin/ngircd: exectable server
+- /usr/local/sbin/ngircd: executable server
 - /usr/local/etc/ngircd.conf: sample configuration (if not already present)
 
 
@@ -95,7 +107,7 @@ targets:
  - distclean: the above plus erase all generated Makefiles
    next step: -> ./configure
 
- - maintainer-clean: erease all automatic generated files
+ - maintainer-clean: erase all automatic generated files
    next step: -> ./autogen.sh
 
 
@@ -105,16 +117,19 @@ III. Sample configuration file ngircd.conf
 In the sample configuration file, there are comments beginning with "#" OR
 ";" -- this is only for the better understanding of the file.
 
-The file is seperated in four blocks: [Global], [Operator], [Server], and
-[Channel]. In the [Gobal] part, there is the main configuration, like the
-server-name and the ports, on which the server should be listening. In the
-[Operator] section, the server-operators are defined and [Server] is the
-section, where the server-links are configured. Use [Channel] blocks to
+The file is separated in four blocks: [Global], [Operator], [Server], and
+[Channel].
+
+In the [Global] section, there is the main configuration like the server
+name and the ports, on which the server should be listening. IRC operators
+of this server are defined in [Operator] blocks. [Server] is the section
+where server links are configured. And [Channel] blocks are used to
 configure pre-defined ("persistent") IRC channels.
 
 The meaning of the variables in the configuration file is explained in the 
 "doc/sample-ngircd.conf", which is used as sample configuration file in
-/usr/local/etc after running "make install" (if you don't already have one).
+/usr/local/etc after running "make install" (if you don't already have one)
+and in the "ngircd.conf" manual page.
 
 
 IV. Command line options
@@ -142,4 +157,4 @@ number. In both cases the server exits after the output.
 
 
 -- 
-$Id: INSTALL,v 1.10 2003/03/04 13:46:53 alex Exp $
+$Id: INSTALL,v 1.15 2003/03/23 23:13:15 alex Exp $