Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(95)

Side by Side Diff: dos/README

Issue 7109015: Update XZ Utils to 5.0.3 (in deps) (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/deps/third_party/xz/
Patch Set: Created 9 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
« no previous file with comments | « dos/Makefile ('k') | dos/config.h » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 1
2 XZ Utils on DOS 2 XZ Utils on DOS
3 =============== 3 ===============
4 4
5 Introduction 5 Introduction
6 6
7 This document explains how to build XZ Utils for DOS using DJGPP. 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 8 The resulting binaries should run at least on various DOS versions
9 and under Windows 95/98/98SE/ME, which cannot run the Windows version 9 and under Windows 95/98/98SE/ME, although the Windows version of
10 of XZ Utils. 10 XZ Utils is recommended under Windows 95 and later.
11 11
12 This is currently experimental and has got very little testing. 12 This is currently experimental and has got very little testing.
13 13
14 Note: Makefile and config.h are updated only now and then. This
15 means that especially if you checked out a development version,
16 building for DOS probably won't work without updating Makefile
17 and config.h first.
18
14 19
15 Getting and Installing DJGPP 20 Getting and Installing DJGPP
16 21
17 You may use <http://www.delorie.com/djgpp/zip-picker.html> to help 22 You may use <http://www.delorie.com/djgpp/zip-picker.html> to help
18 deciding what to download, but as of writing (2009-02-13) that may 23 deciding what to download, but as of writing (2010-10-09) that may
19 not be the most convenient way taking into account what components 24 not be the most convenient way taking into account what components
20 are actually required to build XZ Utils. However, using the 25 are actually required to build XZ Utils. However, using the
21 zip-picker can still be worth doing to get nice short summary of 26 zip-picker can still be worth doing to get nice short summary of
22 installation instructions (they can be found from readme.1st too). 27 installation instructions (they can be found from readme.1st too).
23 28
24 For more manual method, first select a mirror from 29 For a more manual method, first select a mirror from
25 <http://www.delorie.com/djgpp/getting.html>. You need 30 <http://www.delorie.com/djgpp/getting.html>. You need
26 the following files: 31 the following files:
27 32
28 unzip32.exe 33 unzip32.exe (if you don't already have a LFN-capable unzipper)
29 beta/v2/djdev204.zip 34 beta/v2/djdev204.zip
30 v2gnu/bnu219b.zip 35 v2gnu/bnu219b.zip
31 v2gnu/gcc432b.zip 36 v2gnu/gcc444b.zip
32 v2gnu/mak3791b.zip 37 v2gnu/mak3791b.zip
33 v2gnu/sed415b.zip 38 v2misc/csdpmi7b.zip
34 v2misc/csdpmi5b.zip
35 39
36 If newer versions are available, probably you should try them first. 40 If newer versions are available, probably you should try them first.
37 Note that djdev203.zip is too old to build XZ Utils; you need at 41 Note that djdev203.zip is too old to build XZ Utils; you need at
38 least djdev204.zip. Also note that you want csdpmi5b.zip even if you 42 least djdev204.zip. Also note that you want csdpmi7b.zip even if you
39 run under Windows or DOSEMU, because the XZ Utils Makefile will embed 43 run under Windows or DOSEMU, because the XZ Utils Makefile will embed
40 cwsdstub.exe to the resulting binaries. 44 cwsdstub.exe to the resulting binaries.
41 45
42 See the instructions in readme.1st found from djdev204.zip. Here's 46 See the instructions in readme.1st found from djdev204.zip. Here's
43 a short summary, but you should still read readme.1st. 47 a short summary, but you should still read readme.1st.
44 48
45 C:\> mkdir DJGPP 49 C:\> mkdir DJGPP
46 C:\> cd DJGPP 50 C:\> cd DJGPP
47 C:\DJGPP> c:\download\unzip32 c:\download\djdev204.zip 51 C:\DJGPP> c:\download\unzip32 c:\download\djdev204.zip
48 C:\DJGPP> c:\download\unzip32 c:\download\bnu219b.zip 52 C:\DJGPP> c:\download\unzip32 c:\download\bnu219b.zip
49 C:\DJGPP> c:\download\unzip32 c:\download\gcc432b.zip 53 C:\DJGPP> c:\download\unzip32 c:\download\gcc444b.zip
50 C:\DJGPP> c:\download\unzip32 c:\download\mak3791b.zip 54 C:\DJGPP> c:\download\unzip32 c:\download\mak3791b.zip
51 C:\DJGPP> c:\download\unzip32 c:\download\sed415b.zip 55 C:\DJGPP> c:\download\unzip32 c:\download\csdpmi7b.zip
52 C:\DJGPP> c:\download\unzip32 c:\download\csdpmi5b.zip
53 56
54 C:\DJGPP> set PATH=C:\DJGPP\BIN;%PATH% 57 C:\DJGPP> set PATH=C:\DJGPP\BIN;%PATH%
55 C:\DJGPP> set DJGPP=C:\DJGPP\DJGPP.ENV 58 C:\DJGPP> set DJGPP=C:\DJGPP\DJGPP.ENV
56 59
57 You may want to add the last two lines into AUTOEXEC.BAT or have, 60 You may want to add the last two lines into AUTOEXEC.BAT or have,
58 for example, DJGPP.BAT which you can run before using DJGPP. 61 for example, DJGPP.BAT which you can run before using DJGPP.
59 62
60 Make sure you use completely upper case path in the DJGPP environment 63 Make sure you use completely upper case path in the DJGPP environment
61 variable. This is not required by DJGPP, but the XZ Utils Makefile is 64 variable. This is not required by DJGPP, but the XZ Utils Makefile is
62 a bit stupid and expects that everything in DJGPP environment variable 65 a bit stupid and expects that everything in DJGPP environment variable
63 is uppercase. 66 is uppercase.
64 67
65 68
66 Building 69 Building
67 70
68 Just run "make" in this directory (the directory containing this 71 You need to have an environment that supports long filenames (LFN).
69 README). You should get liblzma.a, xz.exe, xzdec.exe, and
70 lzmadec.exe. Of these, probably xz.exe is the only interesting one.
71
72 Note: You need to have an environment that supports long filenames.
73 Once you have built XZ Utils, the resulting binaries can be run 72 Once you have built XZ Utils, the resulting binaries can be run
74 without long filename support. 73 without long filename support.
75 74
76 75 Run "make" in this directory (the directory containing this README).
77 Additional Make Flags and Targets 76 You should get xz.exe (and a bunch of temporary files). Other tools
78 77 are not built. Having e.g. xzdec.exe doesn't save much space compared
79 You may want to try some additional optimizations, which may or 78 to xz.exe, because the DJGPP runtime makes the .exe quite big anyway.
80 may not make the code faster (and may or may not hit possible
81 compiler bugs more easily):
82
83 make CFLAGS="-O3 -fomit-frame-pointer -funroll-loops"
84
85 If you want to enable assertions (the assert() macro), use DEBUG=1.
86 You may want to disable optimizations too if you plan to actually
87 debug the code. Never use DEBUG=1 for production builds!
88
89 make DEBUG=1 CFLAGS="-g -O0"
90 79
91 80
92 Bugs 81 Bugs
93 82
94 "make clean" may remove src/xz/hardware.c when it tries to remove 83 xz doesn't necessarily work in Dosbox. It should work in DOSEMU.
95 src/xz/hardware-fixed.c. This is probably a bug somewhere in the
96 DOS environment I use. Maybe it tries truncated 8.3 name first and
97 since that gives a name of an existing file, it doesn't look for
98 long filename.
99 84
100 "xz -fc /dev/tty" hangs at least in DOSEMU and cannot be interrupted 85 Pressing Ctrl-c or Ctrl-Break won't remove the incomplete target file
101 by pressing C-c. Maybe xz should never accept non-regular files on 86 when running under Windows XP Command Prompt (something goes wrong
102 DOS even when --force is used. 87 with SIGINT handling). It works correctly under Windows 95/98/98SE/ME.
103 88
104 Using different memory usage limit for encoding and decoding doesn't
105 make sense under pure DOS. Maybe it is still OK when running under
106 Windows.
107
108 The progress indicator of "xz -v" doesn't get updated when running
109 under Dosbox, but it works in DOSEMU. I currently (2009-02-13) don't
110 know if it works in other environments.
111
112 Report bugs to <lasse.collin@tukaani.org> (in English or Finnish).
113
OLDNEW
« no previous file with comments | « dos/Makefile ('k') | dos/config.h » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698