BUILD : 1.7.8 (565) BUGS : 293 NOTES : Merge of Win32 branch into the main, support for Unreal +I, German language updated, fixed bug vidents not updating, Setting and Removal of sqlines on forbid or drop

git-svn-id: svn://svn.anope.org/anope/trunk@567 31f1291d-b8d6-0310-a050-a5561fc1590b


git-svn-id: http://anope.svn.sourceforge.net/svnroot/anope/trunk@417 5417fbe8-f217-4b02-8779-1006273d7864

1 files changed, 149 insertions, 0 deletions

diff --git a/docs/WIN32.txt b/docs/WIN32.txt
new file mode 100644
index 000000000..21adb7e41
--- /dev/null
+++ b/docs/WIN32.txt
@@ -0,0 +1,149 @@
+Anope for Windows
+
+1. Building the source
+2. Installation
+3. Compiling modules
+4. Credits
+
+=========================================================================
+= 1. Building from the ground up                                        =
+=========================================================================
+
+    If you want to build Anope on the Win32 system you will need to obtain
+the following items. 
+
+1. Download the files required
+
+- Current Anope source:
+	http://zero.org:7467/viewcvs/trunk.tar.gz
+
+If you have Visual C++ 6, 7 or .NET skip ahead to step 2, else download
+the following free components from Microsoft. Once downloaded install these packages
+
+- VCToolKit:
+    http://download.microsoft.com/download/3/9/b/39bac755-0a1e-4d0b-b72c-3a158b7444c4/VCToolkitSetup.exe
+
+- .NET Framework 1.1 Redistributable:
+    http://download.microsoft.com/download/a/a/c/aac39226-8825-44ce-90e3-bf8203e74006/dotnetfx.exe
+
+- .NET Framework SDK 1.1:
+    http://download.microsoft.com/download/5/2/0/5202f918-306e-426d-9637-d7ee26fbe507/setup.exe
+
+- Core SDK for the needed libraries:
+   http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
+
+- MySQL for Windows - needed if building for mysql
+   http://www.mysql.com
+
+
+2. Unpack the Anope tarball with your favorite uncompression program (winzip or winrar)
+
+3. Open Makefile.inc.win32 in the main directory with a text editor (notepad or notepad clones)
+   
+   A. change the line "IRCD=" to match the ircd that you want to build, and place that number
+      after the = so if your building Unreal 3.2 (#10), you would change the line to read
+      "IRCD=10"
+
+   B. If you are building for MySQL change USE_MYSQL to equal 1 (ie.. USE_MYSQL=1), the next
+      two lines you must enter the path to the MySQL installation. MYSQL_INC, and MYSQL_LIB,
+      You can define the path one of two ways, either with \ or / if you use \ you must add
+      a secondary \ so c:\mysql would be c:\\mysql
+
+   C. To use Anope build in Proxy scan you can change PROXY_SCANNER to be equal to 1
+      (ie.. PROXY_SCANNER=1), note the proxy scan is not the best and its recommended to use
+      another thrid party scanner.
+
+   D. If you are using Visual Studio 6, this next line can be very important. If you are an 
+      error during compile about "unresolved external symbol __ftol2", remove the # in front
+      of VC6=/QIfist and attempt to compile again.
+
+   E. When compiling if you get an error about 'Cannot find wsock32.lib' or 'Cannot find 
+      msvcrt.lib' You need to define the libpath, in the LIBPATH directive. You can define 
+      the path one of two ways, either with \ or / if you use \ you must add a secondary \ 
+      so c:\mysql would be c:\\sdk\lib be sure to remove the # in front of LFLAGS
+
+   F. Most import is to set the DATDEST to be the folder name where data will be stored. 
+      This does not need to be the full path just the folder under the main executable 
+      in which data will exist. In our example we will use "data"
+ 
+4. You are now ready to compile, bring up the Visual C++ toolkit command prompt, this 
+   will launch a dos command prompt like window, which will set the enviroment properties 
+   need to make Anope. Change directories to where you unpacked the source code in step 2. 
+   At the prompt type
+
+   nmake -f Makefile.win32
+
+   Once you are back at the command prompt again, if there have been no 
+   errors, you are ready to go, should you encounter errors check how to adjust 
+   the makefile.inc.win32 to help resolve the issue.
+
+5. Anope will install the files where the belong. The only thing you need to do
+   is rename "data/example.conf" to be "services.conf"
+
+You have now complete the building phase of Anope for Windows. Move to the 
+section related to setting up Anope.
+
+=========================================================================
+= 2. Installation                                                       =
+=========================================================================
+
+    Since Anope for Windows does not use a visual interface, you must do
+the configuration before getting to far into this.
+
+Open services.conf, and make the following edits
+
+A. RemoteServer : this is the address to your ircd, along with the port
+                  and password. You should consult your ircd documentation
+                  on how to link ircds.
+B. ServicesRoot : Remove the # and change the names to your nick so you
+                  can take control of services once they are online.
+
+If you are unsure of the settings, You can go to the dos command prompt
+and run "anope.exe -nofork -debug" and watch the information as it
+attempts to connect.
+
+To launch services you can do it one of two ways, if you are sure that the
+configuration information is correct, simply double clicking on it will 
+cause it to start, no window will come up. You can start at the dos prompt
+and type in "anope.exe" if services are successful in starting up
+the dos prompt will seem to hang, at this point you can close the dos
+window
+
+=========================================================================
+= 3. Compiling Modules                                                  =
+=========================================================================
+
+    If you want to build other modules. You will need to modify the
+Makefile.inc.win32
+
+   A. When compiling if you get an error about 'Cannot find wsock32.lib' 
+      or 'Cannot find msvcrt.lib' You need to define the libpath, in the 
+      LIBPATH directive. You can define the path one of two ways, either 
+      with \ or / if you use \ you must add a secondary \ so c:\mysql 
+      would be c:\\sdk\lib be sure to remove the # in front of LFLAGS
+
+   B. Add modules fine the line of "SRCS=" add the name of the file to
+      the end of the line. So if you have two files
+
+      "SRCS=file.c file2.c"
+
+When that is done, use the same command prompt you set up in Part 1,
+change directores to the src/modules folder and type
+
+nmake -f Makefile.win32
+
+Copy the *.dll files that get created to the "data/modules/runtime"
+folder.
+
+=========================================================================
+= 4. Credits                                                            =
+=========================================================================
+
+    Anope is based on the code of Epona and IRCServices see README for
+full list of developers.
+
+    Anope Winodws code is provided by
+
+    Dominick Meglio   <codemastr@unrealircd.com>
+    Trystan Scott Lee <trystan@nomadirc.net>
+    Chris Hogben	  <heinz@anope.org>
\ No newline at end of file