annotate msdos/INSTALL @ 109275:a85c2c80290c

Clarify command loop's role in undo boundary (Bug#2433). * text.texi (Undo): Clarify command loop behavior (Bug#2433). * commands.texi (Command Overview): Mention undo-boundary call.
author Chong Yidong <cyd@stupidchicken.com>
date Thu, 24 Jun 2010 15:05:47 -0400
parents 8b83e8b68526
children 376148b31b5e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
1 GNU Emacs Installation Guide for the DJGPP (a.k.a. MS-DOS) port
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
2
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
3 Copyright (C) 1992, 1994, 1996, 1997, 2000, 2001, 2002, 2003, 2004,
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 104061
diff changeset
4 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
5 See the end of the file for license conditions.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
6
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
7 The DJGPP port of GNU Emacs builds and runs on plain DOS and also on
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
8 all versions of MS-Windows from version 3.X on, including Windows XP,
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
9 Vista, and Windows 7 (however, see below for issues with Windows Vista
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
10 and 7).
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
11
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
12 To build and install the DJGPP port, you need to have the DJGPP ports
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
13 of GCC (the GNU C compiler), GNU Make, rm, mv, and sed. See the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
14 remarks in CONFIG.BAT for more information about locations and
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
15 versions. The Emacs FAQ (see info/efaq) includes pointers to Internet
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
16 sites where you can find the necessary utilities; search for "MS-DOS".
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
17 The configuration step (see below) will test for these utilities and
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
18 will refuse to continue if any of them isn't found.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
19
99573
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
20 Bootstrapping Emacs or recompiling Lisp files in the `lisp'
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
21 subdirectory using the various targets in the lisp/Makefile file
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
22 requires additional utilities: `find' (from Findutils), GNU `echo' and
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
23 `test' (from Sh-utils or Coreutils), `ls' and `chmod' (from Fileutils
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
24 or Coreutils), `grep' (from Grep), and a port of Bash. However, you
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
25 should not normally need to run lisp/Makefile, as all the Lisp files
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
26 are distributed in byte-compiled form as well. As for bootstrapping
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
27 itself, you will only need that if you check-out development sources
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
28 from the Emacs source repository.
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
29
99473
867b00482e8f Fix a typo.
Eli Zaretskii <eliz@gnu.org>
parents: 99469
diff changeset
30 If you are building the DJGPP version of Emacs on a DOS-like system
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
31 which supports long file names (e.g. Windows 9X or Windows XP), you
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
32 need to make sure that long file names are handled consistently both
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
33 when you unpack the distribution and compile it. With DJGPP v2.0 or
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
34 later, long file names support is by default, so you need to unpack
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
35 Emacs distribution in a way that doesn't truncate the original long
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
36 filenames to the DOS 8.3 namespace; the easiest way to do this is to
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
37 use djtar program which comes with DJGPP, since it will behave
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
38 consistently with the rest of DJGPP tools. Alternatively, you can
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
39 build Emacs with LFN=n, if some of your tools don't support long file
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
40 names: just ensure that LFN is set to `n' during both unpacking and
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
41 compiling.
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
42
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
43 (By the time you read this, you have already unpacked the Emacs
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
44 distribution, but if the explanations above imply that you should have
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
45 done it differently, it's safer to delete the directory tree created
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
46 by the unpacking program and unpack Emacs again, than to risk running
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
47 into strange problems during the build process.)
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
48
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
49 It is important to understand that the runtime support of long file
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
50 names by the Emacs binary is NOT affected by the LFN setting during
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
51 compilation; Emacs compiled with DJGPP v2.0 or later will always
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
52 support long file names on Windows no matter what was the setting
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
53 of LFN at compile time. However, if you compiled with LFN disabled
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
54 and want to enable LFN support after Emacs was already built, you need
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
55 to make sure that the support files in the lisp, etc and info
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
56 directories are called by their original long names as found in the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
57 distribution. You can do this either by renaming the files manually,
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
58 or by extracting them from the original distribution archive with
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
59 djtar after you set LFN=y in the environment.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
60
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
61 To unpack Emacs with djtar, type this command:
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
62
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
63 djtar -x emacs.tgz
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
64
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
65 (This assumes that the Emacs distribution is called `emacs.tgz' on
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
66 your system.)
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
67
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
68 When unpacking Emacs is done, a directory called `emacs-XX.YY' will be
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
69 created, where XX.YY is the Emacs version.
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
70
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
71 On plain DOS, unpacking can complain about several directories and
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
72 files in the `nextstep' subdirectory of the `emacs-XX.YY' top-level
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
73 directory. This is because the names of these files overflow the
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
74 67-character limit on the file-name length imposed by DOS filesystems.
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
75 When prompted by `djtar' for a different name for these files, just
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
76 press [Enter] to skip them: they are not needed for the DJGPP build.
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
77
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
78 If you want to print international characters, install the intlfonts
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
79 distribution. For this, create a directory called `fonts' under the
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
80 `emacs-XX.YY' top-level directory created by unpacking emacs.tgz,
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
81 chdir into the directory `emacs-XX.YY/fonts', and type this:
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
82
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
83 djtar -x intlfonts.tgz
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
84
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
85 To build and install Emacs, chdir to the `emacs-XX.YY' directory and
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
86 type these commands:
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
87
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
88 config msdos
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
89 make install
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
90
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
91 Running "config msdos" checks for several programs that are required
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
92 to configure and build Emacs; if one of those programs is not found,
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
93 CONFIG.BAT stops and prints an error message. If you have DJGPP
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
94 version 2.0 or 2.01, it will complain about a program called
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
95 DJECHO.EXE. These old versions of DJGPP shipped that program under
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
96 the name ECHO.EXE, so you can simply copy ECHO.EXE to DJECHO.EXE and
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
97 rerun CONFIG.BAT. If you have neither ECHO.EXE nor DJECHO.EXE, you
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
98 should be able to find them in your djdevNNN.zip archive (where NNN is
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
99 the DJGPP version number).
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
100
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
101 On Windows NT and Windows 2000/XP/Vista/7, running "config msdos"
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
102 might print an error message like "VDM has been already loaded". This
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
103 is because those systems have a program called `redir.exe' which is
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
104 incompatible with a program by the same name supplied with DJGPP,
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
105 which is used by config.bat. To resolve this, move the DJGPP's `bin'
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
106 subdirectory to the front of your PATH environment variable.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
107
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
108 Windows Vista/7 has several bugs in its DPMI server related to memory
100557
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
109 allocation: it fails DPMI resize memory block function, and it
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
110 arbitrarily limits the default amount of DPMI memory to 32MB. To work
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
111 around these bugs, first configure Emacs to use the `malloc' function
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
112 from the DJGPP library. To this end, run CONFIG.BAT with the
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
113 "--with-system-malloc" option:
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
114
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
115 config --with-system-malloc msdos
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
116 make install
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
117
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
118 In addition, for Windows Vista you'll need to install Service Pack 1
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
119 (SP1) or later and enlarge its DPMI memory limit by setting the value
100557
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
120 of this Registry key:
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
121
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
122 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Wow\DpmiLimit
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
123
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
124 Create this key if it does not exist. The value is a DWORD; setting
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
125 it to 536870912 should let Emacs use up to 512MB of memory.
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
126
102251
8b305485e988 Mention the MS-DOS section in etc/PROBLEMS.
Eli Zaretskii <eliz@gnu.org>
parents: 100956
diff changeset
127 If you have other problems, either building Emacs or running the
8b305485e988 Mention the MS-DOS section in etc/PROBLEMS.
Eli Zaretskii <eliz@gnu.org>
parents: 100956
diff changeset
128 produced binary, look in the file etc/PROBLEMS for some known problems
8b305485e988 Mention the MS-DOS section in etc/PROBLEMS.
Eli Zaretskii <eliz@gnu.org>
parents: 100956
diff changeset
129 related to the DJGPP port (search for "MS-DOS").
8b305485e988 Mention the MS-DOS section in etc/PROBLEMS.
Eli Zaretskii <eliz@gnu.org>
parents: 100956
diff changeset
130
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
131 To install the international fonts, chdir to the intlfonts-X.Y
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
132 directory created when you unpacked the intlfonts distribution (X.Y is
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
133 the version number of the fonts' distribution), and type the following
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
134 command:
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
135
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
136 make bdf INSTALLDIR=..
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
137
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
138 After Make finishes, you may remove the directory intlfonts-X.Y; the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
139 fonts are installed into the fonts/bdf subdirectory of the top-level
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
140 Emacs directory, and that is where Emacs will look for them by
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
141 default.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
142
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
143 Building Emacs creates executable files in the src and lib-src
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
144 directories. Installing the DJGPP port of Emacs moves these
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
145 executables to a sibling directory called bin. For example, if you
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
146 build in directory C:/emacs, installing moves the executables from
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
147 C:/emacs/src and C:/emacs/lib-src to the directory C:/emacs/bin, so
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
148 you can then delete the subdirectories C:/emacs/src and
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
149 C:/emacs/lib-src if you wish. The only subdirectories you need to
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
150 keep are bin, lisp, etc and info. (If you installed intlfonts, keep
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
151 the fonts directory and all its subdirectories as well.) The bin
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
152 subdirectory should be added to your PATH. The msdos subdirectory
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
153 includes a PIF and an icon file for Emacs which you might find useful
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
154 if you run Emacs under MS Windows.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
155
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
156 Emacs on MSDOS finds the lisp, etc and info directories by looking in
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
157 ../lisp, ../etc and ../info, starting from the directory where the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
158 Emacs executable was run from. You can override this by setting the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
159 environment variables EMACSDATA (for the location of `etc' directory),
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
160 EMACSLOADPATH (for the location of `lisp' directory) and INFOPATH (for
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
161 the location of the `info' directory).
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
162
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
163 Emacs features which require asynchronous subprocesses that depend on
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
164 multitasking do not work in the DJGPP port. Synchronous subprocesses
107197
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
165 do work, so features such as compilation, grep, and Ispell run
8b83e8b68526 INSTALL: Remove a CVS-specific note. Update for latest versions of Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 106815
diff changeset
166 synchronously, unlike on other platforms.
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
167
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
168 Version 2.0 of djgpp has two bugs that affect Emacs. We've included
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
169 corrected versions of two files from djgpp in the msdos subdirectory:
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
170 is_exec.c and sigaction.c. To work around the bugs, compile these
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
171 files and link them into temacs. Djgpp versions 2.01 and later have
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
172 these bugs fixed, so upgrade if you can before building Emacs.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
173
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
174
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
175 This file is part of GNU Emacs.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
176
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
177 GNU Emacs is free software: you can redistribute it and/or modify
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
178 it under the terms of the GNU General Public License as published by
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
179 the Free Software Foundation, either version 3 of the License, or
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
180 (at your option) any later version.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
181
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
182 GNU Emacs is distributed in the hope that it will be useful,
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
183 but WITHOUT ANY WARRANTY; without even the implied warranty of
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
184 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
185 GNU General Public License for more details.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
186
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
187 You should have received a copy of the GNU General Public License
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
188 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.