dos/INSTALL.txt

   1
   2 Building XZ Utils for DOS
   3 =========================
   4
   5 Introduction
   6
   7     This document explains how to build XZ Utils for DOS using DJGPP.
   8     The resulting binaries should run at least on various DOS versions
   9     and under Windows 95/98/98SE/ME.
  10
  11     This is somewhat experimental and has got very little testing.
  12
  13     Note: Makefile and config.h are updated only now and then. This
  14     means that if you checked out a development version, building for
  15     DOS might not work without updating Makefile and config.h first.
  16
  17
  18 Getting and Installing DJGPP
  19
  20     You may use <https://www.delorie.com/djgpp/zip-picker.html> to help
  21     deciding what to download. If you are only interested in building
  22     XZ Utils, the zip-picker may list files that you don't strictly
  23     need. However, using the zip-picker can still be worth it to get a
  24     nice short summary of installation instructions (they can be found
  25     from readme.1st too).
  26
  27     For a more manual method, first select a mirror from
  28     <https://www.delorie.com/djgpp/getting.html> and go the
  29     subdirectory named "current". You need the following files:
  30
  31         unzip32.exe  (if you don't already have a LFN-capable unzipper)
  32         v2/djdev205.zip
  33         v2gnu/bnu234b.zip
  34         v2gnu/gcc920b.zip
  35         v2gnu/mak43b.zip
  36         v2misc/csdpmi7b.zip
  37
  38     If newer versions are available, probably you should try them first.
  39     Note that versions older than djdev205.zip aren't supported. Also
  40     note that you want csdpmi7b.zip even if you run under Windows or
  41     DOSEMU because the XZ Utils Makefile will embed cwsdstub.exe to
  42     the resulting xz.exe.
  43
  44     See the instructions in readme.1st found from djdev205.zip. Here's
  45     a short summary, but you should still read readme.1st.
  46
  47         C:\> mkdir DJGPP
  48         C:\> cd DJGPP
  49         C:\DJGPP> c:\download\unzip32 c:\download\djdev205.zip
  50         C:\DJGPP> c:\download\unzip32 c:\download\bnu234b.zip
  51         C:\DJGPP> c:\download\unzip32 c:\download\gcc920b.zip
  52         C:\DJGPP> c:\download\unzip32 c:\download\mak43b.zip
  53         C:\DJGPP> c:\download\unzip32 c:\download\csdpmi7b.zip
  54
  55         C:\DJGPP> set PATH=C:\DJGPP\BIN;%PATH%
  56         C:\DJGPP> set DJGPP=C:\DJGPP\DJGPP.ENV
  57
  58     You may want to add the last two lines into AUTOEXEC.BAT or have,
  59     for example, DJGPP.BAT which you can run before using DJGPP.
  60
  61     Make sure you use completely upper case path in the DJGPP environment
  62     variable. This is not required by DJGPP, but the XZ Utils Makefile is
  63     a bit stupid and expects that everything in DJGPP environment variable
  64     is uppercase.
  65
  66
  67 Building
  68
  69     You need to have an environment that supports long filenames (LFN).
  70     Once you have built XZ Utils, the resulting binaries can be run
  71     without long filename support.
  72
  73     Run "make" in this directory (the directory containing this
  74     INSTALL.txt). You should get xz.exe (and a bunch of temporary files).
  75     Other tools are not built. Having e.g. xzdec.exe doesn't save much
  76     space compared to xz.exe because the DJGPP runtime makes the .exe
  77     quite big anyway.
  78