3 # Copyright (C) 2000-2015 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 ps-print-loaddefs.el \
85 emacs-lisp
/cl-loaddefs.el \
86 calc
/calc-loaddefs.el \
87 eshell
/esh-groups.el \
88 cedet
/semantic
/loaddefs.el \
89 cedet
/ede
/loaddefs.el \
90 cedet
/srecode
/loaddefs.el \
92 textmodes
/reftex-loaddefs.el \
93 mail
/rmail-loaddefs.el \
97 # Set load-prefer-newer for the benefit of the non-bootstrappers.
98 BYTE_COMPILE_FLAGS
= \
99 --eval
'(setq load-prefer-newer t)' $(BYTE_COMPILE_EXTRA_FLAGS
)
101 # Files to compile before others during a bootstrap. This is done to
102 # speed up the bootstrap process. They're ordered by size, so we use
103 # the slowest-compiler on the smallest file and move to larger files as the
104 # compiler gets faster. 'autoload.elc' comes last because it is not used by
105 # the compiler (so its compilation does not speed up subsequent compilations),
106 # it's only placed here so as to speed up generation of the loaddefs.el file.
109 $(lisp
)/emacs-lisp
/macroexp.elc \
110 $(lisp
)/emacs-lisp
/cconv.elc \
111 $(lisp
)/emacs-lisp
/byte-opt.elc \
112 $(lisp
)/emacs-lisp
/bytecomp.elc \
113 $(lisp
)/emacs-lisp
/autoload.elc
115 # Prevent any settings in the user environment causing problems.
116 unexport EMACSDATA EMACSDOC EMACSPATH
118 # The actual Emacs command run in the targets below.
119 # Prevent any setting of EMACSLOADPATH in user environment causing problems.
120 emacs
= EMACSLOADPATH
= '$(EMACS)' $(EMACSOPT
)
122 ## Subdirectories, relative to builddir.
123 SUBDIRS
= $(sort $(shell find
${srcdir} -type d
-print))
124 ## Subdirectories, relative to srcdir.
125 SUBDIRS_REL
= $(patsubst ${srcdir}%,.
%,${SUBDIRS})
126 ## All subdirectories except 'obsolete' and 'term'.
127 SUBDIRS_ALMOST
= $(filter-out ${srcdir}/obsolete
${srcdir}/term
,${SUBDIRS})
128 ## All subdirectories except 'obsolete', 'term', and 'leim' (and subdirs).
129 ## We don't want the leim files listed as packages, especially
130 ## since many share basenames with files in language/.
131 SUBDIRS_FINDER
= $(filter-out ${srcdir}/leim
%,${SUBDIRS_ALMOST})
132 ## All subdirectories in which we might want to create subdirs.el.
133 SUBDIRS_SUBDIRS
= $(filter-out ${srcdir}/cedet
% ${srcdir}/leim
%,${SUBDIRS})
135 # cus-load and finder-inf are not explicitly requested by anything, so
136 # we add them here to make sure they get built.
137 all: compile-main
$(lisp
)/cus-load.el
$(lisp
)/finder-inf.el
140 .PHONY
: all custom-deps finder-data autoloads update-subdirs
$(PHONY_EXTRAS
)
142 # custom-deps and finder-data both used to scan _all_ the *.el files.
143 # This could lead to problems in parallel builds if automatically
144 # generated *.el files (eg loaddefs etc) were being changed at the same time.
145 # One solution was to add autoloads as a prerequisite:
146 # http://lists.gnu.org/archive/html/emacs-pretest-bug/2007-01/msg00469.html
147 # http://lists.gnu.org/archive/html/bug-gnu-emacs/2007-12/msg00171.html
148 # However, this meant that running these targets modified loaddefs.el,
149 # every time (due to time-stamping). Calling these rules from
150 # bootstrap-after would modify loaddefs after src/emacs, resulting
151 # in make install remaking src/emacs for no real reason:
152 # http://lists.gnu.org/archive/html/emacs-devel/2008-02/msg00311.html
153 # Nowadays these commands don't scan automatically generated files,
154 # since they will never contain any useful information
155 # (see finder-no-scan-regexp and custom-dependencies-no-scan-regexp).
157 $(AM_V_at
)$(MAKE
) PHONY_EXTRAS
=$(lisp
)/cus-load.el
$(lisp
)/cus-load.el
159 $(AM_V_GEN
)$(emacs
) -l cus-dep \
160 --eval
'(setq generated-custom-dependencies-file (unmsys--file-name "$(srcdir)/cus-load.el"))' \
161 -f custom-make-dependencies
${SUBDIRS_ALMOST}
164 $(AM_V_at
)$(MAKE
) PHONY_EXTRAS
=$(lisp
)/finder-inf.el \
165 $(lisp
)/finder-inf.el
166 $(lisp
)/finder-inf.el
:
167 $(AM_V_GEN
)$(emacs
) -l finder \
168 --eval
'(setq generated-finder-keywords-file (unmsys--file-name "$(srcdir)/finder-inf.el"))' \
169 -f finder-compile-keywords-make-dist
${SUBDIRS_FINDER}
171 # Use expand-file-name rather than $abs_scrdir so that Emacs does not
172 # get confused when it compares file-names for equality.
174 # Note that we set no-update-autoloads in _generated_ leim files.
175 # If you want to allow autoloads in such files, remove that,
176 # and make this depend on leim.
177 autoloads .PHONY
: $(lisp
)/loaddefs.el
178 $(lisp
)/loaddefs.el
: $(LOADDEFS
)
179 @echo Directories for loaddefs
: ${SUBDIRS_ALMOST}
180 $(AM_V_GEN
)$(emacs
) -l autoload \
181 --eval
'(setq autoload-ensure-writable t)' \
182 --eval
'(setq autoload-builtin-package-versions t)' \
183 --eval
'(setq generated-autoload-file (expand-file-name (unmsys--file-name "$@")))' \
184 -f batch-update-autoloads
${SUBDIRS_ALMOST}
186 # autoloads only runs when loaddefs.el is non-existant, although it
187 # generates a number of different files. Provide a force option to enable
188 # regeneration of all these files.
189 autoloads-force .PHONY
:
193 # This is required by the bootstrap-emacs target in ../src/Makefile, so
194 # we know that if we have an emacs executable, we also have a subdirs.el.
196 $(AM_V_GEN
)$(MAKE
) update-subdirs
198 $(AM_V_at
)for file in
${SUBDIRS_SUBDIRS}; do \
199 $(srcdir)/..
/build-aux
/update-subdirs
$$file; \
202 .PHONY
: updates repo-update update-authors
204 # Some modes of make-dist use this.
205 updates
: update-subdirs autoloads finder-data custom-deps
207 # This is useful after updating from the repository; but it doesn't do
208 # anything that a plain "make" at top-level doesn't. The only
209 # difference between this and this directory's "all" rule is that this
210 # runs "autoloads" as well (because it uses "compile" rather than
211 # "compile-main"). In a bootstrap, $(lisp) in src/Makefile triggers
212 # this directory's autoloads rule.
213 repo-update
: compile finder-data custom-deps
215 # Update the AUTHORS file.
218 $(emacs
) -L
"$(top_srcdir)/admin" -l authors \
219 -f batch-update-authors
"$(top_srcdir)/etc/AUTHORS" "$(top_srcdir)"
222 ETAGS
= ..
/lib-src
/etags
224 lisptagsfiles1
= $(srcdir)/*.el
225 lisptagsfiles2
= $(srcdir)/*/*.el
226 lisptagsfiles3
= $(srcdir)/*/*/*.el
227 lisptagsfiles4
= $(srcdir)/*/*/*/*.el
229 ## The ls | sed | xargs is to stop the command line getting too long
230 ## on MS Windows, when the MSYS Bash passes it to a MinGW compiled
231 ## etags. It might be better to use find in a similar way to
232 ## compile-main. But maybe this is not even necessary any more now
233 ## that this uses relative filenames.
234 TAGS
: $(lisptagsfiles1
) $(lisptagsfiles2
) $(lisptagsfiles3
) $(lisptagsfiles4
)
237 ls
$(lisptagsfiles1
) $(lisptagsfiles2
) \
238 $(lisptagsfiles3
) $(lisptagsfiles4
) | \
239 sed
-e
'/loaddefs/d; /\/ldefs-boot/d; /esh-groups\.el/d' | \
240 xargs
$(XARGS_LIMIT
) "$(ETAGS)" -a
-o
$@
243 # The src/Makefile.in has its own set of dependencies and when they decide
244 # that one Lisp file needs to be re-compiled, we had better recompile it as
245 # well, otherwise every subsequent make will again call us, until we finally
246 # end up deciding that yes, the file deserves recompilation.
247 # One option is to try and reproduce exactly the same dependencies here as
248 # we have in src/Makefile.in, but it turns out to be painful
249 # (e.g. src/Makefile.in may have a dependency for ../lisp/foo.elc where we
250 # only know of $(lisp)/foo.elc). So instead we provide a direct way for
251 # src/Makefile.in to rebuild a particular Lisp file, no questions asked.
252 # Use byte-compile-refresh-preloaded to try and work around some of
253 # the most common problems of not bootstrapping from a clean state.
254 THEFILE
= no-such-file
257 $(AM_V_ELC
)$(emacs
) $(BYTE_COMPILE_FLAGS
) \
258 -l bytecomp
-f byte-compile-refresh-preloaded \
259 -f batch-byte-compile
$(THEFILE
)
261 # Files MUST be compiled one by one. If we compile several files in a
262 # row (i.e., in the same instance of Emacs) we can't make sure that
263 # the compilation environment is clean. We also set the load-path of
264 # the Emacs used for compilation to the current directory and its
265 # subdirectories, to make sure require's and load's in the files being
266 # compiled find the right files.
270 # An old-fashioned suffix rule, which, according to the GNU Make manual,
271 # cannot have prerequisites.
273 $(AM_V_ELC
)$(emacs
) $(BYTE_COMPILE_FLAGS
) -f batch-byte-compile
$<
275 .PHONY
: compile-first compile-main compile compile-always
277 compile-first
: $(COMPILE_FIRST
)
279 # In 'compile-main' we could directly do
280 # ... | xargs $(MAKE)
281 # and it works, but it generates a lot of messages like
282 # make[2]: gnus/gnus-mlspl.elc is up to date.
283 # so instead, we use "xargs echo" to split the list of file into manageable
284 # chunks and then use an intermediate 'compile-targets' target so the
285 # actual targets (the .elc files) are not mentioned as targets on the
289 .PHONY
: compile-targets
290 # TARGETS is set dynamically in the recursive call from 'compile-main'.
291 compile-targets
: $(TARGETS
)
293 # Compile all the Elisp files that need it. Beware: it approximates
294 # 'no-byte-compile', so watch out for false-positives!
295 compile-main
: leim semantic compile-clean
297 els
=`echo "${SUBDIRS_REL} " | sed -e 's|/\./|/|g' -e 's|/\. | |g' -e 's| |/*.el |g'`; \
298 for el in
$$els; do \
299 test -f
$$el || continue
; \
300 test ! -f
$${el}c
&& GREP_OPTIONS
= grep
'^;.*no-byte-compile: t' $$el > /dev
/null
&& continue
; \
302 done | xargs
$(XARGS_LIMIT
) echo
) | \
303 while read chunk
; do \
304 $(MAKE
) compile-targets TARGETS
="$$chunk"; \
307 .PHONY
: compile-clean
308 # Erase left-over .elc files that do not have a corresponding .el file.
311 elcs
=`echo "${SUBDIRS_REL} " | sed -e 's|/\./|/|g' -e 's|/\. | |g' -e 's| |/*.elc |g'`; \
312 for el in
`echo $$elcs | sed -e 's/\.elc/\.el/g'`; do \
313 if
test -f
"$$el" ||
test ! -f
"$${el}c"; then
:; else \
319 .PHONY
: leim semantic
321 $(MAKE
) -C ..
/leim
all EMACS
="$(EMACS)"
324 $(MAKE
) -C ..
/admin
/grammars
all EMACS
="$(EMACS:.%=../.%)"
326 # Compile all Lisp files, but don't recompile those that are up to
327 # date. Some .el files don't get compiled because they set the
328 # local variable no-byte-compile.
329 # Calling make recursively because suffix rule cannot have prerequisites.
330 compile
: $(LOADDEFS
) autoloads compile-first
333 # Compile all Lisp files. This is like 'compile' but compiles files
334 # unconditionally. Some files don't actually get compiled because they
335 # set the local variable no-byte-compile.
337 cd
$(lisp
) && rm -f
*.elc
*/*.elc
*/*/*.elc
*/*/*/*.elc
340 .PHONY
: backup-compiled-files compile-after-backup
342 # Backup compiled Lisp files in elc.tar.gz. If that file already
343 # exists, make a backup of it.
345 backup-compiled-files
:
346 -mv
$(lisp
)/elc.
tar.gz
$(lisp
)/elc.
tar.gz~
347 -tar czf
$(lisp
)/elc.
tar.gz
$(lisp
)/*.elc
$(lisp
)/*/*.elc
$(lisp
)/*/*/*.elc
$(lisp
)/*/*/*/*.elc
349 # Compile Lisp files, but save old compiled files first.
351 compile-after-backup
: backup-compiled-files compile-always
353 # This does the same job as the "compile" rule, but in a different way.
354 # Rather than spawning a separate Emacs instance to compile each file,
355 # it uses the same Emacs instance to compile everything.
356 # This is faster on a single core, since it avoids the overhead of
357 # starting Emacs many times (it was 33% faster on a test with a
358 # random 10% of the .el files needing recompilation).
359 # Unlike compile, this is not parallelizable; so if you have more than
360 # one core and use make -j#, compile will be (much) faster.
361 # This rule also produces less accurate compilation warnings.
362 # The environment of later files is affected by definitions in
363 # earlier ones, so it does not produce some warnings that it should.
364 # It can also produces spurious warnings about "invalid byte code" if
365 # files that use byte-compile-dynamic are updated.
366 # There is no reason to use this rule unless you only have a single
367 # core and CPU time is an issue.
368 .PHONY
: compile-one-process
369 compile-one-process
: $(LOADDEFS
) compile-first
370 $(emacs
) $(BYTE_COMPILE_FLAGS
) \
371 --eval
"(batch-byte-recompile-directory 0)" $(lisp
)
373 # Update MH-E internal autoloads. These are not to be confused with
374 # the autoloads for the MH-E entry points, which are already in loaddefs.el.
375 MH_E_DIR
= $(lisp
)/mh-e
376 MH_E_SRC
= $(sort $(wildcard ${MH_E_DIR}/mh
*.el
))
377 MH_E_SRC
:= $(filter-out ${MH_E_DIR}/mh-loaddefs.el
,${MH_E_SRC})
380 mh-autoloads
: $(MH_E_DIR
)/mh-loaddefs.el
381 $(MH_E_DIR
)/mh-loaddefs.el
: $(MH_E_SRC
)
382 $(AM_V_GEN
)$(emacs
) -l autoload \
383 --eval
"(setq generate-autoload-cookie \";;;###mh-autoload\")" \
384 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
385 -f batch-update-autoloads
$(MH_E_DIR
)
387 # Update TRAMP internal autoloads. Maybe we could move tramp*.el into
388 # an own subdirectory. OTOH, it does not hurt to keep them in
390 TRAMP_DIR
= $(lisp
)/net
391 TRAMP_SRC
= $(sort $(wildcard ${TRAMP_DIR}/tramp
*.el
))
392 TRAMP_SRC
:= $(filter-out ${TRAMP_DIR}/tramp-loaddefs.el
,${TRAMP_SRC})
394 $(TRAMP_DIR
)/tramp-loaddefs.el
: $(TRAMP_SRC
)
395 $(AM_V_GEN
)$(emacs
) -l autoload \
396 --eval
"(setq generate-autoload-cookie \";;;###tramp-autoload\")" \
397 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
398 -f batch-update-autoloads
$(TRAMP_DIR
)
400 CAL_DIR
= $(lisp
)/calendar
401 ## Those files that may contain internal calendar autoload cookies.
402 CAL_SRC
= $(addprefix ${CAL_DIR}/,diary-lib.el holidays.el lunar.el solar.el
)
403 CAL_SRC
:= $(sort ${CAL_SRC} $(wildcard ${CAL_DIR}/cal
*.el
))
404 CAL_SRC
:= $(filter-out ${CAL_DIR}/cal-loaddefs.el
,${CAL_SRC})
406 $(CAL_DIR
)/cal-loaddefs.el
: $(CAL_SRC
)
407 $(AM_V_GEN
)$(emacs
) -l autoload \
408 --eval
"(setq generate-autoload-cookie \";;;###cal-autoload\")" \
409 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
410 -f batch-update-autoloads
$(CAL_DIR
)
412 $(CAL_DIR
)/diary-loaddefs.el
: $(CAL_SRC
) $(CAL_DIR
)/cal-loaddefs.el
413 $(AM_V_GEN
)$(emacs
) -l autoload \
414 --eval
"(setq generate-autoload-cookie \";;;###diary-autoload\")" \
415 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
416 -f batch-update-autoloads
$(CAL_DIR
)
418 $(CAL_DIR
)/hol-loaddefs.el
: $(CAL_SRC
) $(CAL_DIR
)/diary-loaddefs.el
419 $(AM_V_GEN
)$(emacs
) -l autoload \
420 --eval
"(setq generate-autoload-cookie \";;;###holiday-autoload\")" \
421 --eval
"(setq generated-autoload-file (expand-file-name (unmsys--file-name \"$@\")))" \
422 -f batch-update-autoloads
$(CAL_DIR
)
424 .PHONY
: bootstrap-clean
distclean maintainer-clean
427 -cd
$(lisp
) && rm -f
*.elc
*/*.elc
*/*/*.elc
*/*/*/*.elc
$(AUTOGENEL
)
430 -rm -f .
/Makefile
$(lisp
)/loaddefs.el~
432 maintainer-clean
: distclean bootstrap-clean
435 .PHONY
: check-declare
438 $(emacs
) -l check-declare
--eval
'(check-declare-directory "$(lisp)")'
440 ## This finds a lot of duplicates between foo.el and obsolete/foo.el.
442 sed
-n
-e
'/^(defun /s/\(.\)(.*/\1/p' \
443 $$(find .
-name
'*.el' -print | \
444 grep
-Ev
'(loaddefs|ldefs-boot)\.el') |
sort | uniq
-d
448 ## None of the following matters for bootstrap, which is the only way
449 ## to ensure a correct compilation of all lisp files.
450 ## Manually specifying dependencies of a handful of lisp files, (and
451 ## ones that don't change very often at that) seems pretty pointless
454 # http://debbugs.gnu.org/1004
455 # CC Mode uses a compile time macro system which causes a compile time
456 # dependency in cc-*.elc files on the macros in other cc-*.el and the
457 # version string in cc-defs.el.
458 $(lisp
)/progmodes
/cc-align.elc\
459 $(lisp
)/progmodes
/cc-cmds.elc
$(lisp
)/progmodes
/cc-compat.elc\
460 $(lisp
)/progmodes
/cc-engine.elc
$(lisp
)/progmodes
/cc-fonts.elc\
461 $(lisp
)/progmodes
/cc-langs.elc
$(lisp
)/progmodes
/cc-menus.elc\
462 $(lisp
)/progmodes
/cc-mode.elc
$(lisp
)/progmodes
/cc-styles.elc\
463 $(lisp
)/progmodes
/cc-vars.elc
: \
464 $(lisp
)/progmodes
/cc-bytecomp.elc
$(lisp
)/progmodes
/cc-defs.elc
466 $(lisp
)/progmodes
/cc-align.elc
$(lisp
)/progmodes
/cc-cmds.elc
: \
467 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-engine.elc
469 $(lisp
)/progmodes
/cc-compat.elc
: \
470 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-styles.elc \
471 $(lisp
)/progmodes
/cc-engine.elc
473 $(lisp
)/progmodes
/cc-defs.elc
: $(lisp
)/progmodes
/cc-bytecomp.elc
475 $(lisp
)/progmodes
/cc-engine.elc
: $(lisp
)/progmodes
/cc-langs.elc \
476 $(lisp
)/progmodes
/cc-vars.elc
478 $(lisp
)/progmodes
/cc-fonts.elc
: $(lisp
)/progmodes
/cc-langs.elc \
479 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-engine.elc
481 $(lisp
)/progmodes
/cc-langs.elc
: $(lisp
)/progmodes
/cc-vars.elc
483 $(lisp
)/progmodes
/cc-mode.elc
: $(lisp
)/progmodes
/cc-langs.elc \
484 $(lisp
)/progmodes
/cc-vars.elc
$(lisp
)/progmodes
/cc-engine.elc \
485 $(lisp
)/progmodes
/cc-styles.elc
$(lisp
)/progmodes
/cc-cmds.elc \
486 $(lisp
)/progmodes
/cc-align.elc
$(lisp
)/progmodes
/cc-menus.elc
488 $(lisp
)/progmodes
/cc-styles.elc
: $(lisp
)/progmodes
/cc-vars.elc \
489 $(lisp
)/progmodes
/cc-align.elc
491 # Makefile ends here.