annotate msdos/INSTALL @ 105409:5ae3de1af3a6

* cedet/semantic.el (semantic-mode): Use js-mode-hook for Javascript hook.
author Chong Yidong <cyd@stupidchicken.com>
date Sat, 03 Oct 2009 20:30:43 +0000
parents 2d3b4a4eb35a
children 1d1d5d9bd884
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,
100956
dc97fcf1ed7e Add 2009 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 100557
diff changeset
4 2005, 2006, 2007, 2008, 2009 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
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
8 all versions of MS-Windows from version 3.X on, including Windows XP
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
9 and Vista.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
10
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
11 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
12 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
13 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
14 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
15 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
16 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
17 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
18
99573
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
19 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
20 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
21 requires additional utilities: `find' (from Findutils), GNU `echo' and
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
22 `test' (from Sh-utils), `ls' and `chmod' (from Fileutils), `grep'
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
23 (from Grep), and a port of Bash. However, you should not normally
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
24 need to run lisp/Makefile, as all the Lisp files are distributed in
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
25 byte-compiled form as well. As for bootstrapping, you will only need
34fd2dee237b Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99473
diff changeset
26 that if you check-out development sources from the Emacs source
99581
c5c5f4559670 Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99573
diff changeset
27 repository. (Note: If you are checking out of CVS, use the -kb option
c5c5f4559670 Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99573
diff changeset
28 of the `checkout' and `update' commands, to preserve the original
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
29 Unix-style EOL format of the files. If some files are converted to
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
30 DOS EOL format by the default operation of CVS, the build might fail.)
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
31
99473
867b00482e8f Fix a typo.
Eli Zaretskii <eliz@gnu.org>
parents: 99469
diff changeset
32 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
33 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
34 need to make sure that long file names are handled consistently both
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
35 when you unpack the distribution and compile it. If you intend to
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
36 compile with DJGPP v2.0 or later, and long file names support is
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
37 enabled (LFN=y in the environment), you need to unpack Emacs
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
38 distribution in a way that doesn't truncate the original long
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
39 filenames to the DOS 8.3 namespace; the easiest way to do this is to
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
40 use djtar program which comes with DJGPP, since it will note the LFN
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
41 setting and behave accordingly. You can build Emacs with LFN=n, if
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
42 some of your tools don't support long file names: just ensure that LFN
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
43 is set to `n' during both unpacking and compiling.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
44
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
45 (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
46 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
47 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
48 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
49 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
50
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
51 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
52 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
53 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
54 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
55 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
56 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
57 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
58 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
59 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
60 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
61 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
62
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
63 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
64
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
65 djtar -x emacs.tgz
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
66
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
67 (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
68 your system.)
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
69
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
70 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
71 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
72
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
73 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
74 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
75 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
76 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
77 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
78 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
79
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
80 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
81 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
82 `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
83 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
84
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
85 djtar -x intlfonts.tgz
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
86
104061
2d3b4a4eb35a Mention probloems with long directory names under `nextstep'.
Eli Zaretskii <eliz@gnu.org>
parents: 102251
diff changeset
87 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
88 type these commands:
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
89
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
90 config msdos
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
91 make install
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
92
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
93 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
94 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
95 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
96 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
97 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
98 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
99 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
100 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
101 the DJGPP version number).
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
102
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
103 On Windows NT, Windows 2000/XP/Vista, running "config msdos" might
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
104 print an error message like "VDM has been already loaded". This is
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
105 because those systems have a program called `redir.exe' which is
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
106 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
107 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
108 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
109
100557
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
110 Windows Vista has several bugs in its DPMI server related to memory
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
111 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
112 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
113 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
114 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
115 "--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
116
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
117 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
118 make install
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
119
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
120 In addition, you'll need to install Service Pack 1 (SP1) or later to
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
121 Windows Vista and enlarge its DPMI memory limit by setting the value
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
122 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
123
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
124 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
125
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
126 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
127 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
128
102251
8b305485e988 Mention the MS-DOS section in etc/PROBLEMS.
Eli Zaretskii <eliz@gnu.org>
parents: 100956
diff changeset
129 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
130 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
131 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
132
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
133 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
134 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
135 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
136 command:
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 make bdf INSTALLDIR=..
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
139
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
140 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
141 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
142 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
143 default.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
144
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
145 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
146 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
147 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
148 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
149 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
150 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
151 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
152 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
153 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
154 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
155 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
156 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
157
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
158 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
159 ../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
160 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
161 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
162 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
163 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
164
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
165 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
166 multitasking do not work in the DJGPP port. Synchronous subprocesses
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
167 do work, so features such as compilation and grep run synchronously,
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
168 unlike opn other platforms.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
169
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
170 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
171 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
172 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
173 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
174 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
175
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 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
178
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
179 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
180 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
181 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
182 (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
183
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
184 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
185 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
186 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
187 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
188
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
189 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
190 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.