annotate msdos/INSTALL @ 101343:73eab117e42c

* files.texi (Format Conversion Piecemeal): Clarify behavior of write-region-annotate-functions. Document write-region-post-annotation-function.
author Chong Yidong <cyd@stupidchicken.com>
date Thu, 22 Jan 2009 04:53:32 +0000
parents dc97fcf1ed7e
children 8b305485e988
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
c5c5f4559670 Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99573
diff changeset
29 Unix-style EOL format of the files. If some Lisp files are converted
c5c5f4559670 Update the list of utilities needed by lisp/Makefile and for bootstrapping.
Eli Zaretskii <eliz@gnu.org>
parents: 99573
diff changeset
30 to DOS format, 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
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
49 into problems during the build process.)
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
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
70 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
71 distribution. For this, create a directory called `fonts' under the
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
72 Emacs top-level directory (usually called `emacs-XX.YY') created by
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
73 unpacking emacs.tgz, chdir into the directory emacs-XX.YY/fonts, and
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
74 type this:
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
75
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
76 djtar -x intlfonts.tgz
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
77
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
78 When unpacking Emacs is done, a directory called `emacs-XX.YY' will be
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
79 created, where XX.YY is the Emacs version. To build and install
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
80 Emacs, chdir to that directory and type these commands:
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
81
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
82 config msdos
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
83 make install
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 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
86 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
87 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
88 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
89 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
90 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
91 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
92 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
93 the DJGPP version number).
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
94
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
95 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
96 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
97 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
98 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
99 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
100 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
101
100557
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
102 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
103 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
104 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
105 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
106 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
107 "--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
108
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
109 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
110 make install
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
111
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
112 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
113 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
114 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
115
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
116 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
117
9b0264b3b021 Document the problems on Windows Vista and the --with-system-malloc option
Eli Zaretskii <eliz@gnu.org>
parents: 99581
diff changeset
118 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
119 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
120
99469
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
121 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
122 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
123 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
124 command:
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
125
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
126 make bdf INSTALLDIR=..
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
127
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
128 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
129 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
130 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
131 default.
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
132
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
133 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
134 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
135 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
136 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
137 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
138 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
139 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
140 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
141 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
142 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
143 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
144 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
145
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
146 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
147 ../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
148 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
149 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
150 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
151 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
152
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
153 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
154 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
155 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
156 unlike opn other platforms.
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 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
159 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
160 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
161 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
162 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
163
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 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
166
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
167 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
168 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
169 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
170 (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
171
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
172 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
173 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
174 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
175 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
176
d8a8e3b68421 New file, with build instructions moved from the top-level INSTALL.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
177 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
178 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.