added new self-made config parser with new config style
[NeonServV5.git] / INSTALL
1               NeonServ Installation Instructions
2
3 Introduction:
4 ----------
5 If you encounter any problems compiling/running NeonServ, please make 
6 sure you have followed the directions in this file correctly and that 
7 all of the requirements listed below are met.
8
9 If the problem persists, report it to one (or all) of the coders
10 listed in the AUTHORS file. Please try to include ALL relevant
11 information about the error/bug, including anything out of the
12 ordinary reported from make and the appropriate entries from the log
13 files.
14
15 Quick Install:
16 ----------
17 $ ./autogen.sh
18 $ ./configure
19 $ make
20 $ ${EDITOR} neonserv.conf
21     NOTE: You may want to copy neonserv.example.conf to neonserv.conf and
22     edit that.
23 $ ./neonserv
24
25 Compiling:
26 ----------
27   1) Enter the root directory of the NeonServ tree.  If installation is 
28      done from outside of it, it may cause problems during compile, or 
29      during runtime.
30
31   2) If you've cloned a development snapshot of NeonServ from git.pk910.de
32      you need to generate the configure and Makefile files. For that you
33      simply need to run the autogen.sh script.
34      (chmood it to be executeable if needed)
35
36   3) Run the configure script (sh configure), it will verify that your
37      system will have the resources needed for NeonServ to compile. If 
38      you would like to change the path where NeonServ will be installed 
39      to, execute configure with the --prefix=/path option.  The default 
40      path is ~/neonserv/.
41
42
43   4) You may optionally edit config.h in case the configure script made a
44      mistake.
45
46   5) Execute the "make" command to begin compiling.  If you encounter any
47      uncorrectable errors/warnings, please scroll up to the introduction
48      section and follow the instructions.
49
50   6) You may now either type "make install" to install it to your
51      installation path, or work from your build directory, either is fine.
52
53   7) Copy neonserv.example.conf to neonserv.conf and edit the mysql information.
54
55  10) Once you have NeonServ for the first time, it will create the neccesary
56      tables in your database. Take a look into `bots` to edit Bot settings like
57      nick and server (You need to restart the bot to apply these settings). 
58      You also need to add youself into the `users` table with 1000 access. 
59
60  11) You can now register a channel via the bots query ;)
61
62 End of file, INSTALL.
63
64 -pk910 (neonserv@pk910.de)