Clarify wording about functions' argument lists
[emacs.git] / src / Makefile.in
blob6ed8f3cc91627133babe386fcc1d39cc608af195
1 ### @configure_input@
3 # Copyright (C) 1985, 1987-1988, 1993-1995, 1999-2018 Free Software
4 # 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 <https://www.gnu.org/licenses/>.
22 # Note that this file is edited by msdos/sed1v2.inp for MSDOS. That
23 # script may need modifying in sync with changes made here. Try to
24 # avoid shell-ism because the DOS build has to use the DOS shell.
26 SHELL = @SHELL@
28 # Here are the things that we expect ../configure to edit.
29 # We use $(srcdir) explicitly in dependencies so as not to depend on VPATH.
30 srcdir = @srcdir@
31 top_srcdir = @top_srcdir@
32 # MinGW CPPFLAGS may use this.
33 abs_top_srcdir=@abs_top_srcdir@
34 VPATH = $(srcdir)
35 CC = @CC@
36 CFLAGS = @CFLAGS@
37 CPPFLAGS = @CPPFLAGS@
38 LDFLAGS = @LDFLAGS@
39 EXEEXT = @EXEEXT@
40 version = @version@
41 MKDIR_P = @MKDIR_P@
42 # Don't use LIBS. configure puts stuff in it that either shouldn't be
43 # linked with Emacs or is duplicated by the other stuff below.
44 # LIBS = @LIBS@
45 LIBOBJS = @LIBOBJS@
47 lispsource = $(top_srcdir)/lisp
48 lib = ../lib
49 libsrc = ../lib-src
50 etc = ../etc
51 oldXMenudir = ../oldXMenu
52 lwlibdir = ../lwlib
54 # Configuration files for .o files to depend on.
55 config_h = config.h $(srcdir)/conf_post.h
57 bootstrap_exe = ../src/bootstrap-emacs$(EXEEXT)
59 ## ns-app if HAVE_NS, else empty.
60 OTHER_FILES = @OTHER_FILES@
62 ## Flags to pass for profiling builds
63 PROFILING_CFLAGS = @PROFILING_CFLAGS@
65 ## Flags to pass to the compiler to enable build warnings
66 WARN_CFLAGS = @WARN_CFLAGS@
67 WERROR_CFLAGS = @WERROR_CFLAGS@
69 ## Machine-specific CFLAGS.
70 C_SWITCH_MACHINE=@C_SWITCH_MACHINE@
71 ## System-specific CFLAGS.
72 C_SWITCH_SYSTEM=@C_SWITCH_SYSTEM@
74 GNUSTEP_CFLAGS=@GNUSTEP_CFLAGS@
75 PNG_CFLAGS=@PNG_CFLAGS@
77 ## Define C_SWITCH_X_SITE to contain any special flags your compiler
78 ## may need to deal with X Windows. For instance, if you've defined
79 ## HAVE_X_WINDOWS and your X include files aren't in a place that your
80 ## compiler can find on its own, you might want to add "-I/..." or
81 ## something similar. This is normally set by configure.
82 C_SWITCH_X_SITE=@C_SWITCH_X_SITE@
84 ## Define LD_SWITCH_X_SITE to contain any special flags your loader
85 ## may need to deal with X Windows. For instance, if your X libraries
86 ## aren't in a place that your loader can find on its own, you might
87 ## want to add "-L/..." or something similar. Only used if
88 ## HAVE_X_WINDOWS.
89 ## FIXME? configure sets a value for this, but it has never been
90 ## substituted in this or any other Makefile. Cf C_SWITCH_X_SITE.
91 LD_SWITCH_X_SITE=
93 ## This must come before LD_SWITCH_SYSTEM.
94 ## If needed, a -rpath option that says where to find X windows at run time.
95 LD_SWITCH_X_SITE_RPATH=@LD_SWITCH_X_SITE_RPATH@
97 ## System-specific LDFLAGS.
98 LD_SWITCH_SYSTEM=@LD_SWITCH_SYSTEM@
100 ## This holds any special options for linking temacs only (i.e., not
101 ## used by configure).
102 LD_SWITCH_SYSTEM_TEMACS=@LD_SWITCH_SYSTEM_TEMACS@
104 ## Flags to pass to ld only for temacs.
105 TEMACS_LDFLAGS = $(LD_SWITCH_SYSTEM) $(LD_SWITCH_SYSTEM_TEMACS)
107 ## If available, the names of the paxctl and setfattr programs.
108 ## On grsecurity/PaX systems, unexec will fail due to a gap between
109 ## the bss section and the heap. Older versions need paxctl to work
110 ## around this, newer ones setfattr. See Bug#11398 and Bug#16343.
111 PAXCTL = @PAXCTL@
112 SETFATTR = @SETFATTR@
113 ## Commands to set PaX flags on dumped and not-dumped instances of Emacs.
114 PAXCTL_dumped = @PAXCTL_dumped@
115 PAXCTL_notdumped = @PAXCTL_notdumped@
117 ## Some systems define this to request special libraries.
118 LIBS_SYSTEM=@LIBS_SYSTEM@
120 ## -lm, or empty.
121 LIB_MATH=@LIB_MATH@
123 ## -lpthread, or empty.
124 LIB_PTHREAD=@LIB_PTHREAD@
126 LIBIMAGE=@LIBTIFF@ @LIBJPEG@ @LIBPNG@ @LIBGIF@ @LIBXPM@
128 XCB_LIBS=@XCB_LIBS@
129 XFT_LIBS=@XFT_LIBS@
130 LIBX_EXTRA=-lX11 $(XCB_LIBS) $(XFT_LIBS)
132 FONTCONFIG_CFLAGS = @FONTCONFIG_CFLAGS@
133 FONTCONFIG_LIBS = @FONTCONFIG_LIBS@
134 FREETYPE_CFLAGS = @FREETYPE_CFLAGS@
135 FREETYPE_LIBS = @FREETYPE_LIBS@
136 LIBOTF_CFLAGS = @LIBOTF_CFLAGS@
137 LIBOTF_LIBS = @LIBOTF_LIBS@
138 M17N_FLT_CFLAGS = @M17N_FLT_CFLAGS@
139 M17N_FLT_LIBS = @M17N_FLT_LIBS@
141 LIB_ACL=@LIB_ACL@
142 LIB_CLOCK_GETTIME=@LIB_CLOCK_GETTIME@
143 LIB_EACCESS=@LIB_EACCESS@
144 LIB_FDATASYNC=@LIB_FDATASYNC@
145 LIB_TIMER_TIME=@LIB_TIMER_TIME@
147 DBUS_CFLAGS = @DBUS_CFLAGS@
148 DBUS_LIBS = @DBUS_LIBS@
149 ## dbusbind.o if HAVE_DBUS, else empty.
150 DBUS_OBJ = @DBUS_OBJ@
152 ## xwidgets.o if HAVE_XWIDGETS, else empty.
153 XWIDGETS_OBJ = @XWIDGETS_OBJ@
155 LIB_EXECINFO=@LIB_EXECINFO@
157 SETTINGS_CFLAGS = @SETTINGS_CFLAGS@
158 SETTINGS_LIBS = @SETTINGS_LIBS@
160 ## gtkutil.o if USE_GTK, else empty.
161 GTK_OBJ=@GTK_OBJ@
163 ## inotify.o if HAVE_INOTIFY.
164 ## kqueue.o if HAVE_KQUEUE.
165 ## gfilenotify.o if HAVE_GFILENOTIFY.
166 ## w32notify.o if HAVE_W32NOTIFY.
167 NOTIFY_OBJ = @NOTIFY_OBJ@
168 NOTIFY_CFLAGS = @NOTIFY_CFLAGS@
169 NOTIFY_LIBS = @NOTIFY_LIBS@
171 ## -ltermcap, or -lncurses, or -lcurses, or "".
172 LIBS_TERMCAP=@LIBS_TERMCAP@
173 ## terminfo.o if TERMINFO, else (on MS-DOS only: termcap.o +) tparam.o.
174 TERMCAP_OBJ=@TERMCAP_OBJ@
176 LIBXMU=@LIBXMU@
178 LIBXSM=@LIBXSM@
180 LIBXTR6=@LIBXTR6@
182 ## $(LIBXMU) -lXt $(LIBXTR6) -lXext if USE_X_TOOLKIT, else $(LIBXSM).
183 ## Only used if HAVE_X_WINDOWS.
184 LIBXT_OTHER=@LIBXT_OTHER@
186 ## If !HAVE_X11 || USE_GTK, empty.
187 ## Else if USE_X_TOOLKIT, $(lwlibdir)/liblw.a.
188 ## Else $(oldXMenudir)/libXMenu11.a.
189 LIBXMENU=@LIBXMENU@
191 ## xmenu.o if HAVE_X_WINDOWS, else empty.
192 XMENU_OBJ=@XMENU_OBJ@
193 ## xterm.o xfns.o xselect.o xrdb.o xsmfns.o xsettings.o if
194 ## HAVE_X_WINDOWS, else empty.
195 XOBJ=@XOBJ@
197 # xgselect.o if linking with GLib, else empty
198 XGSELOBJ=@XGSELOBJ@
200 TOOLKIT_LIBW=@TOOLKIT_LIBW@
202 ## Only used if HAVE_X11, in LIBX_OTHER.
203 LIBXT=$(TOOLKIT_LIBW) $(LIBXT_OTHER)
205 ## If HAVE_X11, $(LIBXT) $(LIBX_EXTRA), else empty.
206 LIBX_OTHER=@LIBX_OTHER@
208 ## LIBXMENU is empty if !HAVE_X_WINDOWS.
209 ## LD_SWITCH_X_SITE should not be used if not using X, but nothing
210 ## sets it at present, and if something ever does, it should be
211 ## configure, which should set it to nil in non-X builds.
212 LIBX_BASE=$(LIBXMENU) $(LD_SWITCH_X_SITE)
214 ## Used only for GNUstep.
215 LIBS_GNUSTEP=$(patsubst -specs=%-hardened-ld,,@LIBS_GNUSTEP@)
217 LIBSOUND= @LIBSOUND@
218 CFLAGS_SOUND= @CFLAGS_SOUND@
220 RSVG_LIBS= @RSVG_LIBS@
221 RSVG_CFLAGS= @RSVG_CFLAGS@
223 WEBKIT_LIBS= @WEBKIT_LIBS@
224 WEBKIT_CFLAGS= @WEBKIT_CFLAGS@
226 CAIRO_LIBS= @CAIRO_LIBS@
227 CAIRO_CFLAGS= @CAIRO_CFLAGS@
229 IMAGEMAGICK_LIBS= @IMAGEMAGICK_LIBS@
230 IMAGEMAGICK_CFLAGS= @IMAGEMAGICK_CFLAGS@
232 LIBXML2_LIBS = @LIBXML2_LIBS@
233 LIBXML2_CFLAGS = @LIBXML2_CFLAGS@
235 GETADDRINFO_A_LIBS = @GETADDRINFO_A_LIBS@
237 LIBLCMS2 = @LIBLCMS2@
239 LIBZ = @LIBZ@
241 ## system-specific libs for dynamic modules, else empty
242 LIBMODULES = @LIBMODULES@
243 ## dynlib.o emacs-module.o if modules enabled, else empty
244 MODULES_OBJ = @MODULES_OBJ@
246 XRANDR_LIBS = @XRANDR_LIBS@
247 XRANDR_CFLAGS = @XRANDR_CFLAGS@
249 XINERAMA_LIBS = @XINERAMA_LIBS@
250 XINERAMA_CFLAGS = @XINERAMA_CFLAGS@
252 XFIXES_LIBS = @XFIXES_LIBS@
253 XFIXES_CFLAGS = @XFIXES_CFLAGS@
255 XDBE_LIBS = @XDBE_LIBS@
256 XDBE_CFLAGS = @XDBE_CFLAGS@
258 ## widget.o if USE_X_TOOLKIT, otherwise empty.
259 WIDGET_OBJ=@WIDGET_OBJ@
261 HYBRID_MALLOC = @HYBRID_MALLOC@
263 ## cygw32.o if CYGWIN, otherwise empty.
264 CYGWIN_OBJ=@CYGWIN_OBJ@
266 ## fontset.o fringe.o image.o if we have any window system
267 WINDOW_SYSTEM_OBJ=@WINDOW_SYSTEM_OBJ@
269 ## dosfns.o msdos.o w16select.o if MSDOS.
270 MSDOS_OBJ =
271 ## w16select.o termcap.o if MSDOS && HAVE_X_WINDOWS.
272 MSDOS_X_OBJ =
274 NS_OBJ=@NS_OBJ@
275 ## nsterm.o nsfns.o nsmenu.o nsselect.o nsimage.o ns_fontfile if HAVE_NS.
276 NS_OBJC_OBJ=@NS_OBJC_OBJ@
277 ## Used only for GNUstep.
278 GNU_OBJC_CFLAGS=$(patsubst -specs=%-hardened-cc1,,@GNU_OBJC_CFLAGS@)
279 ## w32fns.o w32menu.c w32reg.o fringe.o fontset.o w32font.o w32term.o
280 ## w32xfns.o w32select.o image.o w32uniscribe.o if HAVE_W32, else
281 ## empty.
282 W32_OBJ=@W32_OBJ@
283 ## -lkernel32 -luser32 -lusp10 -lgdi32 -lole32 -lcomdlg32 -lcomctl32
284 ## --lwinspool if HAVE_W32, else empty.
285 W32_LIBS=@W32_LIBS@
287 ## emacs.res if HAVE_W32
288 EMACSRES = @EMACSRES@
289 ## If HAVE_W32, compiler arguments for including
290 ## the resource file in the binary.
291 ## Cygwin: -Wl,emacs.res
292 ## MinGW: emacs.res
293 W32_RES_LINK=@W32_RES_LINK@
295 ## Empty if !HAVE_X_WINDOWS
296 ## xfont.o ftfont.o xftfont.o ftxfont.o if HAVE_XFT
297 ## xfont.o ftfont.o ftxfont.o if HAVE_FREETYPE
298 ## ftfont.o ftcrfont.o if USE_CAIRO
299 ## else xfont.o
300 FONT_OBJ=@FONT_OBJ@
302 ## Empty for MinGW, cm.o for the rest.
303 CM_OBJ=@CM_OBJ@
305 LIBGPM = @LIBGPM@
307 LIBSELINUX_LIBS = @LIBSELINUX_LIBS@
309 LIBGNUTLS_LIBS = @LIBGNUTLS_LIBS@
310 LIBGNUTLS_CFLAGS = @LIBGNUTLS_CFLAGS@
312 LIBSYSTEMD_LIBS = @LIBSYSTEMD_LIBS@
313 LIBSYSTEMD_CFLAGS = @LIBSYSTEMD_CFLAGS@
315 INTERVALS_H = dispextern.h intervals.h composite.h
317 GETLOADAVG_LIBS = @GETLOADAVG_LIBS@
319 RUN_TEMACS = ./temacs
321 # Whether builds should contain details. '--no-build-details' or empty.
322 BUILD_DETAILS = @BUILD_DETAILS@
324 UNEXEC_OBJ = @UNEXEC_OBJ@
326 CANNOT_DUMP=@CANNOT_DUMP@
328 # 'make' verbosity.
329 AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
331 AM_V_CC = $(am__v_CC_@AM_V@)
332 am__v_CC_ = $(am__v_CC_@AM_DEFAULT_V@)
333 am__v_CC_0 = @echo " CC " $@;
334 am__v_CC_1 =
336 AM_V_CCLD = $(am__v_CCLD_@AM_V@)
337 am__v_CCLD_ = $(am__v_CCLD_@AM_DEFAULT_V@)
338 am__v_CCLD_0 = @echo " CCLD " $@;
339 am__v_CCLD_1 =
341 AM_V_GEN = $(am__v_GEN_@AM_V@)
342 am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
343 am__v_GEN_0 = @echo " GEN " $@;
344 am__v_GEN_1 =
346 AM_V_at = $(am__v_at_@AM_V@)
347 am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
348 am__v_at_0 = @
349 am__v_at_1 =
351 # Flags that might be in WARN_CFLAGS but are not valid for Objective C.
352 NON_OBJC_CFLAGS = -Wignored-attributes -Wignored-qualifiers -Wopenmp-simd
354 # -Demacs makes some files produce the correct version for use in Emacs.
355 # MYCPPFLAGS is for by-hand Emacs-specific overrides, e.g.,
356 # "make MYCPPFLAGS='-DDBUS_DEBUG'".
357 EMACS_CFLAGS=-Demacs $(MYCPPFLAGS) -I. -I$(srcdir) \
358 -I$(lib) -I$(top_srcdir)/lib \
359 $(C_SWITCH_MACHINE) $(C_SWITCH_SYSTEM) $(C_SWITCH_X_SITE) \
360 $(GNUSTEP_CFLAGS) $(CFLAGS_SOUND) $(RSVG_CFLAGS) $(IMAGEMAGICK_CFLAGS) \
361 $(PNG_CFLAGS) $(LIBXML2_CFLAGS) $(DBUS_CFLAGS) \
362 $(XRANDR_CFLAGS) $(XINERAMA_CFLAGS) $(XFIXES_CFLAGS) $(XDBE_CFLAGS) \
363 $(WEBKIT_CFLAGS) \
364 $(SETTINGS_CFLAGS) $(FREETYPE_CFLAGS) $(FONTCONFIG_CFLAGS) \
365 $(LIBOTF_CFLAGS) $(M17N_FLT_CFLAGS) $(DEPFLAGS) \
366 $(LIBSYSTEMD_CFLAGS) \
367 $(LIBGNUTLS_CFLAGS) $(NOTIFY_CFLAGS) $(CAIRO_CFLAGS) \
368 $(WERROR_CFLAGS)
369 ALL_CFLAGS = $(EMACS_CFLAGS) $(WARN_CFLAGS) $(CFLAGS)
370 ALL_OBJC_CFLAGS = $(EMACS_CFLAGS) \
371 $(filter-out $(NON_OBJC_CFLAGS),$(WARN_CFLAGS)) $(CFLAGS) \
372 $(GNU_OBJC_CFLAGS)
374 .SUFFIXES: .m
375 .c.o:
376 $(AM_V_CC)$(CC) -c $(CPPFLAGS) $(ALL_CFLAGS) $(PROFILING_CFLAGS) $<
377 .m.o:
378 $(AM_V_CC)$(CC) -c $(CPPFLAGS) $(ALL_OBJC_CFLAGS) $(PROFILING_CFLAGS) $<
380 ## lastfile must follow all files whose initialized data areas should
381 ## be dumped as pure by dump-emacs.
382 base_obj = dispnew.o frame.o scroll.o xdisp.o menu.o $(XMENU_OBJ) window.o \
383 charset.o coding.o category.o ccl.o character.o chartab.o bidi.o \
384 $(CM_OBJ) term.o terminal.o xfaces.o $(XOBJ) $(GTK_OBJ) $(DBUS_OBJ) \
385 emacs.o keyboard.o macros.o keymap.o sysdep.o \
386 buffer.o filelock.o insdel.o marker.o \
387 minibuf.o fileio.o dired.o \
388 cmds.o casetab.o casefiddle.o indent.o search.o regex.o undo.o \
389 alloc.o data.o doc.o editfns.o callint.o \
390 eval.o floatfns.o fns.o font.o print.o lread.o $(MODULES_OBJ) \
391 syntax.o $(UNEXEC_OBJ) bytecode.o \
392 process.o gnutls.o callproc.o \
393 region-cache.o sound.o atimer.o \
394 doprnt.o intervals.o textprop.o composite.o xml.o lcms.o $(NOTIFY_OBJ) \
395 $(XWIDGETS_OBJ) \
396 profiler.o decompress.o \
397 thread.o systhread.o \
398 $(if $(HYBRID_MALLOC),sheap.o) \
399 $(MSDOS_OBJ) $(MSDOS_X_OBJ) $(NS_OBJ) $(CYGWIN_OBJ) $(FONT_OBJ) \
400 $(W32_OBJ) $(WINDOW_SYSTEM_OBJ) $(XGSELOBJ)
401 obj = $(base_obj) $(NS_OBJC_OBJ)
403 ## Object files used on some machine or other.
404 ## These go in the DOC file on all machines in case they are needed.
405 ## Some of them have no DOC entries, but it does no harm to have them
406 ## in the list, in case they ever add any such entries.
407 SOME_MACHINE_OBJECTS = dosfns.o msdos.o \
408 xterm.o xfns.o xmenu.o xselect.o xrdb.o xsmfns.o fringe.o image.o \
409 fontset.o dbusbind.o cygw32.o \
410 nsterm.o nsfns.o nsmenu.o nsselect.o nsimage.o nsfont.o macfont.o \
411 w32.o w32console.o w32fns.o w32heap.o w32inevt.o w32notify.o \
412 w32menu.o w32proc.o w32reg.o w32select.o w32term.o w32xfns.o \
413 w16select.o widget.o xfont.o ftfont.o xftfont.o ftxfont.o gtkutil.o \
414 xsettings.o xgselect.o termcap.o
416 ## gmalloc.o if !SYSTEM_MALLOC && !DOUG_LEA_MALLOC, else empty.
417 GMALLOC_OBJ=@GMALLOC_OBJ@
419 ## vm-limit.o if !SYSTEM_MALLOC, else empty.
420 VMLIMIT_OBJ=@VMLIMIT_OBJ@
422 ## ralloc.o if !SYSTEM_MALLOC && REL_ALLOC, else empty.
423 RALLOC_OBJ=@RALLOC_OBJ@
425 ## Empty on Cygwin and MinGW, lastfile.o elsewhere.
426 PRE_ALLOC_OBJ=@PRE_ALLOC_OBJ@
427 ## lastfile.o on Cygwin and MinGW, empty elsewhere.
428 POST_ALLOC_OBJ=@POST_ALLOC_OBJ@
430 ## List of object files that make-docfile should not be told about.
431 otherobj= $(TERMCAP_OBJ) $(PRE_ALLOC_OBJ) $(GMALLOC_OBJ) $(RALLOC_OBJ) \
432 $(POST_ALLOC_OBJ) $(WIDGET_OBJ) $(LIBOBJS)
434 ## All object files linked into temacs. $(VMLIMIT_OBJ) should be first.
435 ## (On MinGW, firstfile.o should be before vm-limit.o.)
436 FIRSTFILE_OBJ=@FIRSTFILE_OBJ@
437 ALLOBJS = $(FIRSTFILE_OBJ) $(VMLIMIT_OBJ) $(obj) $(otherobj)
439 AUTO_DEPEND = @AUTO_DEPEND@
440 DEPDIR = deps
441 ifeq ($(AUTO_DEPEND),yes)
442 DEPFLAGS = -MMD -MF $(DEPDIR)/$*.d -MP
443 -include $(ALLOBJS:%.o=$(DEPDIR)/%.d)
444 else
445 DEPFLAGS =
446 include $(srcdir)/deps.mk
447 endif
449 all: emacs$(EXEEXT) $(OTHER_FILES)
450 .PHONY: all
452 ## This is the list of all Lisp files that might be loaded into the
453 ## dumped Emacs. Some of them are not loaded on all platforms, but
454 ## the DOC file on every platform uses them (because the DOC file is
455 ## supposed to be platform-independent).
456 ## Note that this list should not include lisp files which might not
457 ## be present, like site-load.el and site-init.el; this makefile
458 ## expects them all to be either present or buildable.
460 ## To generate this list from loadup.el, we can either:
461 ## 1) Extract everything matching (load "..."), in which case
462 ## we need to add charprop.el by hand; or
463 ## 2) Extract everything matching (load "...", in which case
464 ## we need to remove leim-list, site-init, and site-load by hand.
465 ## There's not much to choose between these two approaches,
466 ## but the second one seems like it could be more future-proof.
467 shortlisp =
468 lisp.mk: $(lispsource)/loadup.el
469 @rm -f $@
470 ${AM_V_GEN}( printf 'shortlisp = \\\n'; \
471 sed -n 's/^[ \t]*(load "\([^"]*\)".*/\1/p' $< | \
472 sed -e 's/$$/.elc \\/' -e 's/\.el\.elc/.el/'; \
473 echo "" ) > $@
475 -include lisp.mk
476 shortlisp_filter = leim/leim-list.el site-load.elc site-init.elc
477 shortlisp := $(filter-out ${shortlisp_filter},${shortlisp})
478 ## Place loaddefs.el first, so it gets generated first, since it is on
479 ## the critical path (relevant in parallel compilations).
480 ## We don't really need to sort, but may as well use it to remove duplicates.
481 shortlisp := loaddefs.el loadup.el $(sort ${shortlisp})
482 lisp = $(addprefix ${lispsource}/,${shortlisp})
484 ## Construct full set of libraries to be linked.
485 LIBES = $(LIBS) $(W32_LIBS) $(LIBS_GNUSTEP) $(LIBX_BASE) $(LIBIMAGE) \
486 $(LIBX_OTHER) $(LIBSOUND) \
487 $(RSVG_LIBS) $(IMAGEMAGICK_LIBS) $(LIB_ACL) $(LIB_CLOCK_GETTIME) \
488 $(WEBKIT_LIBS) \
489 $(LIB_EACCESS) $(LIB_FDATASYNC) $(LIB_TIMER_TIME) $(DBUS_LIBS) \
490 $(LIB_EXECINFO) $(XRANDR_LIBS) $(XINERAMA_LIBS) $(XFIXES_LIBS) \
491 $(XDBE_LIBS) \
492 $(LIBXML2_LIBS) $(LIBGPM) $(LIBS_SYSTEM) $(CAIRO_LIBS) \
493 $(LIBS_TERMCAP) $(GETLOADAVG_LIBS) $(SETTINGS_LIBS) $(LIBSELINUX_LIBS) \
494 $(FREETYPE_LIBS) $(FONTCONFIG_LIBS) $(LIBOTF_LIBS) $(M17N_FLT_LIBS) \
495 $(LIBGNUTLS_LIBS) $(LIB_PTHREAD) $(GETADDRINFO_A_LIBS) $(LIBLCMS2) \
496 $(NOTIFY_LIBS) $(LIB_MATH) $(LIBZ) $(LIBMODULES) $(LIBSYSTEMD_LIBS)
498 ## FORCE it so that admin/unidata can decide whether these files
499 ## are up-to-date. Although since charprop depends on bootstrap-emacs,
500 ## and emacs (which recreates bootstrap-emacs) depends on charprop,
501 ## in practice this rule was always run anyway.
502 $(srcdir)/macuvs.h $(lispsource)/international/charprop.el: \
503 bootstrap-emacs$(EXEEXT) FORCE
504 $(MAKE) -C ../admin/unidata all EMACS="../$(bootstrap_exe)"
506 ## We require charprop.el to exist before ucs-normalize.el is
507 ## byte-compiled, because ucs-normalize.el needs to load 2 uni-*.el files.
508 ## And ns-win requires ucs-normalize.
509 $(lispsource)/international/ucs-normalize.elc $(lispsource)/term/ns-win.elc: | \
510 $(lispsource)/international/charprop.el
512 lispintdir = ${lispsource}/international
513 ${lispintdir}/cp51932.el ${lispintdir}/eucjp-ms.el: FORCE
514 ${MAKE} -C ../admin/charsets $(notdir $@)
516 charsets = ${top_srcdir}/admin/charsets/charsets.stamp
517 ${charsets}: FORCE
518 ${MAKE} -C ../admin/charsets all
520 charscript = ${lispintdir}/charscript.el
521 ${charscript}: FORCE
522 $(MAKE) -C ../admin/unidata $(notdir $@)
524 ${lispintdir}/characters.elc: ${charscript:.el=.elc}
526 ## The dumped Emacs is as functional and more efficient than
527 ## bootstrap-emacs, so we replace the latter with the former.
528 ## Strictly speaking, emacs does not depend directly on all of $lisp,
529 ## since not all pieces are used on all platforms. But DOC depends
530 ## on all of $lisp, and emacs depends on DOC, so it is ok to use $lisp here.
531 emacs$(EXEEXT): temacs$(EXEEXT) \
532 lisp.mk $(etc)/DOC $(lisp) \
533 $(lispsource)/international/charprop.el ${charsets}
534 ifeq ($(CANNOT_DUMP),yes)
535 ln -f temacs$(EXEEXT) $@
536 else
537 LC_ALL=C $(RUN_TEMACS) -batch $(BUILD_DETAILS) -l loadup dump
538 ifneq ($(PAXCTL_dumped),)
539 $(PAXCTL_dumped) $@
540 endif
541 ln -f $@ bootstrap-emacs$(EXEEXT)
542 endif
544 ## We run make-docfile twice because the command line may get too long
545 ## on some systems. Unfortunately, no-one has any idea
546 ## exactly how long the maximum safe command line length is on all the
547 ## various systems that Emacs supports.
549 ## $(SOME_MACHINE_OBJECTS) comes before $(obj) because some files may
550 ## or may not be included in $(obj), but they are always included in
551 ## $(SOME_MACHINE_OBJECTS). Since a file is processed when it is mentioned
552 ## for the first time, this prevents any variation between configurations
553 ## in the contents of the DOC file.
555 $(etc)/DOC: lisp.mk $(libsrc)/make-docfile$(EXEEXT) $(obj) $(lisp)
556 $(AM_V_GEN)$(MKDIR_P) $(etc)
557 -$(AM_V_at)rm -f $(etc)/DOC
558 $(AM_V_at)$(libsrc)/make-docfile -d $(srcdir) \
559 $(SOME_MACHINE_OBJECTS) $(obj) > $(etc)/DOC
560 $(AM_V_at)$(libsrc)/make-docfile -a $(etc)/DOC -d $(lispsource) \
561 $(shortlisp)
563 $(libsrc)/make-docfile$(EXEEXT): $(lib)/libgnu.a
564 $(MAKE) -C $(libsrc) make-docfile$(EXEEXT)
566 buildobj.h: Makefile
567 $(AM_V_GEN)for i in $(ALLOBJS); do \
568 echo "$$i" | sed 's,.*/,,; s/\.obj$$/\.o/; s/^/"/; s/$$/",/' \
569 || exit; \
570 done >$@.tmp
571 $(AM_V_at)mv $@.tmp $@
573 GLOBAL_SOURCES = $(base_obj:.o=.c) $(NS_OBJC_OBJ:.o=.m)
575 AM_V_GLOBALS = $(am__v_GLOBALS_@AM_V@)
576 am__v_GLOBALS_ = $(am__v_GLOBALS_@AM_DEFAULT_V@)
577 am__v_GLOBALS_0 = @echo " GEN " globals.h;
578 am__v_GLOBALS_1 =
580 gl-stamp: $(libsrc)/make-docfile$(EXEEXT) $(GLOBAL_SOURCES)
581 $(AM_V_GLOBALS)$(libsrc)/make-docfile -d $(srcdir) -g $(obj) > globals.tmp
582 $(AM_V_at)$(top_srcdir)/build-aux/move-if-change globals.tmp globals.h
583 $(AM_V_at)echo timestamp > $@
585 globals.h: gl-stamp; @true
587 $(ALLOBJS): globals.h
589 LIBEGNU_ARCHIVE = $(lib)/lib$(if $(HYBRID_MALLOC),e)gnu.a
591 $(LIBEGNU_ARCHIVE): $(config_h)
592 $(MAKE) -C $(lib) all
594 ## We have to create $(etc) here because init_cmdargs tests its
595 ## existence when setting Vinstallation_directory (FIXME?).
596 ## This goes on to affect various things, and the emacs binary fails
597 ## to start if Vinstallation_directory has the wrong value.
598 temacs$(EXEEXT): $(LIBXMENU) $(ALLOBJS) \
599 $(LIBEGNU_ARCHIVE) $(EMACSRES) ${charsets} ${charscript}
600 $(AM_V_CCLD)$(CC) $(ALL_CFLAGS) $(TEMACS_LDFLAGS) $(LDFLAGS) \
601 -o temacs $(ALLOBJS) $(LIBEGNU_ARCHIVE) $(W32_RES_LINK) $(LIBES)
602 $(MKDIR_P) $(etc)
603 ifneq ($(CANNOT_DUMP),yes)
604 ifneq ($(PAXCTL_notdumped),)
605 $(PAXCTL_notdumped) $@
606 endif
607 endif
609 ## The following oldxmenu-related rules are only (possibly) used if
610 ## HAVE_X11 && !USE_GTK, but there is no harm in always defining them.
611 $(lwlibdir)/liblw.a: $(config_h) globals.h lisp.h FORCE
612 $(MAKE) -C $(lwlibdir) liblw.a
613 $(oldXMenudir)/libXMenu11.a: FORCE
614 $(MAKE) -C $(oldXMenudir) libXMenu11.a
615 FORCE:
616 .PHONY: FORCE
618 .PRECIOUS: ../config.status Makefile
619 ../config.status: $(top_srcdir)/configure.ac $(top_srcdir)/m4/*.m4
620 $(MAKE) -C .. $(notdir $@)
621 Makefile: ../config.status $(srcdir)/Makefile.in
622 $(MAKE) -C .. src/$@
624 doc.o: buildobj.h
626 emacs.res: FORCE
627 $(MAKE) -C ../nt ../src/emacs.res
629 .PHONY: ns-app
630 ns-app: emacs$(EXEEXT)
631 $(MAKE) -C ../nextstep all
633 .PHONY: mostlyclean clean bootstrap-clean distclean maintainer-clean
634 .PHONY: versionclean extraclean
636 mostlyclean:
637 rm -f temacs$(EXEEXT) core *.core \#* *.o
638 rm -f ../etc/DOC
639 rm -f bootstrap-emacs$(EXEEXT) emacs-$(version)$(EXEEXT)
640 rm -f buildobj.h
641 rm -f globals.h gl-stamp
642 rm -f *.res *.tmp
643 clean: mostlyclean
644 rm -f emacs-*.*.*[0-9]$(EXEEXT) emacs$(EXEEXT) $(DEPDIR)/*
646 ## bootstrap-clean is used to clean up just before a bootstrap.
647 ## It should remove all files generated during a compilation/bootstrap,
648 ## but not things like config.status or TAGS.
649 bootstrap-clean: clean
650 rm -f emacs-module.h epaths.h config.h config.stamp
651 if test -f ./.gdbinit; then \
652 mv ./.gdbinit ./.gdbinit.save; \
653 if test -f "$(srcdir)/.gdbinit"; then rm -f ./.gdbinit.save; \
654 else mv ./.gdbinit.save ./.gdbinit; fi; \
657 distclean: bootstrap-clean
658 rm -f Makefile lisp.mk
659 rm -fr $(DEPDIR)
661 maintainer-clean: distclean
662 rm -f TAGS
663 versionclean:
664 -rm -f emacs$(EXEEXT) emacs-*.*.*[0-9]$(EXEEXT) ../etc/DOC*
665 extraclean: distclean
666 -rm -f *~ \#*
669 ETAGS = ../lib-src/etags${EXEEXT}
671 ${ETAGS}: FORCE
672 ${MAKE} -C ../lib-src $(notdir $@)
674 ctagsfiles1 = $(wildcard ${srcdir}/*.[hc])
675 ctagsfiles2 = $(wildcard ${srcdir}/*.m)
677 ## In out-of-tree builds, TAGS are generated in the build dir, like
678 ## other non-bootstrap build products (see Bug#31744).
680 ## This does not need to depend on ../lisp and ../lwlib TAGS files,
681 ## because etags "--include" only includes a pointer to the file,
682 ## rather than the file contents.
683 TAGS: ${ETAGS} $(ctagsfiles1) $(ctagsfiles2)
684 $(AM_V_GEN)${ETAGS} --include=../lisp/TAGS --include=$(lwlibdir)/TAGS \
685 --regex='{c}/[ ]*DEFVAR_[A-Z_ (]+"\([^"]+\)"/\1/' \
686 --regex='{c}/[ ]*DEFVAR_[A-Z_ (]+"[^"]+",[ ]\([A-Za-z0-9_]+\)/\1/' \
687 $(ctagsfiles1) \
688 --regex='{objc}/[ ]*DEFVAR_[A-Z_ (]+"\([^"]+\)"/\1/' \
689 --regex='{objc}/[ ]*DEFVAR_[A-Z_ (]+"[^"]+",[ ]\([A-Za-z0-9_]+\)/\1/' \
690 $(ctagsfiles2)
692 ## Arrange to make tags tables for ../lisp and ../lwlib,
693 ## which the above TAGS file for the C files includes by reference.
694 ../lisp/TAGS: FORCE
695 $(MAKE) -C ../lisp TAGS ETAGS="$(ETAGS)"
697 $(lwlibdir)/TAGS: FORCE
698 $(MAKE) -C $(lwlibdir) TAGS ETAGS="$(ETAGS)"
700 tags: TAGS ../lisp/TAGS $(lwlibdir)/TAGS
701 .PHONY: tags
704 ### Bootstrapping.
706 ## Bootstrapping right is difficult because of the circular dependencies.
707 ## Furthermore, we have to deal with the fact that many compilation targets
708 ## such as loaddefs.el or *.elc can typically be produced by any old
709 ## Emacs executable, so we would like to avoid rebuilding them whenever
710 ## we build a new Emacs executable.
712 ## (In other words, changing a single file src/foo.c would force
713 ## dumping a new bootstrap-emacs, then re-byte-compiling all preloaded
714 ## elisp files, and only then dump the actual src/emacs, which is not
715 ## wrong, but is overkill in 99.99% of the cases.)
717 ## To solve the circularity, we use 2 different Emacs executables,
718 ## "emacs" is the main target and "bootstrap-emacs" is the one used
719 ## to build the *.elc and loaddefs.el files.
720 ## To solve the freshness issue, in the past we tried various clever tricks,
721 ## but now that we require GNU make, we can simply specify
722 ## bootstrap-emacs$(EXEEXT) as an order-only prerequisite.
724 %.elc: %.el | bootstrap-emacs$(EXEEXT)
725 @$(MAKE) -C ../lisp EMACS="$(bootstrap_exe)" THEFILE=$< $<c
727 ## VCSWITNESS points to the file that holds info about the current checkout.
728 ## We use it as a heuristic to decide when to rebuild loaddefs.el.
729 ## If empty it is ignored; the parent makefile can set it to some other value.
730 VCSWITNESS =
732 $(lispsource)/loaddefs.el: $(VCSWITNESS) | bootstrap-emacs$(EXEEXT)
733 $(MAKE) -C ../lisp autoloads EMACS="$(bootstrap_exe)"
735 ## Dump an Emacs executable named bootstrap-emacs containing the
736 ## files from loadup.el in source form.
737 bootstrap-emacs$(EXEEXT): temacs$(EXEEXT)
738 $(MAKE) -C ../lisp update-subdirs
739 ifeq ($(CANNOT_DUMP),yes)
740 ln -f temacs$(EXEEXT) $@
741 else
742 $(RUN_TEMACS) --batch $(BUILD_DETAILS) --load loadup bootstrap
743 ifneq ($(PAXCTL_dumped),)
744 $(PAXCTL_dumped) emacs$(EXEEXT)
745 endif
746 mv -f emacs$(EXEEXT) $@
747 endif
748 @: Compile some files earlier to speed up further compilation.
749 $(MAKE) -C ../lisp compile-first EMACS="$(bootstrap_exe)"