3 # Copyright (C) 2000-2016 Free Software Foundation, Inc.
5 # This file is part of GNU Emacs.
7 # GNU Emacs is free software: you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation, either version 3 of the License, or
10 # (at your option) any later version.
12 # GNU Emacs is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
23 top_srcdir
= @top_srcdir@
28 # Empty for all systems except MinGW, where xargs needs an explicit
30 XARGS_LIMIT
= @XARGS_LIMIT@
33 AM_DEFAULT_VERBOSITY
= @AM_DEFAULT_VERBOSITY@
35 AM_V_ELC
= $(am__v_ELC_@AM_V@
)
36 am__v_ELC_
= $(am__v_ELC_@AM_DEFAULT_V@
)
37 am__v_ELC_0
= @echo
" ELC " $@
;
40 AM_V_GEN
= $(am__v_GEN_@AM_V@
)
41 am__v_GEN_
= $(am__v_GEN_@AM_DEFAULT_V@
)
42 am__v_GEN_0
= @echo
" GEN " $@
;
45 AM_V_at
= $(am__v_at_@AM_V@
)
46 am__v_at_
= $(am__v_at_@AM_DEFAULT_V@
)
50 # You can specify a different executable on the make command line,
51 # e.g. "make EMACS=../src/emacs ...".
53 # We never change directory before running Emacs, so a relative file
54 # name is fine, and makes life easier. If we need to change
55 # directory, we can use emacs --chdir.
56 EMACS
= ..
/src
/emacs
${EXEEXT}
58 # Command line flags for Emacs.
60 EMACSOPT
= -batch
--no-site-file
--no-site-lisp
62 # Extra flags to pass to the byte compiler
63 BYTE_COMPILE_EXTRA_FLAGS
=
64 # For example to not display the undefined function warnings you can use this:
65 # BYTE_COMPILE_EXTRA_FLAGS = --eval '(setq byte-compile-warnings (quote (not unresolved)))'
66 # The example above is just for developers, it should not be used by default.
68 # Automatically generated autoload files, apart from lisp/loaddefs.el.
69 # Note this includes only those files that need special rules to
70 # build; ie it does not need to include things created via
71 # generated-autoload-file (eg calc/calc-loaddefs.el).
72 LOADDEFS
= $(lisp
)/calendar
/cal-loaddefs.el \
73 $(lisp
)/calendar
/diary-loaddefs.el \
74 $(lisp
)/calendar
/hol-loaddefs.el \
75 $(lisp
)/mh-e
/mh-loaddefs.el \
76 $(lisp
)/net
/tramp-loaddefs.el
78 # Elisp files auto-generated.
79 AUTOGENEL
= loaddefs.el \
84 emacs-lisp
/cl-loaddefs.el \
85 calc
/calc-loaddefs.el \
86 eshell
/esh-groups.el \
87 cedet
/semantic
/loaddefs.el \
88 cedet
/ede
/loaddefs.el \
89 cedet
/srecode
/loaddefs.el \
92 # Value of max-lisp-eval-depth when compiling initially.
93 # During bootstrapping the byte-compiler is run interpreted when compiling
94 # itself, and uses more stack than usual.
96 BIG_STACK_DEPTH
= 2200
97 BIG_STACK_OPTS
= --eval
"(setq max-lisp-eval-depth $(BIG_STACK_DEPTH))"
99 # Set load-prefer-newer for the benefit of the non-bootstrappers.
100 BYTE_COMPILE_FLAGS
= $(BIG_STACK_OPTS
) \
101 --eval
'(setq load-prefer-newer t)' $(BYTE_COMPILE_EXTRA_FLAGS
)
103 # Files to compile before others during a bootstrap. This is done to
104 # speed up the bootstrap process. They're ordered by size, so we use
105 # the slowest-compiler on the smallest file and move to larger files as the
106 # compiler gets faster. 'autoload.elc' comes last because it is not used by
107 # the compiler (so its compilation does not speed up subsequent compilations),
108 # it's only placed here so as to speed up generation of the loaddefs.el file.
111 $(lisp
)/emacs-lisp
/macroexp.elc \
112 $(lisp
)/emacs-lisp
/cconv.elc \
113 $(lisp
)/emacs-lisp
/byte-opt.elc \
114 $(lisp
)/emacs-lisp
/bytecomp.elc \
115 $(lisp
)/emacs-lisp
/autoload.elc
117 # Prevent any settings in the user environment causing problems.
118 unexport EMACSDATA EMACSDOC EMACSPATH
120 # The actual Emacs command run in the targets below.
121 # Prevent any setting of EMACSLOADPATH in user environment causing problems.
122 emacs
= EMACSLOADPATH
= '$(EMACS)' $(EMACSOPT
)
124 ## Subdirectories, relative to builddir.
125 SUBDIRS
= $(sort $(shell find
${srcdir} -type d
-print))
126 ## Subdirectories, relative to srcdir.
127 SUBDIRS_REL
= $(patsubst ${srcdir}%,.
%,${SUBDIRS})
128 ## All subdirectories except 'obsolete' and 'term'.
129 SUBDIRS_ALMOST
= $(filter-out ${srcdir}/obsolete
${srcdir}/term
,${SUBDIRS})
130 ## All subdirectories except 'obsolete', 'term', and 'leim' (and subdirs).
131 ## We don't want the leim files listed as packages, especially
132 ## since many share basenames with files in language/.
133 SUBDIRS_FINDER
= $(filter-out ${srcdir}/leim
%,${SUBDIRS_ALMOST})
134 ## All subdirectories in which we might want to create subdirs.el.
135 SUBDIRS_SUBDIRS
= $(filter-out ${srcdir}/cedet
% ${srcdir}/leim
%,${SUBDIRS})
137 # cus-load and finder-inf are not explicitly requested by anything, so
138 # we add them here to make sure they get built.
139 all: compile-main
$(lisp
)/cus-load.el
$(lisp
)/finder-inf.el
142 .PHONY
: all custom-deps finder-data autoloads update-subdirs
$(PHONY_EXTRAS
)
144 # custom-deps and finder-data both used to scan _all_ the *.el files.
145 # This could lead to problems in parallel builds if automatically
146 # generated *.el files (eg loaddefs etc) were being changed at the same time.
147 # One solution was to add autoloads as a prerequisite:
148 # http://lists.gnu.org/archive/html/emacs-pretest-bug/2007-01/msg00469.html
149 # http://lists.gnu.org/archive/html/bug-gnu-emacs/2007-12/msg00171.html
150 # However, this meant that running these targets modified loaddefs.el,
151 # every time (due to time-stamping). Calling these rules from
152 # bootstrap-after would modify loaddefs after src/emacs, resulting
153 # in make install remaking src/emacs for no real reason:
154 # http://lists.gnu.org/archive/html/emacs-devel/2008-02/msg00311.html
155 # Nowadays these commands don't scan automatically generated files,
156 # since they will never contain any useful information
157 # (see finder-no-scan-regexp and custom-dependencies-no-scan-regexp).
159 $(AM_V_at
)$(MAKE
) PHONY_EXTRAS
=$(lisp
)/cus-load.el
$(lisp
)/cus-load.el
161 $(AM_V_GEN
)$(emacs
) -l cus-dep \
162 --eval
'(setq generated-custom-dependencies-file (unmsys--file-name "$(srcdir)/cus-load.el"))' \
163 -f custom-make-dependencies
${SUBDIRS_ALMOST}
166 $(AM_V_at
)$(MAKE
) PHONY_EXTRAS
=$(lisp
)/finder-inf.el \
167 $(lisp
)/finder-inf.el
168 $(lisp
)/finder-inf.el
:
169 $(AM_V_GEN
)$(emacs
) -l finder \
170 --eval
'(setq generated-finder-keywords-file (unmsys--file-name "$(srcdir)/finder-inf.el"))' \
171 -f finder-compile-keywords-make-dist
${SUBDIRS_FINDER}
173 # Use expand-file-name rather than $abs_scrdir so that Emacs does not
174 # get confused when it compares file-names for equality.
176 # Note that we set no-update-autoloads in _generated_ leim files.
177 # If you want to allow autoloads in such files, remove that,
178 # and make this depend on leim.
179 autoloads .PHONY
: $(lisp
)/loaddefs.el
180 $(lisp
)/loaddefs.el
: $(LOADDEFS
)
181 @echo Directories for loaddefs
: ${SUBDIRS_ALMOST}
182 $(AM_V_GEN
)$(emacs
) -l autoload \
183 --eval
'(setq autoload-ensure-writable t)' \
184 --eval
'(setq autoload-builtin-package-versions t)' \
185 --eval
'(setq generated-autoload-file (expand-file-name (unmsys--file-name "$@")))' \
186 -f batch-update-autoloads
${SUBDIRS_ALMOST}
188 # This is required by the bootstrap-emacs target in ../src/Makefile, so
189 # we know that if we have an emacs executable, we also have a subdirs.el.
191 $(AM_V_GEN
)$(MAKE
) update-subdirs
193 $(AM_V_at
)for file in
${SUBDIRS_SUBDIRS}; do \
194 $(srcdir)/..
/build-aux
/update-subdirs
$$file; \
197 .PHONY
: updates repo-update update-authors
199 # Some modes of make-dist use this.
200 updates
: update-subdirs autoloads finder-data custom-deps
202 # This is useful after updating from the repository; but it doesn't do
203 # anything that a plain "make" at top-level doesn't. The only
204 # difference between this and this directory's "all" rule is that this
205 # runs "autoloads" as well (because it uses "compile" rather than
206 # "compile-main"). In a bootstrap, $(lisp) in src/Makefile triggers
207 # this directory's autoloads rule.
208 repo-update
: compile finder-data custom-deps
210 # Update the AUTHORS file.
213 $(emacs
) -L
"$(top_srcdir)/admin" -l authors \
214 -f batch-update-authors
"$(top_srcdir)/etc/AUTHORS" "$(top_srcdir)"
217 ETAGS
= ..
/lib-src
/etags
219 lisptagsfiles1
= $(srcdir)/*.el
220 lisptagsfiles2
= $(srcdir)/*/*.el
221 lisptagsfiles3
= $(srcdir)/*/*/*.el
222 lisptagsfiles4
= $(srcdir)/*/*/*/*.el
224 ## The ls | sed | xargs is to stop the command line getting too long
225 ## on MS Windows, when the MSYS Bash passes it to a MinGW compiled
226 ## etags. It might be better to use find in a similar way to
227 ## compile-main. But maybe this is not even necessary any more now
228 ## that this uses relative filenames.
229 TAGS
: $(lisptagsfiles1
) $(lisptagsfiles2
) $(lisptagsfiles3
) $(lisptagsfiles4
)
232 ls
$(lisptagsfiles1
) $(lisptagsfiles2
) \
233 $(lisptagsfiles3
) $(lisptagsfiles4
) | \
234 sed
-e
'/loaddefs/d; /\/ldefs-boot/d; /esh-groups\.el/d' | \
235 xargs
$(XARGS_LIMIT
) "$(ETAGS)" -a
-o
$@
238 # The src/Makefile.in has its own set of dependencies and when they decide
239 # that one Lisp file needs to be re-compiled, we had better recompile it as
240 # well, otherwise every subsequent make will again call us, until we finally
241 # end up deciding that yes, the file deserves recompilation.
242 # One option is to try and reproduce exactly the same dependencies here as
243 # we have in src/Makefile.in, but it turns out to be painful
244 # (e.g. src/Makefile.in may have a dependency for ../lisp/foo.elc where we
245 # only know of $(lisp)/foo.elc). So instead we provide a direct way for
246 # src/Makefile.in to rebuild a particular Lisp file, no questions asked.
247 # Use byte-compile-refresh-preloaded to try and work around some of
248 # the most common problems of not bootstrapping from a clean state.
249 THEFILE
= no-such-file
252 $(AM_V_ELC
)$(emacs
) $(BYTE_COMPILE_FLAGS
) \
253 -l bytecomp
-f byte-compile-refresh-preloaded \
254 -f batch-byte-compile
$(THEFILE
)
256 # Files MUST be compiled one by one. If we compile several files in a
257 # row (i.e., in the same instance of Emacs) we can't make sure that
258 # the compilation environment is clean. We also set the load-path of
259 # the Emacs used for compilation to the current directory and its
260 # subdirectories, to make sure require's and load's in the files being
261 # compiled find the right files.
265 # An old-fashioned suffix rule, which, according to the GNU Make manual,
266 # cannot have prerequisites.
268 $(AM_V_ELC
)$(emacs
) $(BYTE_COMPILE_FLAGS
) -f batch-byte-compile
$<
270 .PHONY
: compile-first compile-main compile compile-always
272 compile-first
: $(COMPILE_FIRST
)
274 # In 'compile-main' we could directly do
275 # ... | xargs $(MAKE)
276 # and it works, but it generates a lot of messages like
277 # make[2]: gnus/gnus-mlspl.elc is up to date.
278 # so instead, we use "xargs echo" to split the list of file into manageable
279 # chunks and then use an intermediate 'compile-targets' target so the
280 # actual targets (the .elc files) are not mentioned as targets on the
284 .PHONY
: compile-targets
285 # TARGETS is set dynamically in the recursive call from 'compile-main'.
286 compile-targets
: $(TARGETS
)
288 # Compile all the Elisp files that need it. Beware: it approximates
289 # 'no-byte-compile', so watch out for false-positives!
290 compile-main
: leim semantic compile-clean
292 els
=`echo "${SUBDIRS_REL} " | sed -e 's|/\./|/|g' -e 's|/\. | |g' -e 's| |/*.el |g'`; \
293 for el in
$$els; do \
294 test -f
$$el || continue
; \
295 test ! -f
$${el}c
&& GREP_OPTIONS
= grep
'^;.*no-byte-compile: t' $$el > /dev
/null
&& continue
; \
297 done | xargs
$(XARGS_LIMIT
) echo
) | \
298 while read chunk
; do \
299 $(MAKE
) compile-targets TARGETS
="$$chunk"; \
302 .PHONY
: compile-clean
303 # Erase left-over .elc files that do not have a corresponding .el file.
306 elcs
=`echo "${SUBDIRS_REL} " | sed -e 's|/\./|/|g' -e 's|/\. | |g' -e 's| |/*.elc |g'`; \
307 for el in
`echo $$elcs | sed -e 's/\.elc/\.el/g'`; do \
308 if
test -f
"$$el" ||
test ! -f
"$${el}c"; then
:; else \
314 .PHONY
: leim semantic
316 $(MAKE
) -C ..
/leim
all EMACS
="$(EMACS)"
319 $(MAKE
) -C ..
/admin
/grammars
all EMACS
="$(EMACS:.%=../.%)"
321 # Compile all Lisp files, but don't recompile those that are up to
322 # date. Some .el files don't get compiled because they set the
323 # local variable no-byte-compile.
324 # Calling make recursively because suffix rule cannot have prerequisites.
325 compile
: $(LOADDEFS
) autoloads compile-first
328 # Compile all Lisp files. This is like 'compile' but compiles files
329 # unconditionally. Some files don't actually get compiled because they
330 # set the local variable no-byte-compile.
332 cd
$(lisp
) && rm -f
*.elc
*/*.elc
*/*/*.elc
*/*/*/*.elc
335 .PHONY
: backup-compiled-files compile-after-backup
337 # Backup compiled Lisp files in elc.tar.gz. If that file already
338 # exists, make a backup of it.
340 backup-compiled-files
:
341 -mv
$(lisp
)/elc.
tar.gz
$(lisp
)/elc.
tar.gz~
342 -tar czf
$(lisp
)/elc.
tar.gz
$(lisp
)/*.elc
$(lisp
)/*/*.elc
$(lisp
)/*/*/*.elc
$(lisp
)/*/*/*/*.elc
344 # Compile Lisp files, but save old compiled files first.
346 compile-after-backup
: backup-compiled-files compile-always
348 # This does the same job as the "compile" rule, but in a different way.
349 # Rather than spawning a separate Emacs instance to compile each file,
350 # it uses the same Emacs instance to compile everything.
351 # This is faster on a single core, since it avoids the overhead of
352 # starting Emacs many times (it was 33% faster on a test with a
353 # random 10% of the .el files needing recompilation).
354 # Unlike compile, this is not parallelizable; so if you have more than
355 # one core and use make -j#, compile will be (much) faster.
356 # This rule also produces less accurate compilation warnings.
357 # The environment of later files is affected by definitions in
358 # earlier ones, so it does not produce some warnings that it should.
359 # It can also produces spurious warnings about "invalid byte code" if
360 # files that use byte-compile-dynamic are updated.
361 # There is no reason to use this rule unless you only have a single
362 # core and CPU time is an issue.
363 .PHONY
: compile-one-process
364 compile-one-process
: $(LOADDEFS
) compile-first
365 $(emacs
) $(BYTE_COMPILE_FLAGS
) \
366 --eval
"(batch-byte-recompile-directory 0)" $(lisp
)
368 # Update MH-E internal autoloads. These are not to be confused with
369 # the autoloads for the MH-E entry points, which are already in loaddefs.el.
370 MH_E_DIR
= $(lisp
)/mh-e
371 MH_E_SRC
= $(sort $(wildcard ${MH_E_DIR}/mh
*.el
))
372 MH_E_SRC
:= $(filter-out ${MH_E_DIR}/mh-loaddefs.el
,${MH_E_SRC})
375 mh-autoloads
: $(MH_E_DIR
)/mh-loaddefs.el
376 $(MH_E_DIR
)/mh-loaddefs.el
: $(MH_E_SRC
)
377 $(AM_V_GEN
)$(emacs
) -l autoload \
378 --eval
"(setq generate-autoload-cookie \";;;###mh-autoload\")" \
379 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
380 -f batch-update-autoloads
$(MH_E_DIR
)
382 # Update TRAMP internal autoloads. Maybe we could move tramp*.el into
383 # an own subdirectory. OTOH, it does not hurt to keep them in
385 TRAMP_DIR
= $(lisp
)/net
386 TRAMP_SRC
= $(sort $(wildcard ${TRAMP_DIR}/tramp
*.el
))
387 TRAMP_SRC
:= $(filter-out ${TRAMP_DIR}/tramp-loaddefs.el
,${TRAMP_SRC})
389 $(TRAMP_DIR
)/tramp-loaddefs.el
: $(TRAMP_SRC
)
390 $(AM_V_GEN
)$(emacs
) -l autoload \
391 --eval
"(setq generate-autoload-cookie \";;;###tramp-autoload\")" \
392 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
393 -f batch-update-autoloads
$(TRAMP_DIR
)
395 CAL_DIR
= $(lisp
)/calendar
396 ## Those files that may contain internal calendar autoload cookies.
397 CAL_SRC
= $(addprefix ${CAL_DIR}/,diary-lib.el holidays.el lunar.el solar.el
)
398 CAL_SRC
:= $(sort ${CAL_SRC} $(wildcard ${CAL_DIR}/cal
*.el
))
399 CAL_SRC
:= $(filter-out ${CAL_DIR}/cal-loaddefs.el
,${CAL_SRC})
401 $(CAL_DIR
)/cal-loaddefs.el
: $(CAL_SRC
)
402 $(AM_V_GEN
)$(emacs
) -l autoload \
403 --eval
"(setq generate-autoload-cookie \";;;###cal-autoload\")" \
404 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
405 -f batch-update-autoloads
$(CAL_DIR
)
407 $(CAL_DIR
)/diary-loaddefs.el
: $(CAL_SRC
) $(CAL_DIR
)/cal-loaddefs.el
408 $(AM_V_GEN
)$(emacs
) -l autoload \
409 --eval
"(setq generate-autoload-cookie \";;;###diary-autoload\")" \
410 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
411 -f batch-update-autoloads
$(CAL_DIR
)
413 $(CAL_DIR
)/hol-loaddefs.el
: $(CAL_SRC
) $(CAL_DIR
)/diary-loaddefs.el
414 $(AM_V_GEN
)$(emacs
) -l autoload \
415 --eval
"(setq generate-autoload-cookie \";;;###holiday-autoload\")" \
416 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
417 -f batch-update-autoloads
$(CAL_DIR
)
419 .PHONY
: bootstrap-clean
distclean maintainer-clean
422 -cd
$(lisp
) && rm -f
*.elc
*/*.elc
*/*/*.elc
*/*/*/*.elc
$(AUTOGENEL
)
425 -rm -f .
/Makefile
$(lisp
)/loaddefs.el~
427 maintainer-clean
: distclean bootstrap-clean
430 .PHONY
: check-declare
433 $(emacs
) -l check-declare
--eval
'(check-declare-directory "$(lisp)")'
435 ## This finds a lot of duplicates between foo.el and obsolete/foo.el.
437 sed
-n
-e
'/^(defun /s/\(.\)(.*/\1/p' \
438 $$(find .
-name
'*.el' -print | \
439 grep
-Ev
'(loaddefs|ldefs-boot)\.el') |
sort | uniq
-d
443 ## None of the following matters for bootstrap, which is the only way
444 ## to ensure a correct compilation of all lisp files.
445 ## Manually specifying dependencies of a handful of lisp files, (and
446 ## ones that don't change very often at that) seems pretty pointless
449 # http://debbugs.gnu.org/1004
450 # CC Mode uses a compile time macro system which causes a compile time
451 # dependency in cc-*.elc files on the macros in other cc-*.el and the
452 # version string in cc-defs.el.
453 $(lisp
)/progmodes
/cc-align.elc\
454 $(lisp
)/progmodes
/cc-cmds.elc
$(lisp
)/progmodes
/cc-compat.elc\
455 $(lisp
)/progmodes
/cc-engine.elc
$(lisp
)/progmodes
/cc-fonts.elc\
456 $(lisp
)/progmodes
/cc-langs.elc
$(lisp
)/progmodes
/cc-menus.elc\
457 $(lisp
)/progmodes
/cc-mode.elc
$(lisp
)/progmodes
/cc-styles.elc\
458 $(lisp
)/progmodes
/cc-vars.elc
: \
459 $(lisp
)/progmodes
/cc-bytecomp.elc
$(lisp
)/progmodes
/cc-defs.elc
461 $(lisp
)/progmodes
/cc-align.elc
$(lisp
)/progmodes
/cc-cmds.elc
: \
462 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-engine.elc
464 $(lisp
)/progmodes
/cc-compat.elc
: \
465 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-styles.elc \
466 $(lisp
)/progmodes
/cc-engine.elc
468 $(lisp
)/progmodes
/cc-defs.elc
: $(lisp
)/progmodes
/cc-bytecomp.elc
470 $(lisp
)/progmodes
/cc-engine.elc
: $(lisp
)/progmodes
/cc-langs.elc \
471 $(lisp
)/progmodes
/cc-vars.elc
473 $(lisp
)/progmodes
/cc-fonts.elc
: $(lisp
)/progmodes
/cc-langs.elc \
474 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-engine.elc
476 $(lisp
)/progmodes
/cc-langs.elc
: $(lisp
)/progmodes
/cc-vars.elc
478 $(lisp
)/progmodes
/cc-mode.elc
: $(lisp
)/progmodes
/cc-langs.elc \
479 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-engine.elc \
480 $(lisp
)/progmodes
/cc-styles.elc
$(lisp
)/progmodes
/cc-cmds.elc \
481 $(lisp
)/progmodes
/cc-align.elc
$(lisp
)/progmodes
/cc-menus.elc
483 $(lisp
)/progmodes
/cc-styles.elc
: $(lisp
)/progmodes
/cc-vars.elc \
484 $(lisp
)/progmodes
/cc-align.elc
486 # Makefile ends here.