1**********************************************************************
2 THE NOTES BELOW ARE OUT OF DATE
3
4 But here are some hints:
5 1. To generate GPSBabel.vcxproj and GPSBabel.vcxproj.filters
6    qmake -tp vc GPSBabel.pro
7 2. To gather all the bits you need including the dlls
8    use the Qt supplied program windeployoqt, e.g.
9    windeployqt GPSBabel.exe
10**********************************************************************
11
12Building GPSBabel on Windows with QtCreator or Microsoft Visual Studio:
13
14Windows build support is provided for developers, not currently intended
15for release builds or testing. Releases are built with mingw.
16
17Note also that the Microsoft Visual C++ compiler (MSVC) is less standard
18compliant than other compilers and may require code modifications to compile.
19
20Qt:
21To build you need Qt http://qt-project.com. While the regular GPSBabel build
22uses Qt 4.6, it is possible to use the console application with Qt 5.1.
23Note that the behavior may be slightly different for localisation, due to Qt changes.
24
25Other libraries:
26Note that the "Microsoft Windows SDK" (previously "Microsoft Platform SDK")
27is required in addition to the actual compiler package for DeLorme (delbin).
28(Unless you have a special need for this format, it is simpler to patch the
29 code that do not compile.)
30
31QtCreator:
32The GPSBabel.pro file is enabled also for Windows build in QtCreator.
33To build you need to install a compiler (MS Visual Studio C++ or MinGW c/c++).
34Just open the GPSBabel.pro file in QtCreator.
35
36Microsoft Visual Studio:
37If you prefer to use the MS Visual Studio editor ("Visual Studio Express 2012 for
38Windows Desktop" is available for free for non-commercial projects from
39Microsoft), you can generate a GPSBabel.vcxproj file.
40To create the project file GPSBabel.vcxproj, you can just open a command window, change directory to where you want to create the project file and type: <path-to-qmake> <path-to-GPSBabel.pro>
41For example: ../../Qt/5.1.0/msvc2012/bin/qmake.exe gpsbabel/GPSBabel.pro
42
43Note that the default project is maintained separately from the regular build and is
44not used by most regular GPSBabel developers. The project may not be updated
45with for instance new formats.
46
47The MSVS project is setup for MSVS2012. "Visual Studio Express 2012 for
48Windows Desktop" is available for free for non-commercial projects from
49Microsoft.
50The project file may be usable for MSVC2010 too (untested). Older versions
51may work with a modified project file.
52
53You need to modify MSVS default or the GPSBabel project for Qt. The following
54are the default settings:
55 * IncludePath (C:\Qt\5.1.0\msvc2012\include)
56 * LibraryPath (C:\Qt\5.1.0\msvc2012\lib)
57In addition, if you are using Qt 4, change project properties:
58 * Linker->Input->AdditionalIncludeDirectories from qt5core.lib to qtcore.lib.
59
60Other libraries:
61Note that the "Microsoft Windows SDK" (previously "Microsoft Platform SDK")
62is required in addition to the actual compiler package for DeLorme (delbin).
63(Unless you have a special need for this format, it is simpler to patch the
64 code that do not compile.)
65
66Running:
67To run GPSBabel, you must make sure that the dlls (Qt)
68are in the DLL search path.  The easiest way to do this,
69and to avoid version conflicts with other programs, is to put
70the dlls in the same directory as gpsbabel.exe.
71
72If you experience any problems with this project file or with the build
73process, please ask for assistance on the gpsbabel-code mailing list at
74http://lists.sourceforge.net/lists/listinfo/gpsbabel-code
75
76