Updated instructions for building QGIS with MSYS environment.

git-svn-id: http://svn.osgeo.org/qgis/trunk@6117 c8812cc2-4d05-0410-92ff-de0c093fc19c
qgis · Nov 23, 2006 · a5f9b92 · a5f9b92
1 parent bf34ea2
commit a5f9b92
Showing 1 changed file with 62 additions and 35 deletions.
diff --git a/README_windows.txt b/README_windows.txt
@@ -10,77 +10,104 @@ Note: The process for building under windows is still being sorted out so
       check this document regularly for updates.
 
 Msys:
--------------
-get this : 
+-----
+get this: 
 
-http://qgis.org/uploadfiles/msys/msys.zip 
+http://qgis.org/uploadfiles/msys/msys.tar.bz2
 
 and unpack to c:\msys
 
-The file is compressed using zip - you can get a free windows application for creating and decompressing zip files here:
+The file is compressed using bzip2 - you can get a free windows application
+for creating and decompressing files here:
 
-http://www.filzip.com/
+http://www.7-zip.org/
 
 Qt4.2:
--------------
+------
 Download qt4.2 opensource precompiled edition exe and install (including the 
-download and install of mingw).
+download and install of mingw) from here:
+
+http://www.trolltech.com/developer/downloads/qt/windows
 
 Edit C:\Qt\4.2.0\bin\qtvars.bat and add the following line (the second is only 
 needed if you like vim in your shell):
 
-set PATH=%PATH%;C:\msys\local\bin
+set PATH=%PATH%;C:\msys\local\bin;c:\msys\local\lib
 set PATH=%PATH%;"c:\Program Files\Vim\vim70\
 
 
-NSIS:
--------------
-Downlad and install NSIS from (http://nsis.sourceforge.net/Main_Page)
+QGIS:
+-----
+Check out to c:\dev\cpp\qgis:
 
-GDB:
--------------
-Download and install gdb-6.3.2.exe from 
+cd c:\dev\cpp
+svn co https://svn.qgis.org/repos/qgis/trunk/qgis
 
-http://sourceforge.net/project/showfiles.php?group_id=2435 
+Currently you need to put it into that location in case you plan to create
+the NSIS installer because so far it contains hardcoded paths for this location.
 
-and install into c:\mingw
 
+Source changes:
+---------------
 
-QGIS:
--------------
-Check out to c:\dev\cpp\qgis
-Currently you need to put it into that location I think - if you try to build
-somewhere else you *may* run into problems - particularly with the NSIS installer 
-as I havent checked all paths are relative yet.
+Next you need to shift some files around. For convenience we've made an archive
+that handles all the changes for you. Download it and unpack to qgis source directory:
 
-Next you need to shift some files around. Note I expect this requirement to go away
-once the windows build process is refined a bit.
+http://qgis.org/uploadfiles/msys/qgis-qmake-files.zip
 
+List of what has been changed / added by this archive to enable compilation:
 
-Core:
--------------
- - moved qgsspatialrefsys* and qgscoordinatetransform* into core dir from gui
+ - moved qgscsexception.h, qgsspatialrefsys* and qgscoordinatetransform* into core dir from gui
+ - moved qgspluginregistry.* from core to gui
+ - qgsspatialrefsys.cpp - commented out SRS validation using projection selector
  - qgsspatialrefsys.cpp - commented out lines using qgsproject as it depends on gui stuff
  - qgsdistancearea.cpp - commented out lines using qgsproject as it depends on 
    gui stuff and moved to core
- - qgscsexception.h  into core from gui (only tested on mac)
-
-I have created a small archive which includes the above changes, which I will make available.
-
+ - lexer and parser generated by genlexyacc.bat
+ - added custom qgsconfig.h and qgssvnversion.h
 
 
 Building:
--------------
+---------
 
-Now open the qt command shell
+Now open the qt command shell (or start "cmd" and run c:\Qt\4.2.0\qtvars.bat)
 
 cd c:\dev\cpp\qgis
 qmake
 make
 
+This will compile both debug and release version. To make just a one of them
+use "make debug" or "make release" respectively.
+
+Note: debug version uses debug version of Qt library thus if linking fails
+on not founding library QtSvgd4 (or similar), you need to install them.
+
+Running: (optional)
+--------
+
+After successfull make you can run QGIS directly from the directory
+where it has been built: qgis-debug and/or qgis-release in qgis root dir.
+You only need to add data files - we have provided an archive for convenience
+which you can just unpack there and run QGIS:
 
-Create the installation package:
----------------------------------
+http://qgis.org/uploadfiles/msys/qgis_data.zip
+
+Then just run qgis.exe
+
+GDB: (optional)
+----
+
+If you plan to do some debugging, download and install gdb-6.3.2.exe from 
+
+http://prdownloads.sourceforge.net/mingw/gdb-6.3-2.exe?download
+
+and install to c:\msys\mingw
+
+
+Create the installation package: (optional)
+--------------------------------
+
+Downlad and install NSIS from (http://nsis.sourceforge.net/Main_Page)
 
 Download both the QGIS debug and release installer packages from