diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/win32.compiling.1.2.txt | 269 |
1 files changed, 0 insertions, 269 deletions
diff --git a/doc/win32.compiling.1.2.txt b/doc/win32.compiling.1.2.txt deleted file mode 100644 index 93778fab..00000000 --- a/doc/win32.compiling.1.2.txt +++ /dev/null @@ -1,269 +0,0 @@ -Win32 KVIrc compiling 1.2 -a tutorial by <Grifisx> -updated by <LoSko> on 2007/01/18 - -english translation by <etherea`> - -Index - -@ Prologue -@ Ingredients -@ Providing ingredients -@ Setting up the ambiency -@ Setting ambiency variables -@ Compiling -@ Creating ambiency for setup -@ Creating setup - -@ Prologue - -This is meant to be a simple guide to KVIrc compiling under Windows ambiency, so -that everyone who's willing to try to compile the latest version of this cross platform -client can easily do without the need for the latest snapshot/development to be -released. - -@ Ingredients - -1) CVS version of KVIrc -2) Visual C++ 2005 Express -3) SDK package from Microsoft -4) Perl. -5) gettext for Windows -6) Innosetup or NSIS -7) Non Commercial QT 3.2.1 -8) OpenSSL -9) zlib for Win32 - -@ Providing ingredients - -So, let's see where to find the necessary ingredients to bake up our freshy KVIrc. - --1) CVS version of KVIrc - -To get this out you will need a CVS client for Windows, then type the following -command: - -cvs -z3 -d:pserver:[email protected]:/cvs co kvirccvs - - -And just in case you can find instructions here: -Link: http://www.kvirc.net/?id=cvs -A suggestion for a tiny and free CVS is Tortoise CVS. -Link: http://www.tortoisecvs.org/ - --2) Visual C++ 2005 Express - -This compiler is free (at least for the moment), you will only need to register in order to -get it and use it for free, use it! -Link: http://msdn.microsoft.com/vstudio/express/visualc/ - --3) SDK package from Microsoft - -This one too is for free, then download and install it! -Link: http://www.microsoft.com/downloads/details.aspx?FamilyId=A55B6B43-E24F-4EA3A93E-40C0EC4F68E5&displaylang=en - --4) Perl -Perl is needed to create documentation and make perl module works, you can -download it from here: -Link: http://www.activestate.com/Products/ActivePerl/? - --5) gettext for Windows -Download and install it, it's needed to create languages localization files: -Link: http://sourceforge.net/projects/gettext -Note: be sure to install gettext in this directory C:\Program Files\GnuWin32 so that all the -executables are located in C:\Program Files\GnuWin32\bin otherwise you'll be forced to -change something in the file needed to create the setup ambiency. - --6) Innosetup - -Another free program, required to create the final setup. -Link: http://www.jrsoftware.org/isinfo.php -If you are using NSIS you can have your copy here: -Link: http://nsis.sourceforge.net/Download - --7) Non Commercial QT 3.2.1 - -That's probably the most difficult thing to acquire; you can try find a book on QT that -has it enclosed (the non commercial one) or you'll have to figure out how to find it out. -You can buy a commercial version too, 3.x.x higher than 3.2.1. - -Book: C++ GUI Programming with QT 3 -Link: http://www.amazon.com/gp/product/0131240722/102-11831924381702?v=glance&n=283155 -If you are pretty acknowledged with compiling you can try these instructions: -Link: http://qtwin.sourceforge.net/qt3-win32/compile-msvc-2005.php -Even if this last choice's a bit nasty to make out working =) -You still can find some precompiled version of this free stand (found on the same site of -qtwin even if a bit older) but beware: choosing this last chance will make KVIrc XP -themes not supported. -By using a different version of QT you'll need to modify every KVIrc project adapting -the qt.xxxx.dll and headers and libraries paths. -For example, assuming you have installed commercial QT 3.3.4 you'll have to modify -the projects this way: -a) selecting Properties of each project then ->Linker and ->Input -b) store the right library in the qt-mtnc321.lib matching the installed version -requirements, ie qt-3.3.4.lib. To know the exact name of your .lib file to be linked just go -to the directory where you did installed QT, in the subfolder /lib (like C:\Qt\3.3.4\lib) - --8) OpenSSL -That is needed in order to compile SSL support for KVIrc, you can have libraries and -everything else from here: -Link: http://www.slproweb.com/products/Win32OpenSSL.html - --9) zlib for win32 - -To give KVIrc the ability to save log files in compressed format that's what you need. -Link: http://gnuwin32.sourceforge.net/packages/zlib.htm - -That's the main page, but you will need the developers files: -Link: http://gnuwin32.sourceforge.net/downloadlinks/zlib-lib-zip.php -Extract them in any folder you may like, my own suggestion is folder C:\lib for your -convenience; directory tree will be as follows: - -C:(dir) -|__zlib(dir) -|__include(dir) -| |__zconf.h -| |__zlib.h -|__lib(dir) -|__zlib.lib -|__zlib.exp - -Remember where did you have this folder extract because you will have to setup paths -of the include files (the .h files) and of the libraries (the .lib files) in ambiency variables -of your operating system. - -@ Setting up the ambiency - -Install in the following order (theoretically it is not necessary a given order but this -�recipe� is fully oriented to non expert users): -1-Visual C++ 2005 Express -2-SDK ; once you have installed it take the folders Lib, Include and Bin (you will find -them all in the SDK given path � generally in folder C:\Program Files\Microsoft Platform -SDK) and copy them in the folder \SDK\v2.0 that is under the installation path of Visual -C++ (generally in C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0). -Attention: when copying these files you'll be prompted to overwrite one or more files; -just answer NO. -3-QT 3.x.x ; during the installation you'll be prompted to record ambiency variables: -answer YES. -4-OpenSSL ; during the installation you'll be prompted to record ambiency variables: -answer YES. -5-Perl ; during the installation you'll be prompted to record ambiency variables: -answer YES. -6-gettext -7-Innosetup or NSIS or both =) (Freedom is the power to choose ;)) -8-zlib ; if you did download the install&compile package; otherwise just unpack -and/or extract the ready-to-use pakage wherever you may like (generally in folder C:\). - -@ Setting ambiency variables - -Now we need to set up every variable of this ambiency, needed in order the compiler -will be able to find every library from which KVIrc depends. -Right-button on Resources then Properties -> Advanced -> Ambient Variables and this will -engage all QT system variables (TQTDIR) set; if that doesn't match you will need to -reinstall QT and remember to answer YES once you're prompted for setting all ambiency -variables, otherwise you will need to set them manually � that parts from this tutorial. - -In the section dedicated to variables of the actual user add (if you don't have it yet) the -following and then give the right paths that are on your own machine (hereby are my -own paths): - -Variable: - -PERLDIR -Value: -C:\perl -Meaning: -Directory that stores Perl - -Variable: -ZLIBLIBDIR -Value: -C:\zlib\lib -Meaning: -Directory that stores file .lib of zlib installed library, the file name must be zlib.lib - -Variable: -OPENSSL -Value: -C:\OpenSLL -Meaning: -Installation folder of OpenSSL - -Variable: -SSLINCDIR -Value: -C:\OpenSSL\include -Meaning: -Directory that stores OpenSSL .h files - -Variable: -SSLLIBDIR -Value: -C:\OpenSSL\lib\VC -Meaning: -OpenSSL .lib files storage - -Variable: -MSGFMT -Value: -C:\Program Files\GnuWin32\bin\msgfmt.exe -Meaning: -msgfmt executable path - -After you've added all the variables with their own values you need to reboot. - -@ Compiling - -Go to folder kvirccvs\kvirc and open the file kvirc_vc05.sln then -for the less -experienced-select Build -> Configure Manager -> Release and run the compiling with -Build ->Build Solution. -You'll need to wait a little before the building ends, mostly that's up to your processor -(on a P3 800MHz it takes about 40/45 minutes, on a P4 3000 just 10/15 minutes). -Now.. pray everything is going to get the right place and no unexpected to happen; but -in case you do have troubles here are 3 different solutions: - -a) read this tutorial once more, hoping you missed some points; -b) try to find out where the problem is; -c) step to Azzurranet on channel #kvirc.net and ask for Grifisx or Noldor or Pragma. - -@ Creating ambiency for setup - -If you're reading this, thank God, your patience and your mother (yes, yet she didn't -managed to kill you death nevertheless you spent 28 hours a day reading lines on a -monitor) you're almost done! -The latest 2 steps are quite easy. -Go to folder kvirccvs\kvirc\win32build and run makedist.vbs file. -Then run the process, on which end you'll get a folder named pakage; be sure inside -there are kvirc.exe, kvilib.dll, the folder with every KVIrc module and the following dlls: - -ssleay32.dll -libeay32.dll -qt-mtnc3321.dll -perl58.dll -zlib1.dll -idleui.dll -msvcr80.dll - - -If you see something missing just run up a search onto your system and copy them into -the pakage directory. -Check even the file Microsoft.VC80.CRT.manifest is placed both in root folder and sub folder -modules, otherwise copy it into them (files are stored into kvirccvs\kvirc\data\manifests ; -in this last case you will only need to rename the given file -Microsoft.VC80.CRT.modules.manifest into Microsoft.VC80.CRT.manifest before you put it in -the modules folder). - -@ Creating setup - -Easypeasy! -After installation of Innosetup launch file KVIrc.iss that houses in folder -kvirccvs\kvirc\win32build and run the script so that at the end of the process you'll find -a freshy hot setup.exe in folder kvirccvs\kvirc\win32build\package\setup. -If you did chose NSIS: right click on the KVIrc.nsi installation script that is found in -folder kvirccvs\kvirc\win32build and run Compile NSIS Script. -This way you'll have a KVIrc.VERSION-dev-DATE.exe in your actual directory! -Run. -If everything went ok then.. EnjoY! =D - -Tonino Imbesi -<Grifisx> |