1 # DIST: This is the distribution Makefile for Emacs. configure can
2 # DIST: make most of the changes to this file you might want, so try
5 # Copyright (C) 1992-2013 Free Software Foundation, Inc.
7 # This file is part of GNU Emacs.
9 # GNU Emacs is free software: you can redistribute it and/or modify
10 # it under the terms of the GNU General Public License as published by
11 # the Free Software Foundation, either version 3 of the License, or
12 # (at your option) any later version.
14 # GNU Emacs is distributed in the hope that it will be useful,
15 # but WITHOUT ANY WARRANTY; without even the implied warranty of
16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 # GNU General Public License for more details.
19 # You should have received a copy of the GNU General Public License
20 # along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
24 # make all to compile and build Emacs.
25 # make install to install it.
26 # make TAGS to update tags tables.
28 # make clean or make mostlyclean
29 # Delete all files from the current directory that are normally
30 # created by building the program. Don't delete the files that
31 # record the configuration. Also preserve files that could be made
32 # by building, but normally aren't because the distribution comes
35 # Delete `.dvi' files here if they are not part of the distribution.
38 # Delete all files from the current directory that are created by
39 # configuring or building the program. If you have unpacked the
40 # source and built the program without creating any other files,
41 # `make distclean' should leave only the files that were in the
44 # make maintainer-clean
45 # Delete everything from the current directory that can be
46 # reconstructed with this Makefile. This typically includes
47 # everything deleted by distclean, plus more: .elc files,
48 # C source files produced by Bison, tags tables, info files,
52 # Still more severe - delete backup and autosave files, too.
55 # Removes all the compiled files to force a new bootstrap from a
56 # clean slate, and then build in the normal way.
59 # Make Emacs documentation files from their sources; requires makeinfo.
63 # This may not work with certain non-GNU make's. It only matters when
64 # inheriting a CDPATH not starting with the current directory.
67 # If Make doesn't predefine MAKE, set it here.
70 # Prevent submakes from outputting "Entering directory ..." and
71 # "Leaving directory..." diagnostics that would mess up 'make echo-info'.
72 QUIET_SUBMAKE
= MAKELEVEL
=0
74 # ==================== Things `configure' Might Edit ====================
76 cache_file
= @cache_file@
77 CONFIGURE_FLAGS
= --cache-file
=$(cache_file
)
85 ### These help us choose version- and architecture-specific directories
86 ### to install files in.
88 ### This should be the number of the Emacs version we're building,
89 ### like `18.59' or `19.0'.
92 ### This should be the name of the configuration we're building Emacs
93 ### for, like `mips-dec-ultrix' or `sparc-sun-sunos'.
94 configuration
=@configuration@
96 ### The nt/ subdirectory gets built only for MinGW
99 # ==================== Where To Install Things ====================
101 # Location to install Emacs.app under GNUstep / Mac OS X.
102 # Later values may use these.
103 ns_appbindir
=@ns_appbindir@
104 ns_appresdir
=@ns_appresdir@
105 # Either yes or no depending on whether this is a relocatable Emacs.app.
106 ns_self_contained
=@ns_self_contained@
108 # The default location for installation. Everything is placed in
109 # subdirectories of this directory. The default values for many of
110 # the variables below are expressed in terms of this one, so you may
111 # not need to change them. This defaults to /usr/local.
114 # Like `prefix', but used for architecture-specific files.
115 exec_prefix=@
exec_prefix@
117 # Where to install Emacs and other binaries that people will want to
118 # run directly (like etags).
121 # The root of the directory tree for read-only architecture-independent
122 # data files. ${datadir}, ${infodir} and ${mandir} are based on this.
123 datarootdir
=@datarootdir@
125 # Where to install architecture-independent data files. ${lispdir}
126 # and ${etcdir} are subdirectories of this.
129 # Where to install and expect the files that Emacs modifies as it
130 # runs. These files are all architecture-independent.
131 # Right now, this is not used.
132 sharedstatedir
=@sharedstatedir@
134 # Where to install and expect executable files to be run by Emacs
135 # rather than directly by users (and other architecture-dependent
136 # data, although Emacs does not have any). The executables
137 # are actually installed in ${archlibdir}, which is (normally)
138 # a subdirectory of this.
139 libexecdir
=@libexecdir@
141 # Where to install Emacs's man pages.
142 # Note they contain cross-references that expect them to be in section 1.
144 man1dir=$(mandir)/man1
146 # Where to install and expect the info files describing Emacs.
148 # Info files not in the doc/misc directory (we get those via make echo-info).
150 INFO_NONMISC
=emacs
$(INFO_EXT
) eintr
$(INFO_EXT
) elisp
$(INFO_EXT
)
152 # If no makeinfo was found and configured --without-makeinfo, "no"; else "yes".
153 HAVE_MAKEINFO
=@HAVE_MAKEINFO@
155 # Directory for local state files for all programs.
156 localstatedir
=@localstatedir@
158 # Where to look for bitmap files.
159 bitmapdir
=@bitmapdir@
161 # Where to find the source code. The source code for Emacs's C kernel is
162 # expected to be in ${srcdir}/src, and the source code for Emacs's
163 # utility programs is expected to be in ${srcdir}/lib-src. This is
164 # set by the configure script's `--srcdir' option.
166 # We use $(srcdir) explicitly in dependencies so as not to depend on VPATH.
169 # Where the manpage source files are kept.
170 mansrcdir
=$(srcdir)/doc
/man
172 # Tell make where to find source files; this is needed for the makefiles.
175 # Where to find the application default.
176 x_default_search_path
=@x_default_search_path@
178 # Where the etc/emacs.desktop file is to be installed.
179 desktopdir
=$(datarootdir
)/applications
181 # Where the etc/images/icons/hicolor directory is to be installed.
182 icondir
=$(datarootdir
)/icons
184 # The source directory for the icon files.
185 iconsrcdir
=$(srcdir)/etc
/images
/icons
187 # ==================== Emacs-specific directories ====================
189 # These variables hold the values Emacs will actually use. They are
190 # based on the values of the standard Make variables above.
192 # Where to install the lisp, leim files distributed with
193 # Emacs. This includes the Emacs version, so that the
194 # lisp files for different versions of Emacs will install
195 # themselves in separate directories.
199 # Directories Emacs should search for standard lisp files.
200 # The default is ${lispdir}:${leimdir}.
201 standardlisppath
=@standardlisppath@
203 # Directories Emacs should search for lisp files specific to this
204 # site (i.e. customizations), before consulting ${standardlisppath}.
205 # This should be a colon-separated list of directories.
206 locallisppath
=@locallisppath@
208 # Where Emacs will search to find its lisp files. Before
209 # changing this, check to see if your purpose wouldn't
210 # better be served by changing locallisppath. This
211 # should be a colon-separated list of directories.
212 # The default is ${locallisppath}:${standardlisppath}.
215 # Where Emacs will search for its lisp files while
216 # building. This is only used during the process of
217 # compiling Emacs, to help Emacs find its lisp files
218 # before they've been installed in their final location.
219 # This should be a colon-separated list of directories.
220 # Normally it points to the lisp/ directory in the sources.
221 buildlisppath
=${srcdir}/lisp
223 # Where to install the other architecture-independent
224 # data files distributed with Emacs (like the tutorial,
225 # the cookie recipes and the Zippy database). This path
226 # usually contains the Emacs version number, so the data
227 # files for multiple versions of Emacs may be installed
231 # Where to put executables to be run by Emacs rather than
232 # the user. This path usually includes the Emacs version
233 # and configuration name, so that multiple configurations
234 # for multiple versions of Emacs may be installed at
236 archlibdir
=@archlibdir@
238 # Where to put the docstring file.
241 # Where to install Emacs game score files.
244 # ==================== Utility Programs for the Build ====================
246 # Allow the user to specify the install program.
247 # Note that if the system does not provide a suitable install,
248 # configure will use build-aux/install-sh. Annoyingly, it does
249 # not use an absolute path. So we must take care to always run
250 # INSTALL-type commands from the directory containing the Makefile.
251 # This explains (I think) the cd thisdir seen in several install rules.
253 INSTALL_PROGRAM
= @INSTALL_PROGRAM@
254 INSTALL_DATA
= @INSTALL_DATA@
255 INSTALL_INFO
= @INSTALL_INFO@
256 # By default, we uphold the dignity of our programs.
259 # Create a link to a file in the same directory as the target.
260 LN_S_FILEONLY
= @LN_S_FILEONLY@
262 # We use gzip to compress installed .el files.
263 GZIP_PROG
= @GZIP_PROG@
264 # If non-nil, gzip the installed Info and man pages.
265 GZIP_INFO
= @GZIP_INFO@
267 # ============================= Targets ==============================
269 # Program name transformation.
270 TRANSFORM
= @program_transform_name@
272 # What emacs should be called when installed.
273 EMACS_NAME
= `echo emacs | sed '$(TRANSFORM)'`
274 EMACS
= ${EMACS_NAME}${EXEEXT}
275 EMACSFULL
= `echo emacs-${version} | sed '$(TRANSFORM)'`${EXEEXT}
277 # Subdirectories to make recursively.
278 SUBDIR
= $(NTDIR
) lib lib-src src lisp leim
280 # The subdir makefiles created by config.status.
281 SUBDIR_MAKEFILES_IN
= @SUBDIR_MAKEFILES_IN@
282 SUBDIR_MAKEFILES
= `echo $(SUBDIR_MAKEFILES_IN:.in=) | sed 's|$(srcdir)/||g'`
284 # Subdirectories to install, and where they'll go. lib-src's and nt's
285 # makefiles know how to install them, so we don't do that here.
286 # Directories that cannot simply be copied, eg info, are treated
287 # separately. quail appears twice because in out-of-tree builds, it
289 COPYDIR
= ${srcdir}/etc
${srcdir}/lisp
${srcdir}/leim
/ja-dic
${srcdir}/leim
/quail leim
/quail
290 COPYDESTS
= $(DESTDIR
)${etcdir} $(DESTDIR
)${lispdir} $(DESTDIR
)${leimdir}/ja-dic
$(DESTDIR
)${leimdir}/quail
$(DESTDIR
)${leimdir}/quail
294 .PHONY
: all ${SUBDIR} blessmail epaths-force epaths-force-w32 FRC
296 removenullpaths
=sed
-e
's/^:*//' -e
's/:*$$//g' -e
's/::*/:/g'
298 # Generate epaths.h from epaths.in. This target is invoked by `configure'.
299 # See comments in configure.ac for why it is done this way, as opposed
300 # to just letting configure generate epaths.h from epaths.in in a
301 # similar way to how Makefile is made from Makefile.in.
303 @
(standardlisppath
=`echo "${standardlisppath}" | ${removenullpaths}` ; \
304 locallisppath
=`echo "${locallisppath}" | ${removenullpaths}` ; \
305 buildlisppath
=`echo "${buildlisppath}" | ${removenullpaths}` ; \
306 x_default_search_path
=`echo ${x_default_search_path}`; \
307 gamedir
=`echo ${gamedir}`; \
308 sed
< ${srcdir}/src
/epaths.in
> epaths.h.
$$$$ \
309 -e
's;\(#.*PATH_LOADSEARCH\).*$$;\1 "'"$${standardlisppath}"'";' \
310 -e
's;\(#.*PATH_SITELOADSEARCH\).*$$;\1 "'"$${locallisppath}"'";' \
311 -e
's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "'"$${buildlisppath}"'";' \
312 -e
's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";' \
313 -e
's;\(#.*PATH_INFO\).*$$;\1 "${infodir}";' \
314 -e
's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";' \
315 -e
's;\(#.*PATH_BITMAPS\).*$$;\1 "${bitmapdir}";' \
316 -e
's;\(#.*PATH_X_DEFAULTS\).*$$;\1 "${x_default_search_path}";' \
317 -e
's;\(#.*PATH_GAME\).*$$;\1 "${gamedir}";' \
318 -e
's;\(#.*PATH_DOC\).*$$;\1 "${docdir}";') && \
319 ${srcdir}/build-aux
/move-if-change epaths.h.
$$$$ src
/epaths.h
321 # Convert MSYS-style /x/foo or Windows-style x:\foo file names
322 # into x:/foo that Windows can grok.
323 msys_to_w32
=sed
-e
's,\\\\,/,g' -e
's,^/\([A-Za-z]\)/,\1:/,'
325 # Transform directory search path and its components. Original can
326 # be MSYS or Windows style. Set path separator to ";", directory
327 # separator to "/" and transform MSYS-style "/c/" to "c:/".
328 # Remove empty path components and escape semicolons.
329 msys_lisppath_to_w32
=sed
-e
's,\\\\,/,g' \
330 -e
's,\(^\|[:;]\)\([A-Za-z]\):/,\1/\2/,g' \
331 -e
's/:/;/g' -e
's,\(^\|;\)/\([A-Za-z]\)/,\1\2:/,g' \
332 -e
's/;\+/;/g' -e
's/^;//' -e
's/;$$//' -e
's/;/\\\\;/g'
334 # Replace "${prefix}" with '%emacs_dir%' (which expands to install
335 # directory at runtime).
336 msys_prefix_subst
=sed
-e
's!\(^\|;\)'"$${prefixpattern}"'\([;/]\|$$\)!\1%emacs_dir%\2!g'
338 # Quote Sed special characters (except backslash and newline) with
339 # a double backslash.
340 msys_sed_sh_escape
=sed
-e
's/[];$$*.^[]/\\\\&/g'
342 # The w32 build needs a slightly different editing, and it uses
343 # nt/epaths.nt as the template.
344 # Use the value of ${locallisppath} supplied by `configure',
345 # to support the --enable-locallisppath argument.
346 epaths-force-w32
: FRC
347 @
(w32srcdir
=`echo "${srcdir}" | ${msys_to_w32}` ; \
348 prefixpattern
=`echo '${prefix}' | ${msys_to_w32} | ${msys_sed_sh_escape}` ; \
349 locallisppath
=`echo '${locallisppath}' | ${msys_lisppath_to_w32} | ${msys_prefix_subst}` ; \
350 sed
< ${srcdir}/nt
/epaths.nt
> epaths.h.
$$$$ \
351 -e
's;\(#.*PATH_SITELOADSEARCH\).*$$;\1 "'"$${locallisppath}"'";' \
352 -e
'/^.*#/s/@VER@/${version}/g' \
353 -e
'/^.*#/s/@CFG@/${configuration}/g' \
354 -e
"/^.*#/s|@SRC@|$${w32srcdir}|g") && \
355 ${srcdir}/build-aux
/move-if-change epaths.h.
$$$$ src
/epaths.h
357 lib-src src
: $(NTDIR
) lib
361 # We need to build `emacs' in `src' to compile the *.elc files in `lisp'
365 # These targets should be "${SUBDIR} without `src'".
366 lib lib-src lisp leim nt
: Makefile FRC
367 cd
$@
&& $(MAKE
) all $(MFLAGS
) \
368 CC
='${CC}' CFLAGS
='${CFLAGS}' CPPFLAGS
='${CPPFLAGS}' \
369 LDFLAGS
='${LDFLAGS}' MAKE
='${MAKE}'
371 # Pass to src/Makefile.in an additional BOOTSTRAPEMACS variable which
372 # is either set to bootstrap-emacs (in case bootstrap-emacs has not been
373 # constructed yet) or the empty string (otherwise).
374 # src/Makefile.in uses it to implement conditional dependencies, so that
375 # files that need bootstrap-emacs to be built do not additionally need
376 # to be kept fresher than bootstrap-emacs. Otherwise changing a single
377 # file src/foo.c forces dumping a new bootstrap-emacs, then re-byte-compiling
378 # all preloaded elisp files, and only then dump the actual src/emacs, which
379 # is not wrong, but is overkill in 99.99% of the cases.
381 boot
=bootstrap-emacs
$(EXEEXT
); \
382 if
[ ! -x
"src/$$boot" ]; then \
383 cd
$@
; $(MAKE
) all $(MFLAGS
) \
384 CC
='${CC}' CFLAGS
='${CFLAGS}' CPPFLAGS
='${CPPFLAGS}' \
385 LDFLAGS
='${LDFLAGS}' MAKE
='${MAKE}' BOOTSTRAPEMACS
="$$boot"; \
387 if
[ -r .bzr
/checkout
/dirstate
]; then \
388 vcswitness
="`pwd`/.bzr/checkout/dirstate"; \
390 cd
$@
; $(MAKE
) all $(MFLAGS
) \
391 CC
='${CC}' CFLAGS
='${CFLAGS}' CPPFLAGS
='${CPPFLAGS}' \
392 LDFLAGS
='${LDFLAGS}' MAKE
='${MAKE}' BOOTSTRAPEMACS
="" \
393 VCSWITNESS
="$$vcswitness"
395 blessmail
: Makefile src FRC
396 cd lib-src
&& $(MAKE
) maybe-blessmail
$(MFLAGS
) \
397 MAKE
='${MAKE}' archlibdir
='$(archlibdir)'
399 # We used to have one rule per */Makefile.in, but that leads to race
400 # conditions with parallel makes, so let's assume that the time stamp on
401 # ./Makefile is representative of the time stamp on all the other Makefiles.
403 # config.status overrides MAKEFILE_NAME with a bogus name when creating
404 # src/epaths.h, so that 'make epaths-force' does not recursively invoke
405 # config.status and overwrite config.status while executing it (Bug#11214).
407 # 'make bootstrap' overrides MAKEFILE_NAME to a nonexistent file but
408 # then attempts to build that file. This forces 'Makefile', 'lib/Makefile',
409 # etc. to be built without running into similar recursion problems.
410 MAKEFILE_NAME
= Makefile
411 $(MAKEFILE_NAME
): config.status
$(srcdir)/src
/config.in \
412 $(srcdir)/Makefile.in
$(SUBDIR_MAKEFILES_IN
) $(srcdir)/src
/lisp.mk
413 MAKE
='$(MAKE)' .
/config.status
415 # Don't erase these files if make is interrupted while refreshing them.
416 .PRECIOUS
: Makefile config.status
418 config.status
: ${srcdir}/configure
${srcdir}/lisp
/version.el
419 if
[ -x .
/config.status
]; then \
420 $(CFG
) .
/config.status
--recheck
; \
422 $(CFG
) $(srcdir)/configure
$(CONFIGURE_FLAGS
); \
425 AUTOCONF_INPUTS
= $(srcdir)/configure.ac
$(srcdir)/aclocal.m4
427 $(srcdir)/configure
: $(AUTOCONF_INPUTS
)
428 cd
${srcdir} && autoconf
430 ACLOCAL_INPUTS
= $(srcdir)/m4
/gnulib-comp.m4
431 $(srcdir)/aclocal.m4
: $(ACLOCAL_INPUTS
)
432 cd
$(srcdir) && aclocal
-I m4
434 AUTOMAKE_INPUTS
= $(srcdir)/aclocal.m4
$(srcdir)/lib
/Makefile.am \
435 $(srcdir)/lib
/gnulib.mk
436 $(srcdir)/lib
/Makefile.in
: $(AUTOMAKE_INPUTS
)
437 cd
$(srcdir) && automake
--gnu
-a
-c lib
/Makefile
439 # Regenerate files that this makefile would have made, if this makefile
440 # had been built by Automake. The name 'am--refresh' is for
441 # compatibility with subsidiary Automake-generated makefiles.
442 am--refresh
: $(srcdir)/aclocal.m4
$(srcdir)/configure
$(srcdir)/src
/config.in
445 $(srcdir)/src
/config.in
: $(srcdir)/src
/stamp-h.in
446 @
# Usually, there's no need to rebuild src/config.in just
447 @
# because stamp-h.in has changed (since building stamp-h.in
448 @
# refreshes config.in as well), but if config.in is missing
449 @
# then we really need to do something more.
450 [ -r
"$@" ] ||
( cd
${srcdir} && autoheader
)
451 $(srcdir)/src
/stamp-h.in
: $(AUTOCONF_INPUTS
)
452 cd
${srcdir} && autoheader
453 rm -f
$(srcdir)/src
/stamp-h.in
454 echo timestamp
> $(srcdir)/src
/stamp-h.in
456 # ==================== Installation ====================
458 .PHONY
: install install-arch-dep install-arch-indep install-doc install-info
459 .PHONY
: install-man install-etc install-strip install-
$(NTDIR
)
460 .PHONY
: uninstall uninstall-
$(NTDIR
)
462 ## If we let lib-src do its own installation, that means we
463 ## don't have to duplicate the list of utilities to install in
464 ## this Makefile as well.
466 install: all install-arch-indep install-doc install-arch-dep install-
$(NTDIR
) blessmail
469 ## Ensure that $subdir contains a subdirs.el file.
470 ## Here and elsewhere, we set the umask so that any created files are
472 ## TODO it might be good to warn about non-standard permissions of
473 ## pre-existing directories, but that does not seem easy.
474 write_subdir
=if
[ -f
$${subdir}/subdirs.el
]; \
478 ${MKDIR_P} $${subdir}; \
479 (echo
"(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
480 echo
" (normal-top-level-add-subdirs-to-load-path))") \
481 > $${subdir}/subdirs.el
; \
484 ### Install the executables that were compiled specifically for this machine.
485 ### We do install-arch-indep first because the executable needs the
486 ### Lisp files and DOC file to work properly.
487 install-arch-dep
: src install-arch-indep install-doc install-
$(NTDIR
)
488 umask
022; ${MKDIR_P} $(DESTDIR
)${bindir}
490 $(MAKE
) install $(MFLAGS
) prefix=${prefix} \
491 exec_prefix=${exec_prefix} bindir=${bindir} \
492 libexecdir
=${libexecdir} archlibdir
=${archlibdir} \
493 INSTALL_STRIP
=${INSTALL_STRIP}
494 if
test "${ns_self_contained}" = "no"; then \
495 ${INSTALL_PROGRAM} $(INSTALL_STRIP
) src
/emacs
${EXEEXT} $(DESTDIR
)${bindir}/$(EMACSFULL
) || exit
1 ; \
496 chmod
1755 $(DESTDIR
)${bindir}/$(EMACSFULL
) || true
; \
497 if
test "x${NO_BIN_LINK}" = x
; then \
498 rm -f
$(DESTDIR
)${bindir}/$(EMACS
) ; \
499 cd
$(DESTDIR
)${bindir} && $(LN_S_FILEONLY
) $(EMACSFULL
) $(EMACS
); \
502 subdir
=${ns_appresdir}/site-lisp
; \
503 ${write_subdir} || exit
1; \
504 rm -rf
${ns_appresdir}/share
; \
507 ### Windows-specific install target for installing programs produced
508 ### in nt/, and its Posix do-nothing shadow.
512 $(MAKE
) install $(MFLAGS
) prefix=${prefix} \
513 exec_prefix=${exec_prefix} bindir=${bindir} \
514 libexecdir
=${libexecdir} archlibdir
=${archlibdir} \
515 INSTALL_STRIP
=${INSTALL_STRIP}
517 ## In the share directory, we are deleting:
518 ## applications (with emacs.desktop, also found in etc/)
519 ## emacs (basically empty except for unneeded site-lisp directories)
520 ## icons (duplicates etc/images/icons/hicolor)
522 ## This is install-etc for everything except self-contained-ns builds.
523 ## For them, it is empty.
524 INSTALL_ARCH_INDEP_EXTRA
= @INSTALL_ARCH_INDEP_EXTRA@
526 ## http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg01672.html
527 ## Needs to be the user running install, so configure can't set it.
528 set_installuser
=for installuser in
$${LOGNAME} $${USERNAME} $${USER} \
529 `id -un 2> /dev/null`; do \
530 [ -n
"$${installuser}" ] && break
; \
533 ### Install the files that are machine-independent.
534 ### Most of them come straight from the distribution; the exception is
535 ### the DOC file, which is copied from the build directory.
537 ## We delete each directory in ${COPYDESTS} before we copy into it;
538 ## that way, we can reinstall over directories that have been put in
539 ## place with their files read-only (perhaps because they are checked
540 ## into RCS). In order to make this safe, we make sure that the
541 ## source exists and is distinct from the destination.
543 ## We delete etc/DOC* because there may be irrelevant DOC files from
544 ## other builds in the source directory. This is ok because we just
545 ## deleted the entire installed etc/ directory and recreated it.
546 ## install-doc installs the relevant DOC.
548 ## Note that the Makefiles in the etc directory are potentially useful
549 ## in an installed Emacs, so should not be excluded.
551 ## We used to create locallisppath, but if it points to non-standard
552 ## locations, is not really Emacs's job to create these directories,
553 ## so it is no longer done.
555 ## Note that we use tar instead of plain old cp -R/-r because the latter
556 ## is apparently not portable (even in 2012!).
557 ## http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00278.html
558 ## I have no idea which platforms Emacs supports where cp -R does not
559 ## work correctly, and therefore no idea when tar can be replaced.
560 ## See also these comments from 2004 about cp -r working fine:
561 ## http://lists.gnu.org/archive/html/autoconf-patches/2004-11/msg00005.html
562 install-arch-indep
: lisp leim install-info install-man
${INSTALL_ARCH_INDEP_EXTRA}
563 -set
${COPYDESTS} ; \
565 $(set_installuser
); \
566 for
dir in
${COPYDIR} ; do \
567 [ -d
$${dir} ] || exit
1 ; \
570 [ `cd $${dest} && /bin/pwd` = `cd $${dir} && /bin/pwd` ] && \
572 if
[ "$${dir}" = "leim/quail" ]; then \
573 [ `cd $${dir} && /bin/pwd` = `cd ${srcdir}/leim/quail && /bin/pwd` ] && \
577 umask
022; ${MKDIR_P} $${dest} ; \
579 echo
"Copying $${dir} to $${dest}..." ; \
580 (cd
$${dir}; tar -chf
- .
) \
581 |
(cd
$${dest}; umask
022; \
582 tar -xvf
- && cat
> /dev
/null
) || exit
1; \
583 [ "$${dir}" != "${srcdir}/etc" ] ||
rm -f
$${dest}/DOC
* ; \
584 for subdir in
`find $${dest} -type d -print` ; do \
585 chmod a
+rx
$${subdir} ; \
586 rm -f
$${subdir}/.gitignore
; \
587 rm -f
$${subdir}/.arch-inventory
; \
588 rm -f
$${subdir}/.DS_Store
; \
589 rm -f
$${subdir}/\
#* ; \
590 rm -f
$${subdir}/.\
#* ; \
591 rm -f
$${subdir}/*~
; \
592 rm -f
$${subdir}/*.orig
; \
593 rm -f
$${subdir}/ChangeLog
* ; \
594 [ "$${dir}" != "${srcdir}/etc" ] && \
595 rm -f
$${subdir}/[mM
]akefile
*[.
-]in
$${subdir}/[mM
]akefile
; \
597 find
$${dest} -exec chown
$${installuser} {} ';' ;\
599 -rm -f
$(DESTDIR
)${leimdir}/leim-list.el
600 ${INSTALL_DATA} leim
/leim-list.el
$(DESTDIR
)${leimdir}/leim-list.el
601 -rm -f
$(DESTDIR
)${lispdir}/subdirs.el
602 umask
022; $(srcdir)/build-aux
/update-subdirs
$(DESTDIR
)${lispdir}
603 subdir
=$(DESTDIR
)${datadir}/emacs
/${version}/site-lisp
; \
605 subdir
=$(DESTDIR
)${datadir}/emacs
/site-lisp
; \
606 ${write_subdir} || true
607 [ -z
"${GZIP_PROG}" ] || \
608 ( echo
"Compressing *.el ..." ; \
610 thisdir
=`/bin/pwd`; \
611 for
dir in
$(DESTDIR
)${lispdir} $(DESTDIR
)${leimdir}; do \
613 cd
$${dir} || exit
1 ; \
614 for f in
`find . -name "*.elc" -print`; do \
615 ${GZIP_PROG} -9n
`echo $$f|sed 's/.elc$$/.el/'` ; \
618 -chmod
-R a
+r
$(DESTDIR
)${datadir}/emacs
/${version} ${COPYDESTS}
620 ## The above chmods are needed because "umask 022; tar ..." is not
621 ## guaranteed to do the right thing; eg if we are root and tar is
622 ## preserving source permissions.
624 ## Note that install-arch-indep deletes and recreates the entire
625 ## installed etc/ directory, so we need it to run before this does.
626 install-doc
: src install-arch-indep
628 umask
022; ${MKDIR_P} $(DESTDIR
)${docdir} ; \
629 if
[ `cd ./etc; /bin/pwd` != `cd $(DESTDIR)${docdir}; /bin/pwd` ]; \
632 echo
"Copying etc/$${docfile} to $(DESTDIR)${docdir} ..." ; \
633 ${INSTALL_DATA} etc
/$${docfile} $(DESTDIR
)${docdir}/$${docfile}; \
634 $(set_installuser
); \
635 chown
$${installuser} $(DESTDIR
)${docdir}/$${docfile} || true
; \
639 umask
022; ${MKDIR_P} $(DESTDIR
)${infodir}
641 thisdir
=`/bin/pwd`; \
642 [ `cd ${srcdir}/info && /bin/pwd` = `cd $(DESTDIR)${infodir} && /bin/pwd` ] || \
643 (cd
$(DESTDIR
)${infodir}; \
646 ${INSTALL_DATA} ${srcdir}/info/dir $(DESTDIR
)${infodir}/dir) ; \
647 info_misc
=`cd $${thisdir}/doc/misc && \
648 $(QUIET_SUBMAKE) $(MAKE) -s echo-info \
650 cd
${srcdir}/info ; \
651 for elt in
${INFO_NONMISC} $${info_misc}; do \
652 test "$(HAVE_MAKEINFO)" = "no" && test ! -f
$$elt && continue
; \
653 for f in
`ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
655 ${INSTALL_DATA} ${srcdir}/info/$$f $(DESTDIR
)${infodir}/$$f); \
656 ( [ -n
"${GZIP_INFO}" ] && [ -n
"${GZIP_PROG}" ] ) || continue
; \
657 rm -f
$(DESTDIR
)${infodir}/$$f.gz
; \
658 ${GZIP_PROG} -9n
$(DESTDIR
)${infodir}/$$f; \
661 ${INSTALL_INFO} --info-dir
=$(DESTDIR
)${infodir} $(DESTDIR
)${infodir}/$$elt); \
664 ## "gzip || true" is because some gzips exit with non-zero status
665 ## if compression would not reduce the file size. Eg, the gzip in
666 ## OpenBSD 4.9 seems to do this (2013/03). In Emacs, this can
667 ## only happen with the tiny ctags.1 manpage. We don't really care if
668 ## ctags.1 is compressed or not. "gzip -f" is another option here,
669 ## but not sure if portable.
671 umask
022; ${MKDIR_P} $(DESTDIR
)${man1dir}
672 thisdir
=`/bin/pwd`; \
674 for page in
*.1; do \
675 dest
=`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1; \
677 ${INSTALL_DATA} ${mansrcdir}/$${page} $(DESTDIR
)${man1dir}/$${dest}); \
678 ( [ -n
"${GZIP_INFO}" ] && [ -n
"${GZIP_PROG}" ] ) || continue
; \
679 rm -f
$(DESTDIR
)${man1dir}/$${dest}.gz
; \
680 ${GZIP_PROG} -9n
$(DESTDIR
)${man1dir}/$${dest} || true
; \
683 ## Install those items from etc/ that need to end up elsewhere.
685 ## If you prefer, choose "emacs22" at installation time.
686 ## Note: emacs22 does not have all the resolutions.
690 umask
022; ${MKDIR_P} $(DESTDIR
)${desktopdir}
691 tmp
=etc
/emacs.tmpdesktop
; rm -f
$${tmp}; \
692 emacs_name
=`echo emacs | sed '$(TRANSFORM)'`; \
693 sed
-e
"/^Exec=emacs/ s/emacs/$${emacs_name}/" \
694 -e
"/^Icon=emacs/ s/emacs/$${emacs_name}/" \
695 ${srcdir}/etc
/emacs.desktop
> $${tmp}; \
696 ${INSTALL_DATA} $${tmp} $(DESTDIR
)${desktopdir}/${EMACS_NAME}.desktop
; \
698 thisdir
=`/bin/pwd`; \
699 cd
${iconsrcdir} || exit
1; umask
022 ; \
700 for
dir in
*/*/apps
*/*/mimetypes
; do \
701 [ -d
$${dir} ] || continue
; \
702 ( cd
$${thisdir}; ${MKDIR_P} $(DESTDIR
)${icondir}/$${dir} ) ; \
703 for icon in
$${dir}/${EMACS_ICON}[.
-]*; do \
704 [ -r
$${icon} ] || continue
; \
705 ext
=`echo "$${icon}" | sed -e 's|.*\.||'`; \
706 dest
=`echo "$${icon}" | sed -e 's|.*/||' -e "s|\.$${ext}$$||" -e 's/$(EMACS_ICON)/emacs/' -e '$(TRANSFORM)'`.
$${ext} ; \
708 ${INSTALL_DATA} ${iconsrcdir}/$${icon} $(DESTDIR
)${icondir}/$${dir}/$${dest} ) \
713 ### Build Emacs and install it, stripping binaries while installing them.
715 $(MAKE
) $(MFLAGS
) INSTALL_STRIP
=-s
install
717 ### Delete all the installed files that the `install' target would
718 ### create (but not the noninstalled files such as `make all' would create).
720 ### Don't delete the lisp and etc directories if they're in the source tree.
721 uninstall: uninstall-
$(NTDIR
)
723 $(MAKE
) $(MFLAGS
) uninstall \
724 prefix=${prefix} exec_prefix=${exec_prefix} \
725 bindir=${bindir} libexecdir
=${libexecdir} archlibdir
=${archlibdir}
728 for
dir in
$(DESTDIR
)${lispdir} $(DESTDIR
)${etcdir} ; do \
729 if
[ -d
$${dir} ]; then \
730 case
`cd $${dir} ; /bin/pwd` in \
731 `cd ${srcdir} ; /bin/pwd`* ) ;; \
732 * ) rm -rf
$${dir} ;; \
735 $(DESTDIR
)${datadir}/emacs
/${version}/* ) \
736 rm -rf
$(DESTDIR
)${datadir}/emacs
/${version} \
741 -rm -rf
$(DESTDIR
)${libexecdir}/emacs
/${version}
742 thisdir
=`/bin/pwd`; \
743 (info_misc
=`cd doc/misc && $(QUIET_SUBMAKE) $(MAKE) -s echo-info`; \
744 if cd
$(DESTDIR
)${infodir}; then \
745 for elt in
${INFO_NONMISC} $${info_misc}; do \
747 $(INSTALL_INFO
) --remove
--info-dir
=$(DESTDIR
)${infodir} $(DESTDIR
)${infodir}/$$elt); \
748 if
[ -n
"${GZIP_INFO}" ] && [ -n
"${GZIP_PROG}" ]; then \
749 ext
=.gz
; else ext
=; fi
; \
750 rm -f
$$elt$$ext $$elt-[1-9]$$ext $$elt-[1-9][0-9]$$ext; \
753 (if
[ -n
"${GZIP_INFO}" ] && [ -n
"${GZIP_PROG}" ]; then \
754 ext
=.gz
; else ext
=; fi
; \
755 if cd
${mansrcdir}; then \
756 for page in
*.1; do \
757 rm -f
$(DESTDIR
)${man1dir}/`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1$$ext; done
; \
759 (cd
$(DESTDIR
)${bindir} && rm -f
$(EMACSFULL
) $(EMACS
) || true
)
760 (if cd
$(DESTDIR
)${icondir}; then \
761 rm -f hicolor
/*x
*/apps
/${EMACS_NAME}.png \
762 hicolor
/scalable
/apps
/${EMACS_NAME}.svg \
763 hicolor
/scalable
/mimetypes
/`echo emacs-document | sed '$(TRANSFORM)'`.svg
; \
765 -rm -f
$(DESTDIR
)${desktopdir}/${EMACS_NAME}.desktop
766 for file in snake-scores tetris-scores
; do \
767 file
=$(DESTDIR
)${gamedir}/$${file}; \
768 [ -s
$${file} ] ||
rm -f
$$file; \
771 ### Windows-specific uninstall target for removing programs produced
772 ### in nt/, and its Posix do-nothing shadow.
776 $(MAKE
) $(MFLAGS
) uninstall \
777 prefix=${prefix} exec_prefix=${exec_prefix} \
778 bindir=${bindir} libexecdir
=${libexecdir} archlibdir
=${archlibdir}
782 # ==================== Cleaning up and miscellanea ====================
784 .PHONY
: mostlyclean clean distclean bootstrap-clean maintainer-clean extraclean
787 ### Like `clean', but may refrain from deleting a few files that people
788 ### normally don't want to recompile. For example, the `mostlyclean'
789 ### target for GCC does not delete `libgcc.a', because recompiling it
790 ### is rarely necessary and takes a lot of time.
792 (cd src
; $(MAKE
) $(MFLAGS
) mostlyclean)
793 (cd oldXMenu
; $(MAKE
) $(MFLAGS
) mostlyclean)
794 (cd lwlib
; $(MAKE
) $(MFLAGS
) mostlyclean)
795 (cd lib
; $(MAKE
) $(MFLAGS
) mostlyclean)
796 (cd lib-src
; $(MAKE
) $(MFLAGS
) mostlyclean)
797 (cd nt
; $(MAKE
) $(MFLAGS
) mostlyclean)
798 -(cd doc
/emacs
&& $(MAKE
) $(MFLAGS
) mostlyclean)
799 -(cd doc
/misc
&& $(MAKE
) $(MFLAGS
) mostlyclean)
800 -(cd doc
/lispref
&& $(MAKE
) $(MFLAGS
) mostlyclean)
801 -(cd doc
/lispintro
&& $(MAKE
) $(MFLAGS
) mostlyclean)
802 (cd leim
; $(MAKE
) $(MFLAGS
) mostlyclean)
805 ### Delete all files from the current directory that are normally
806 ### created by building the program. Don't delete the files that
807 ### record the configuration. Also preserve files that could be made
808 ### by building, but normally aren't because the distribution comes
811 ### Delete `.dvi' files here if they are not part of the distribution.
813 -rm -f etc
/emacs.tmpdesktop
814 (cd src
; $(MAKE
) $(MFLAGS
) clean)
815 (cd oldXMenu
; $(MAKE
) $(MFLAGS
) clean)
816 (cd lwlib
; $(MAKE
) $(MFLAGS
) clean)
817 (cd lib
; $(MAKE
) $(MFLAGS
) clean)
818 (cd lib-src
; $(MAKE
) $(MFLAGS
) clean)
819 (cd nt
; $(MAKE
) $(MFLAGS
) clean)
820 -(cd doc
/emacs
&& $(MAKE
) $(MFLAGS
) clean)
821 -(cd doc
/misc
&& $(MAKE
) $(MFLAGS
) clean)
822 -(cd doc
/lispref
&& $(MAKE
) $(MFLAGS
) clean)
823 -(cd doc
/lispintro
&& $(MAKE
) $(MFLAGS
) clean)
824 (cd leim
; $(MAKE
) $(MFLAGS
) clean)
825 (cd nextstep
&& $(MAKE
) $(MFLAGS
) clean)
828 ### Delete all files that need to be remade for a clean bootstrap.
830 rm -f config.cache config.log
832 ### Delete all files from the current directory that are created by
833 ### configuring or building the program. If you have unpacked the
834 ### source and built the program without creating any other files,
835 ### `make distclean' should leave only the files that were in the
839 rm -f config.status config.log~ Makefile stamp-h1
${SUBDIR_MAKEFILES}
841 (cd src
; $(MAKE
) $(MFLAGS
) distclean)
842 (cd oldXMenu
; $(MAKE
) $(MFLAGS
) distclean)
843 (cd lwlib
; $(MAKE
) $(MFLAGS
) distclean)
844 (cd lib
; $(MAKE
) $(MFLAGS
) distclean)
845 (cd lib-src
; $(MAKE
) $(MFLAGS
) distclean)
846 (cd nt
; $(MAKE
) $(MFLAGS
) distclean)
847 (cd doc
/emacs
&& $(MAKE
) $(MFLAGS
) distclean)
848 (cd doc
/misc
&& $(MAKE
) $(MFLAGS
) distclean)
849 (cd doc
/lispref
&& $(MAKE
) $(MFLAGS
) distclean)
850 (cd doc
/lispintro
&& $(MAKE
) $(MFLAGS
) distclean)
851 (cd leim
; $(MAKE
) $(MFLAGS
) distclean)
852 (cd lisp
; $(MAKE
) $(MFLAGS
) distclean)
853 (cd nextstep
&& $(MAKE
) $(MFLAGS
) distclean)
856 ### `bootstrap-clean'
857 ### Delete everything that can be reconstructed by `make' and that
858 ### needs to be deleted in order to force a bootstrap from a clean state.
860 (cd src
; $(MAKE
) $(MFLAGS
) bootstrap-clean
)
861 (cd oldXMenu
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
862 (cd lwlib
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
863 (cd lib
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
864 (cd lib-src
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
865 (cd nt
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
866 -(cd doc
/emacs
&& $(MAKE
) $(MFLAGS
) maintainer-clean
)
867 -(cd doc
/misc
&& $(MAKE
) $(MFLAGS
) maintainer-clean
)
868 -(cd doc
/lispref
&& $(MAKE
) $(MFLAGS
) maintainer-clean
)
869 -(cd doc
/lispintro
&& $(MAKE
) $(MFLAGS
) maintainer-clean
)
870 (cd leim
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
871 (cd lisp
; $(MAKE
) $(MFLAGS
) bootstrap-clean
)
872 (cd nextstep
&& $(MAKE
) $(MFLAGS
) maintainer-clean
)
873 [ ! -f config.log
] || mv
-f config.log config.log~
876 ### `maintainer-clean'
877 ### Delete everything from the current directory that can be
878 ### reconstructed with this Makefile. This typically includes
879 ### everything deleted by distclean, plus more: C source files
880 ### produced by Bison, tags tables, info files, and so on.
882 ### One exception, however: `make maintainer-clean' should not delete
883 ### `configure' even if `configure' can be remade using a rule in the
884 ### Makefile. More generally, `make maintainer-clean' should not delete
885 ### anything that needs to exist in order to run `configure' and then
886 ### begin to build the program.
887 top_maintainer_clean
=\
889 rm -fr autom4te.cache
890 maintainer-clean
: bootstrap-clean FRC
891 (cd src
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
892 (cd lisp
; $(MAKE
) $(MFLAGS
) maintainer-clean
)
893 ${top_maintainer_clean}
895 ### This doesn't actually appear in the coding standards, but Karl
896 ### says GCC supports it, and that's where the configuration part of
897 ### the coding standards seem to come from. It's like distclean, but
898 ### it deletes backup and autosave files too.
900 for i in
${SUBDIR}; do
(cd
$$i; $(MAKE
) $(MFLAGS
) extraclean
); done
901 ${top_maintainer_clean}
905 # The src subdir knows how to do the right thing
906 # even when the build directory and source dir are different.
908 TAGS
tags: lib lib-src src
909 cd src
; $(MAKE
) $(MFLAGS
) tags
912 @if
test ! -d
test/automated
; then \
913 echo
"You do not seem to have the test/ directory."; \
914 echo
"Maybe you are using a release tarfile, rather than a repository checkout."; \
916 cd
test/automated
&& $(MAKE
) $(MFLAGS
) check; \
920 cd
${srcdir}; .
/make-dist
922 DVIS
= lispref-dvi lispintro-dvi emacs-dvi misc-dvi
923 HTMLS
= lispref-html lispintro-html emacs-html misc-html
924 INFOS
= lispref-info lispintro-info emacs-info misc-info
925 PDFS
= lispref-pdf lispintro-pdf emacs-pdf misc-pdf
926 PSS
= lispref-ps lispintro-ps emacs-ps
# no misc-ps
928 DOCS
= $(DVIS
) $(HTMLS
) $(INFOS
) $(PDFS
) $(PSS
)
930 t
=$@
; IFS
=-; set
$$t; IFS
=; cd doc
/$$1 && $(MAKE
) $(MFLAGS
) $$2
932 .PHONY
: $(DOCS
) docs pdf ps
933 .PHONY
: info dvi dist check html info-real force-info check-info-dir
943 # Note that man/Makefile knows how to put the info files in $(srcdir),
944 # so we can do ok running make in the build dir.
945 # This used to have a clause that exited with an error if MAKEINFO = no.
946 # But it is inappropriate to do so without checking if makeinfo is
947 # actually needed - it is not if the info files are up-to-date. (Bug#3982)
948 # Only the doc/*/Makefiles can decide that, so we let those rules run
949 # and give a standard error if makeinfo is needed but missing.
950 # While it would be nice to give a more detailed error message, that
951 # would require changing every rule in doc/ that builds an info file,
952 # and it's not worth it. This case is only relevant if you download a
953 # release, then change the .texi files.
955 @if
test "$(HAVE_MAKEINFO)" = "no"; then \
956 echo
"Configured --without-makeinfo, not building manuals" ; \
958 $(MAKE
) $(MFLAGS
) info-real
; \
961 # The info/dir file must be updated by hand when new manuals are added.
966 test -f
"$${file}" || continue
; \
968 *-[0-9]*|COPYING|
dir) continue
;; \
970 file
=`echo $${file} | sed 's/\.info//'` ; \
971 grep
-q
-F
": ($${file})." dir || missing
="$${missing} $${file}" ; \
973 if
test -n
"$${missing}"; then \
974 echo
"Missing info/dir entries: $${missing}" ; \
977 echo
"info/dir is OK"
981 ### This first cleans the lisp subdirectory, removing all compiled
982 ### Lisp files. Then re-run make to build all the files anew.
986 # Bootstrapping does the following:
987 # * Remove files to start from a bootstrap-clean slate.
988 # * Run autogen.sh, falling back on copy_autogen if autogen.sh fails.
989 # * Rebuild Makefile, to update the build procedure itself.
990 # * Do the actual build.
991 bootstrap
: bootstrap-clean FRC
992 cd
$(srcdir) && { .
/autogen.sh || autogen
/copy_autogen
; }
993 $(MAKE
) $(MFLAGS
) MAKEFILE_NAME
=force-Makefile force-Makefile
994 $(MAKE
) $(MFLAGS
) info all
996 .PHONY
: check-declare
999 @if
[ ! -f
$(srcdir)/src
/emacs
]; then \
1000 echo
"You must build Emacs to use this command"; \
1003 (cd leim
; $(MAKE
) $(MFLAGS
) $@
)
1004 (cd lisp
; $(MAKE
) $(MFLAGS
) $@
)