path: root/windows/README-Windows.txt

XZ Utils for Windows
====================

Introduction
------------

    This package includes command line tools (xz.exe and a few
    others) and the liblzma compression library from XZ Utils.
    You can find the latest version and full source code from
    <https://xz.tukaani.org/xz-utils/>.

    The parts of the XZ Utils source code, that are relevant to this
    binary package, are under the BSD Zero Clause License (0BSD).
    XZ Utils have been built using GCC and MinGW-w64 and linked
    statically against the MinGW-w64 runtime libraries. See
    COPYING.MinGW-w64-runtime.txt for copyright and license
    information that applies to the MinGW-w64 runtime.

        IMPORTANT: You must include COPYING.MinGW-w64-runtime.txt
        when distributing these XZ Utils binaries to meet
        the license terms of the MinGW-w64 runtime!

    (The file COPYING mentions GNU getopt_long. It's *not* used when
    XZ Utils is built with MinGW-w64. Thus GNU LGPLv2.1 doesn't apply.)


Package contents
----------------

    All executables and libraries in this package require msvcrt.dll,
    not Universal CRT (UCRT).

    There is a SSE2 optimization in the compression code but this
    version of XZ Utils doesn't include run-time processor detection.
    This is why there is a separate i686-SSE2 version.

    There is one directory for each type of executable and library files:

        bin_i686        32-bit x86 (i686 and newer), Windows 2000 and later
        bin_i686-sse2   32-bit x86 (i686 with SSE2), Windows 2000 and later
        bin_x86-64      64-bit x86-64, Windows Vista and later

    Each of the above directories have the following files:

        *.exe         Command line tools. (It's useless to double-click
                      these; use the command prompt instead.) These have
                      been linked statically against liblzma, so they
                      don't require liblzma.dll. Thus, you can copy e.g.
                      xz.exe to a directory that is in PATH without
                      copying any other files from this package.

                      NOTE: xzdec.exe and lzmadec.exe are optimized for
                      size, single-threaded, and slower than xz.exe.
                      Use xz.exe unless program size is important.

        liblzma.dll   Shared version of the liblzma compression library.
                      This file is mostly useful to developers, although
                      some non-developers might use it to upgrade their
                      copy of liblzma.

    The rest of the directories contain architecture-independent files:

        doc           Basic documentation in the plain text (TXT)
                      format. COPYING.txt, COPYING.0BSD.txt, and
                      COPYING.MinGW-w64-runtime.txt contain
                      copyright and license information.
                      liblzma.def is in this directory too.

        doc/manuals   The manuals of the command line tools in
                      plain text (TXT) and PDF formats.

        doc/api       liblzma API documentation in HTML format.

        doc/examples  Example programs for basic liblzma usage.

        include       C header files for liblzma. These should be
                      compatible with most C and C++ compilers.


Creating an import library for MSVC / Visual Studio
---------------------------------------------------

    To link against liblzma.dll, you need to create an import library
    first. You need the "lib" command from MSVC and liblzma.def from
    the "doc" directory of this package. Here is the command that works
    on 32-bit x86:

        lib /def:liblzma.def /out:liblzma.lib /machine:ix86

    On x86-64, the /machine argument has to be changed:

        lib /def:liblzma.def /out:liblzma.lib /machine:x64

    IMPORTANT: See also the file liblzma-crt-mixing.txt.


Reporting bugs
--------------

    Report bugs to <xz@tukaani.org>.