Recent changes to BuildOnWindows

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Sat, 25 Jul 2020 10:04:03 -0000

--- v8
+++ v9
@@ -5,7 +5,11 @@

 MSYS2 makes building XML Copy Editor much easier:
 1. Visit the [home page of MSYS2](https://www.msys2.org/), then follow the steps to install MSYS2.
-2. Install the required packages listed below in MSYS2 shell. MSYS2 documents how to install a package [here](https://www.msys2.org/docs/package-management/).
+2. Install the required packages listed below in MSYS2 shell.
+~~~sh
+pacman -S zlib aspell expat libiconv libxml2 libxslt pcre ${MINGW_PACKAGE_PREFIX}-wxWidgets ${MINGW_PACKAGE_PREFIX}-xerces-c ${MINGW_PACKAGE_PREFIX}-boost openssl curl
+~~~
+MSYS2 documents how to install a package [here](https://www.msys2.org/docs/package-management/).
 3. Then continue to [Step  14](#14-eclipse-ide-for-cc-developers).

 * [MSYS](https://sourceforge.net/projects/mingw-w64/files/External%20binary%20packages%20%28Win64%20hosted%29/MSYS%20%2832-bit%29/)

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Sat, 25 Jul 2020 09:52:37 -0000

--- v7
+++ v8
@@ -1,5 +1,13 @@
 [TOC]
 #1. Prerequisites
+
+* [MSYS2](https://www.msys2.org/)
+
+MSYS2 makes building XML Copy Editor much easier:
+1. Visit the [home page of MSYS2](https://www.msys2.org/), then follow the steps to install MSYS2.
+2. Install the required packages listed below in MSYS2 shell. MSYS2 documents how to install a package [here](https://www.msys2.org/docs/package-management/).
+3. Then continue to [Step  14](#14-eclipse-ide-for-cc-developers).
+
 * [MSYS](https://sourceforge.net/projects/mingw-w64/files/External%20binary%20packages%20%28Win64%20hosted%29/MSYS%20%2832-bit%29/)
 * MinGW ([Drangon's realse](http://www.drangon.org/mingw/) or [MinGW32](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/) or [MinGW64](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/) or [TDM-GCC](http://tdm-gcc.tdragon.net/))

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Wed, 21 May 2014 00:33:25 -0000

--- v6
+++ v7
@@ -5,7 +5,7 @@

 Edit etc/fstab file of MSYS. Make sure "/mingw" points to the right directory where MinGW is installed. So I strongly recommend keeping two copies of MSYS for MinGW32 and MinGW64 if both 32-bit and 64-bit build are needed.

-If MSYS is installed in D:\msys and MinGW is installed in D:\mingw32, append "D:\msys\bin,D:\mingw32\bin,D:\mingw32\i686-w64-mingw32\bin" to the PATH environment variable.
+If MSYS is installed in **D:\msys** and MinGW is installed in **D:\mingw32**, append "D:\msys\bin,D:\mingw32\bin,D:\mingw32\i686-w64-mingw32\bin" to the PATH environment variable.

 Then the MinGW console can be started with

@@ -79,7 +79,11 @@
 Download and unpack it. It doesn't need to be compiled.

 #14. [Eclipse IDE for C/C++ Developers](http://eclipse.org/downloads/)
-Open the project in Eclipse and compile it.
+Change the default encoding of text files to **UTF-8**. Click Window menu -> Preferences to open the Preferences dialog of Eclipse. Select General -> Workspace on the left, then click the radio button labeled "Others" on the right panel. Choose **UTF-8** from the combo box, which is next to the radio button.
+
+The project folder is src. Import the project into Eclipse. Then select the project and click Project menu -> Properties. In the pop up dialog, select C/C++ Build -> Build Variables on the left. Make sure the variables listed on the right are correct. Change them if they are not. Then select Environment, which is just below "Build Variables", on the left. Check the variables on the right as well.
+
+Compile the project.

 #15. [Inno Setup](http://www.jrsoftware.org/isinfo.php)
 The script file is src\xmlcopyeditor.iss. After it has been compiled, xmlcopyeditor-x.x.x.x-install.exe will be created.

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Mon, 21 Apr 2014 14:52:58 -0000

--- v5
+++ v6
@@ -23,29 +23,29 @@

 #3. [Aspell](http://aspell.net/)

-    configure --prefix=/mingw/i686-w64-mingw32 && make install
+    ./configure --prefix=/mingw/i686-w64-mingw32 && make install

 #4. [expat](http://expat.sourceforge.net/)

-    configure --prefix=/mingw/i686-w64-mingw32 && make install
+    ./configure --prefix=/mingw/i686-w64-mingw32 && make install

 #5. [libiconv](https://www.gnu.org/software/libiconv/)

-    configure --prefix=/mingw/i686-w64-mingw32 && make install
+    ./configure --prefix=/mingw/i686-w64-mingw32 && make install

 #6. [libxml2](http://www.xmlsoft.org/)
 **Please make sure that D:\mingw32\i686-w64-mingw32\lib\libz.dll.a exists before compiling libxml2**. Otherwise, install [zlib](#2-zlib) to avoid wired problems.

-    configure --prefix=/mingw/i686-w64-mingw32 && make install
+    ./configure --prefix=/mingw/i686-w64-mingw32 && make install
     ln -s -t /mingw/i686-w64-mingw32/include libxml2/libxml

 #7. [libxslt](http://xmlsoft.org/libxslt/)

-    configure --prefix=/mingw/i686-w64-mingw32 && make install
+    ./configure --prefix=/mingw/i686-w64-mingw32 && make install

 #8. [pcre](http://www.pcre.org/)

-    configure --prefix=/mingw/i686-w64-mingw32 --enable-unicode-properties --enable-newline-is-any
+    ./configure --prefix=/mingw/i686-w64-mingw32 --enable-unicode-properties --enable-newline-is-any
     make install

 #9. [wxWidgets](http://www.wxwidgets.org/)
@@ -60,23 +60,23 @@

 #10. [openssl](https://www.openssl.org/) (to support HTTPS - optional)

-    configure shared --prefix=/mingw/i686-w64-mingw32 mingw && make install
+    ./configure shared --prefix=/mingw/i686-w64-mingw32 mingw && make install

 #11. [cURL](http://curl.haxx.se/) (to support HTTPS - optional)

-    configure --prefix=/mingw/i686-w64-mingw32 --with-ca-bundle=curl-ca-bundle.crt
+    ./configure --prefix=/mingw/i686-w64-mingw32 --with-ca-bundle=curl-ca-bundle.crt
     make install

-Download [cacert.pem](http://curl.haxx.se/ca/cacert.pem) and rename it to **curl-ca-bundle.crt**, which is the default file name used by curl.exe on Windows. curl.exe searches for that file. But XML Copy Editor, libcurl actually, doesn't. So keep a copy of that file in XML Copy Editor directory. Or HTTPS won't work.
+Download [cacert.pem](http://curl.haxx.se/ca/cacert.pem) and rename it to **curl-ca-bundle.crt**, which is the default file name used by curl.exe on Windows. curl.exe searches for that file in directories listed in PATH environment variable. But XML Copy Editor, libcurl actually, just search it in the current directory, which is specified at build time. So keep a copy of that file in XML Copy Editor directory. Or HTTPS won't work.

 #12. [Xerces-C++](http://xerces.apache.org/xerces-c/)
 Apply [patches](https://sourceforge.net/projects/xml-copy-editor/files/patches/xerces-c-3.1.1/). [cURL](https://sourceforge.net/p/xml-copy-editor/wiki/BuildOnWindows/#11-curl-to-support-https-optional) is required to support HTTPS.

-    configure --prefix=/mingw/i686-w64-mingw32 --disable-sse2
+    ./configure --prefix=/mingw/i686-w64-mingw32 --disable-sse2
     make install

 #13. [Boost C++ Libraries](http://www.boost.org/)
-Download and extract it. It doesn't need to be compiled.
+Download and unpack it. It doesn't need to be compiled.

 #14. [Eclipse IDE for C/C++ Developers](http://eclipse.org/downloads/)
 Open the project in Eclipse and compile it.

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Mon, 21 Apr 2014 14:19:01 -0000

--- v4
+++ v5
@@ -34,7 +34,7 @@
     configure --prefix=/mingw/i686-w64-mingw32 && make install

 #6. [libxml2](http://www.xmlsoft.org/)
-**Please make sure that D:\mingw32\i686-w64-mingw32\lib\libz.dll.a exists before compiling libxml2**. Otherwise, there will be wired problems.
+**Please make sure that D:\mingw32\i686-w64-mingw32\lib\libz.dll.a exists before compiling libxml2**. Otherwise, install [zlib](#2-zlib) to avoid wired problems.

     configure --prefix=/mingw/i686-w64-mingw32 && make install
     ln -s -t /mingw/i686-w64-mingw32/include libxml2/libxml
@@ -49,7 +49,7 @@
     make install

 #9. [wxWidgets](http://www.wxwidgets.org/)
-Apply patches if you're compiling wxWidgets 2.8.12 using MinGW64.
+Apply [patches](https://sourceforge.net/projects/xml-copy-editor/files/patches/wxWidgets-2.8.12/).

     cd wxWidgets-2.8.12/build/msw
     mingw32-make -f makefile.gcc UNICODE=1 USE_GUI=1 USE_XRC=1 CPPFLAGS="-Wno-unused-local-typedefs -Wno-unused-value" CFG=32 VENDOR=xmci686 SHARED=0 BUILD=release
@@ -69,14 +69,14 @@

 Download [cacert.pem](http://curl.haxx.se/ca/cacert.pem) and rename it to **curl-ca-bundle.crt**, which is the default file name used by curl.exe on Windows. curl.exe searches for that file. But XML Copy Editor, libcurl actually, doesn't. So keep a copy of that file in XML Copy Editor directory. Or HTTPS won't work.

-#12. [Boost C++ Libraries](http://www.boost.org/)
-Download and extract it. It doesn't need to be compiled.
-
-#13. [Xerces-C++](http://xerces.apache.org/xerces-c/)
-cURL is required to support HTTPS.
+#12. [Xerces-C++](http://xerces.apache.org/xerces-c/)
+Apply [patches](https://sourceforge.net/projects/xml-copy-editor/files/patches/xerces-c-3.1.1/). [cURL](https://sourceforge.net/p/xml-copy-editor/wiki/BuildOnWindows/#11-curl-to-support-https-optional) is required to support HTTPS.

     configure --prefix=/mingw/i686-w64-mingw32 --disable-sse2
     make install
+
+#13. [Boost C++ Libraries](http://www.boost.org/)
+Download and extract it. It doesn't need to be compiled.

 #14. [Eclipse IDE for C/C++ Developers](http://eclipse.org/downloads/)
 Open the project in Eclipse and compile it.

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Mon, 21 Apr 2014 07:54:56 -0000

--- v3
+++ v4
@@ -17,7 +17,7 @@

 #2. [zlib](http://www.zlib.net/)
-Only needed if D:\mingw32\i686-w64-mingw32\lib\libz.dll.a doesn't exist.
+Only needed if **D:\mingw32\i686-w64-mingw32\lib\libz.dll.a** doesn't exist.

     INCLUDE_PATH=/mingw/i686-w64-mingw32/include LIBRARY_PATH=/mingw/i686-w64-mingw32/lib BINARY_PATH=/mingw/i686-w64-mingw32/bin make install -fwin32/Makefile.gcc SHARED_MODE=1

@@ -34,7 +34,7 @@
     configure --prefix=/mingw/i686-w64-mingw32 && make install

 #6. [libxml2](http://www.xmlsoft.org/)
-**Please make sure D:\mingw32\i686-w64-mingw32\lib\libz.dll.a exists before compiling libxml2.**
+**Please make sure that D:\mingw32\i686-w64-mingw32\lib\libz.dll.a exists before compiling libxml2**. Otherwise, there will be wired problems.

     configure --prefix=/mingw/i686-w64-mingw32 && make install
     ln -s -t /mingw/i686-w64-mingw32/include libxml2/libxml
@@ -69,14 +69,17 @@

 Download [cacert.pem](http://curl.haxx.se/ca/cacert.pem) and rename it to **curl-ca-bundle.crt**, which is the default file name used by curl.exe on Windows. curl.exe searches for that file. But XML Copy Editor, libcurl actually, doesn't. So keep a copy of that file in XML Copy Editor directory. Or HTTPS won't work.

-#12. [Xerces-C++](http://xerces.apache.org/xerces-c/)
+#12. [Boost C++ Libraries](http://www.boost.org/)
+Download and extract it. It doesn't need to be compiled.
+
+#13. [Xerces-C++](http://xerces.apache.org/xerces-c/)
 cURL is required to support HTTPS.

-    configure --prefix=/mingw/i686-w64-mingw32 --enable-static --enable-shared --disable-sse2
+    configure --prefix=/mingw/i686-w64-mingw32 --disable-sse2
     make install

-#13. [Eclipse IDE for C/C++ Developers](http://eclipse.org/downloads/)
+#14. [Eclipse IDE for C/C++ Developers](http://eclipse.org/downloads/)
 Open the project in Eclipse and compile it.

-#14. [Inno Setup](http://www.jrsoftware.org/isinfo.php)
-The scipt file is src\xmlcopyeditor.iss. After it has been compiled, xmlcopyeditor-x.x.x.x-install.exe will be created.
+#15. [Inno Setup](http://www.jrsoftware.org/isinfo.php)
+The script file is src\xmlcopyeditor.iss. After it has been compiled, xmlcopyeditor-x.x.x.x-install.exe will be created.

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Mon, 21 Apr 2014 07:18:55 -0000

--- v2
+++ v3
@@ -9,7 +9,7 @@

 Then the MinGW console can be started with

-    **D:\msys\bin\sh.exe --login **
+    D:\msys\bin\sh.exe --login

 Drangon have created [binary releases](http://www.drangon.org/mingw/) for some libraries listed below.

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Mon, 21 Apr 2014 07:16:58 -0000

--- v1
+++ v2
@@ -79,4 +79,4 @@
 Open the project in Eclipse and compile it.

 #14. [Inno Setup](http://www.jrsoftware.org/isinfo.php)
-The scipt file is src\xmlcopyeditor.iss.
+The scipt file is src\xmlcopyeditor.iss. After it has been compiled, xmlcopyeditor-x.x.x.x-install.exe will be created.

BuildOnWindows modified by Zane U. Ji

Zane U. Ji — Mon, 21 Apr 2014 07:13:45 -0000

1. Prerequisites
2. zlib
3. Aspell
4. expat
5. libiconv
6. libxml2
7. libxslt
8. pcre
9. wxWidgets
10. openssl (to support HTTPS - optional)
11. cURL (to support HTTPS - optional)
12. Xerces-C++
13. Eclipse IDE for C/C++ Developers
14. Inno Setup

1. Prerequisites

MSYS
MinGW (Drangon's realse or MinGW32 or MinGW64 or TDM-GCC)

Edit etc/fstab file of MSYS. Make sure "/mingw" points to the right directory where MinGW is installed. So I strongly recommend keeping two copies of MSYS for MinGW32 and MinGW64 if both 32-bit and 64-bit build are needed.

If MSYS is installed in D:\msys and MinGW is installed in D:\mingw32, append "D:\msys\bin,D:\mingw32\bin,D:\mingw32\i686-w64-mingw32\bin" to the PATH environment variable.

Then the MinGW console can be started with

**D:\msys\bin\sh.exe --login **

Drangon have created binary releases for some libraries listed below.

"--disable-nls" can be added to the configure command line if the localized messages are confusing.

2. zlib

Only needed if D:\mingw32\i686-w64-mingw32\lib\libz.dll.a doesn't exist.

INCLUDE_PATH=/mingw/i686-w64-mingw32/include LIBRARY_PATH=/mingw/i686-w64-mingw32/lib BINARY_PATH=/mingw/i686-w64-mingw32/bin make install -fwin32/Makefile.gcc SHARED_MODE=1

3. Aspell

configure --prefix=/mingw/i686-w64-mingw32 && make install

4. expat

configure --prefix=/mingw/i686-w64-mingw32 && make install

5. libiconv

configure --prefix=/mingw/i686-w64-mingw32 && make install

6. libxml2

Please make sure D:\mingw32\i686-w64-mingw32\lib\libz.dll.a exists before compiling libxml2.

configure --prefix=/mingw/i686-w64-mingw32 && make install
ln -s -t /mingw/i686-w64-mingw32/include libxml2/libxml

7. libxslt

configure --prefix=/mingw/i686-w64-mingw32 && make install

8. pcre

configure --prefix=/mingw/i686-w64-mingw32 --enable-unicode-properties --enable-newline-is-any
make install

9. wxWidgets

Apply patches if you're compiling wxWidgets 2.8.12 using MinGW64.

cd wxWidgets-2.8.12/build/msw
mingw32-make -f makefile.gcc UNICODE=1 USE_GUI=1 USE_XRC=1 CPPFLAGS="-Wno-unused-local-typedefs -Wno-unused-value" CFG=32 VENDOR=xmci686 SHARED=0 BUILD=release

If SHARED=1, add "wxWidgets-2.8.12\lib\gcc_dll32" to the PATH environment variable.

Change CFG and VENDOR if it is a x64 build.

10. openssl (to support HTTPS - optional)

configure shared --prefix=/mingw/i686-w64-mingw32 mingw && make install

11. cURL (to support HTTPS - optional)

configure --prefix=/mingw/i686-w64-mingw32 --with-ca-bundle=curl-ca-bundle.crt
make install

Download cacert.pem and rename it to curl-ca-bundle.crt, which is the default file name used by curl.exe on Windows. curl.exe searches for that file. But XML Copy Editor, libcurl actually, doesn't. So keep a copy of that file in XML Copy Editor directory. Or HTTPS won't work.

12. Xerces-C++

cURL is required to support HTTPS.

configure --prefix=/mingw/i686-w64-mingw32 --enable-static --enable-shared --disable-sse2
make install

13. Eclipse IDE for C/C++ Developers

Open the project in Eclipse and compile it.

14. Inno Setup

The scipt file is src\xmlcopyeditor.iss.