Doc fix for just-one-space change. Document it in NEWS.
[emacs.git] / msdos / mainmake.v2
blob8965f746a6d74a72a47146eca80d66c40ee84db1
1 # Top-level Makefile for Emacs under MS-DOS/DJGPP v2.0 or higher. -*-makefile-*-
3 # Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 #   2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
6 # This file is part of GNU Emacs.
8 # GNU Emacs is free software: you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation, either version 3 of the License, or
11 # (at your option) any later version.
13 # GNU Emacs is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 # GNU General Public License for more details.
18 # You should have received a copy of the GNU General Public License
19 # along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
21 # make all      to compile and build Emacs.
22 # make install  to install it (installs in-place, in `bin' subdir of top dir).
23 # make TAGS     to update tags tables.
25 # make clean  or  make mostlyclean
26 #      Delete all files from the current directory that are normally
27 #      created by building the program.  Don't delete the files that
28 #      record the configuration.  Also preserve files that could be made
29 #      by building, but normally aren't because the distribution comes
30 #      with them.
32 #      Delete `.dvi' files here if they are not part of the distribution.
34 # make distclean
35 #      Delete all files from the current directory that are created by
36 #      configuring or building the program.  If you have unpacked the
37 #      source and built the program without creating any other files,
38 #      `make distclean' should leave only the files that were in the
39 #      distribution.
41 # make maintainer-clean
42 #      Delete everything from the current directory that can be
43 #      reconstructed with this Makefile.  This typically includes
44 #      everything deleted by distclean, plus more: *.elc files,
45 #      C source files produced by Bison, tags tables, info files,
46 #      and so on.
48 # make extraclean
49 #      Still more severe - delete backup and autosave files, too.
51 # This gork is required for those who use a Unix-style shell, and
52 # have SHELL in the environment pointing to it.  Here we force
53 # Make to use COMMAND.COM instead.  This Makefile won't work otherwise.
54 # (The /xyzzy directory is used to minimize the chance that someone
55 # actually has such a directory with an incompatible command.com.  We
56 # used to have /dos there, but some Windows installations have an old
57 # version of DOS stashed in that directory, and command.com from there
58 # won't run on Windows, complaining about "Incorrect DOS version".
59 # Make will look up PATH for the shell executable, so the directory name
60 # is not important.)
61 SHELL=/xyzzy/command
62 MAKESHELL=/xyzzy/command
64 # Generate a full pathname of the top-level installation directory
65 top_srcdir := $(subst \,/,$(shell cd))
67 # Find out which version of Emacs this is.
68 version := ${shell sed -n -e '/^static const char emacs_version/s/^[^"]*\("[^"]*"\).*/\1/p' src/emacs.c}
70 # Q: Do we need to bootstrap?
71 # A: Only if we find admin/admin.el, i.e. we are building out of 
72 #    a VCS-checkout (not a release) and src/b-emacs.exe does not exist.
73 #    This avoids building a bootstrap-emacs and recompiling Lisp files
74 #    when building a pretest/release tarball.
75 boot :=
76 ifneq ($(wildcard admin/admin.el),)
77 ifeq ($(wildcard src/b-emacs.exe),)
78 boot := b-emacs.exe
79 endif
80 endif
82 # Subdirectories to run Make.  `lisp' is not included because the
83 # compiled lisp files are part of the distribution.  (If we are
84 # bootstrapping, the src target will run Make in `lisp' as well.)
85 # leim is not included because it is part of the src target.
86 all:    lib-src src emacs misc lispref lispintro
88 lib-src: FRC
89         cd lib-src
90         $(MAKE) top_srcdir=${top_srcdir} version=${version}
91         cd ..
93 # Pass to src/Makefile.in an additional BOOTSTRAPEMACS variable which
94 # is either set to b-emacs.exe (in case bootstrap-emacs has not been
95 # constructed yet) or the empty string (otherwise).
96 # src/Makefile.in uses it to implement conditional dependencies, so that
97 # files that need bootstrap-emacs to be built do not additionally need
98 # to be kept fresher than b-emacs.exe.  Otherwise changing a single
99 # file src/foo.c forces dumping a new bootstrap-emacs, then re-byte-compiling
100 # all preloaded elisp files, and only then dump the actual src/emacs, which
101 # is not wrong, but is overkill in 99.99% of the cases.
102 src: FRC
103         cd src
104         $(MAKE) top_srcdir=${top_srcdir} BOOTSTRAPEMACS="${boot}"
105         djecho -s '/-geometry/s,^.*,set environment HOME $(top_srcdir),' \
106                   '/environment *TERM/s/^.*/set environment TERM internal/' \
107                >gdb.sed
108         sed -f gdb.sed _gdbinit >gdb.tmp
109         djecho -a gdb.tmp -s 'set environment USER root' \
110                              'set environment NAME root' \
111                              'set environment USERNAME root' \
112                              'set environment EMACSPATH $(top_srcdir)/bin' \
113                              'set environment SHELL $(subst \,/,$(COMSPEC))' \
114                              'set environment PATH $(subst \,/,$(PATH))'
115         update gdb.tmp gdb.ini
116         rm -f gdb.tmp gdb.sed
117         cd ..
118         if exist src\bootlisp redir $(MAKE) -C lisp top_srcdir=${top_srcdir}
119         rm -f src/bootlisp
120         if exist leim\Makefile redir $(MAKE) -C leim top_srcdir=${top_srcdir}
122 info: emacs misc lispref lispintro
124 emacs misc lispref lispintro:   FRC
125         cd doc/$@
126         $(MAKE) top_srcdir=${top_srcdir} info
127         cd ../..
129 install: all
130         if not exist bin\nul md bin
131         cd lib-src
132         command.com /c >/dev/null for %p in (hexl etags ctags ebrowse) do\
133            if exist %p.exe mv -f %p.exe ../bin
134         if exist fns.el update fns.el ../bin/fns.el
135         cd ..
136         cd src
137         mv -f emacs.exe ../bin/
138         cd ..
139         djecho -s "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)" \
140                   "    (normal-top-level-add-subdirs-to-load-path))" \
141             > ./subdirs.el
142         if not exist .\site-lisp\subdirs.el \
143            update ./subdirs.el ./site-lisp/subdirs.el
144         rm -f ./subdirs.el
146 FRC:
148 # We cannot use [a-zA-Z]* like the mainline distribution does, because
149 # that causes all file names to be returned in upper-case on DOS...
150 # Must use `find' to filter out loaddefs files; ignore errors if `find'
151 # is not available or is an MS `find'.
152 # The "cd $(CURDIR)" gork is for when `find' fails and leaves us inside
153 # `lisp' or one of its subdirectories.
154 TAGS tags:      lib-src FRC
155         cd lib-src
156         if exist etags.exe mv -f etags.exe ../bin
157         cd ..
158         - find $(CURDIR)/lisp -iname "*.el" -a -! -( -iname "*loaddefs.el" -o -iname "ldefs-boot.el" -) | ./bin/etags -o lisp/TAGS -
159         cd $(CURDIR)
160         cd src
161         ../bin/etags --include=../lisp/TAGS \
162          --regex='/[    ]*DEFVAR_[A-Z_  (]+"\([^"]+\)"/' \
163          $(CURDIR)/src/*.c $(CURDIR)/src/*.h \
164          $(CURDIR)/src/s/msdos.h $(CURDIR)/src/m/intel386.h
165         cd ..
166         ./bin/etags --include=src/TAGS
168 check:
169         @echo "We don't have any tests for GNU Emacs yet."
171 clean mostlyclean:
172         cd lib-src
173         $(MAKE) $(MFLAGS) $@
174         cd ..
175         cd src
176         $(MAKE) $(MFLAGS) $@
177         cd ..
178         cd doc
179         cd emacs
180         -$(MAKE) $(MFLAGS) $@
181         cd ..
182         cd misc
183         -$(MAKE) $(MFLAGS) $@
184         cd ..
185         cd lispref
186         -$(MAKE) $(MFLAGS) $@
187         cd ..
188         cd lispintro
189         -$(MAKE) $(MFLAGS) $@
190         cd ..
191         cd ..
192         cd leim
193         if exist Makefile redir $(MAKE) $(MFLAGS) $@
194         cd ..
196 top_distclean=rm -f Makefile */Makefile src/_gdbinit
198 distclean maintainer-clean: FRC
199         cd src
200         $(MAKE) $(MFLAGS) $@
201         if exist bootlisp rm -f bootlisp
202         cd ..
203         cd lib-src
204         $(MAKE) $(MFLAGS) $@
205         cd ..
206         cd doc
207         cd emacs
208         -$(MAKE) $(MFLAGS) $@
209         cd ..
210         cd misc
211         -$(MAKE) $(MFLAGS) $@
212         cd ..
213         cd lispref
214         -$(MAKE) $(MFLAGS) $@
215         cd ..
216         cd lispintro
217         -$(MAKE) $(MFLAGS) $@
218         cd ..
219         cd ..
220         cd leim
221         if exist Makefile redir $(MAKE) $(MFLAGS) $@
222         cd ..
223         cd lisp
224         $(MAKE) $(MFLAGS) $@
225         cd ..
226         ${top_distclean}
228 extraclean:
229         cd src
230         $(MAKE) $(MFLAGS) $@
231         cd ..
232         cd lib-src
233         $(MAKE) $(MFLAGS) $@
234         cd ..
235         cd doc
236         cd emacs
237         -$(MAKE) $(MFLAGS) $@
238         cd ..
239         cd misc
240         -$(MAKE) $(MFLAGS) $@
241         cd ..
242         cd lispref
243         -$(MAKE) $(MFLAGS) $@
244         cd ..
245         cd lispintro
246         -$(MAKE) $(MFLAGS) $@
247         cd ..
248         cd ..
249         cd leim
250         if exist Makefile redir $(MAKE) $(MFLAGS) $@
251         cd ..
252         cd lisp
253         $(MAKE) $(MFLAGS) $@
254         cd ..
255         ${top_distclean}
256         -rm -f *~ #*
258 .PHONY: bootstrap
260 bootstrap-clean: FRC
261         cd src
262         $(MAKE) $(MFLAGS) $@
263         cd ..
264         cd lib-src
265         $(MAKE) $(MFLAGS) maintainer-clean
266         cd ..
267         cd doc
268         cd emacs
269         -$(MAKE) $(MFLAGS) maintainer-clean
270         cd ../misc
271         -$(MAKE) $(MFLAGS) maintainer-clean
272         cd ../lispref
273         -$(MAKE) $(MFLAGS) maintainer-clean
274         cd ../lispintro
275         -$(MAKE) $(MFLAGS) maintainer-clean
276         cd ..
277         cd ..
278         cd leim
279         $(MAKE) $(MFLAGS) maintainer-clean
280         cd ..
281         cd lisp
282         $(MAKE) $(MFLAGS) bootstrap-clean
283         cd ..
284         ${top_bootclean}
286 bootstrap: bootstrap-clean FRC
287         command.com /e:2048 /c config msdos
288         $(MAKE) $(MFLAGS) info all