Merge from origin/emacs-24
[emacs.git] / admin / nt / README-UNDUMP.W32
blob2859140ce425e02d8b8036b72dc0bd2817554b07
1 Copyright (C) 2001-2014 Free Software Foundation, Inc.
2 See the end of the file for license conditions.
4                            Emacs for Windows
6 This README file describes how to dump a bare precompiled version of
7 GNU Emacs for Windows.  This barebin distribution supplements the
8 standard distribution of Emacs, which you can download from:
10         ftp://ftp.gnu.org/gnu/emacs/
12 If you do not have the "bin" or "src" distribution, then you will need
13 to download one of those before you can use this barebin version.
15 An additional feature of the barebin version that is not present in
16 the bin distribution is that it contains an undumped binary of Emacs
17 (temacs.exe).  This can be used to dump Emacs yourself.  Note that you
18 should only need to dump Emacs yourself if you want to dump Emacs with
19 more elisp files than are included normally, or to rebuild Emacs after
20 patching one of the elisp files that is preloaded.
22 The dumping process consists of running a bare Emacs, loading up a
23 number of general elisp files, and then creating a new Emacs executable
24 preinitialized and ready to run.  In the precompiled distributions,
25 Emacs has already been dumped with the standard configuration.
27 To dump Emacs, unpack this distribution into the directory created by
28 unpacking the corresponding standard src or bin distribution.  To
29 verify that you unpacked in the proper place, check to make sure that
30 you now have a temacs.exe file in the bin directory.
32 Once you have unpacked this distribution, cd into the bin directory and
33 run dump.bat.  This will produce a new bin\emacs.exe executable for you
34 to use (the original one is renamed to emacs.exe.orig; this is not
35 overwritten if you run dump more than once).
37 For more information about running Emacs, read the README.W32 file
38 that came with this distribution.  If you need help using Emacs on
39 Windows, including problems with dumping, send email to
40 <help-emacs-windows@gnu.org>.
42 Enjoy!
45 This file is part of GNU Emacs.
47 GNU Emacs is free software: you can redistribute it and/or modify
48 it under the terms of the GNU General Public License as published by
49 the Free Software Foundation, either version 3 of the License, or
50 (at your option) any later version.
52 GNU Emacs is distributed in the hope that it will be useful,
53 but WITHOUT ANY WARRANTY; without even the implied warranty of
54 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
55 GNU General Public License for more details.
57 You should have received a copy of the GNU General Public License
58 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.