xz: add missing noreturn for message_filters_help
[xz.git] / windows / INSTALL-MinGW-w64_with_Autotools.txt
blob89c744092eaa91e8979421834bbc44b95c8ba587
2 Creating XZ Utils Windows package with build.bash
3 =================================================
5 Introduction
6 ------------
8     The script build.bash can be used for building XZ Utils with
9     GCC + MinGW-w64 under MSYS2, under the ancient MSYS, or
10     cross-compiling from GNU/Linux. The script will create a package
11     with binaries and documentation in a hopefully-convenient bundle.
13         NOTE: build.bash requires files that are only included
14         in release tarballs. If building from xz.git, a distribution
15         tarball should be created first.
17     For native builds on Windows, the CMake-based build described
18     in the file INSTALL-MinGW-w64_with_CMake.txt is simpler to do as
19     it has no need for MSYS2 and it works from xz.git without extra
20     steps. For cross-compilation and package creation the script can
21     be convenient though.
23     These instructions are for making a package with build.bash and thus
24     don't apply to normal Autotool-based builds under Cygwin or MSYS2.
27 Usage
28 -----
30     First copy the file COPYING.MinGW-w64-runtime.txt from MinGW-w64
31     to this directory. It contains copyright and license notices that
32     apply to the MinGW-w64 runtime that gets statically linked into
33     the XZ Utils binaries being built. build.bash will include the file
34     in the final package.
36     Put i686 and/or x86_64 GCC-based toolchain in PATH depending on
37     which builds are wanted.
39     Optional: Put the 7z tool from 7-Zip or p7zip in PATH. Without
40     this, .zip and .7z files won't be created from the finished "pkg"
41     directory contents.
43     Run build.bash:
45         bash windows/build.bash
47     Note that it does an in-tree build so the build files will be mixed
48     with the source files in the same directory tree.