Comments
[bpt/emacs.git] / Makefile.in
CommitLineData
067d23c9
KY
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
3# DIST: that first.
4
fd9d85c2 5# Copyright (C) 1992-2012 Free Software Foundation, Inc.
067d23c9
KY
6
7# This file is part of GNU Emacs.
8
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.
13
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.
18
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/>.
21
22### Commentary:
23
24# make all to compile and build Emacs.
25# make install to install it.
26# make TAGS to update tags tables.
27#
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
33# with them.
34#
35# Delete `.dvi' files here if they are not part of the distribution.
36#
37# make distclean
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
42# distribution.
43#
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,
49# and so on.
50#
51# make extraclean
52# Still more severe - delete backup and autosave files, too.
53#
54# make bootstrap
55# Removes all the compiled files to force a new bootstrap from a
56# clean slate, and then build in the normal way.
57
58SHELL = /bin/sh
59
60# This may not work with certain non-GNU make's. It only matters when
61# inheriting a CDPATH not starting with the current directory.
62CDPATH=
63
64# If Make doesn't predefine MAKE, set it here.
65@SET_MAKE@
66
67# ==================== Things `configure' Might Edit ====================
68
6c269a38
PE
69MAINTAINER_MODE_FLAG = --disable-maintainer-mode
70@MAINT@MAINTAINER_MODE_FLAG = --enable-maintainer-mode
71cache_file = @cache_file@
72CONFIGURE_FLAGS = --cache-file=$(cache_file) $(MAINTAINER_MODE_FLAG)
73
067d23c9
KY
74CC=@CC@
75CFLAGS=@CFLAGS@
76LDFLAGS=@LDFLAGS@
77CPPFLAGS=@CPPFLAGS@
78EXEEXT=@EXEEXT@
067d23c9
KY
79
80### These help us choose version- and architecture-specific directories
81### to install files in.
82
83### This should be the number of the Emacs version we're building,
84### like `18.59' or `19.0'.
85version=@version@
86
87### This should be the name of the configuration we're building Emacs
88### for, like `mips-dec-ultrix' or `sparc-sun-sunos'.
89configuration=@configuration@
90
91# ==================== Where To Install Things ====================
92
3a4155de
GM
93# Location to install Emacs.app under GNUstep / Mac OS X.
94# Later values may use these.
95ns_appbindir=@ns_appbindir@
96ns_appresdir=@ns_appresdir@
b4a36200
GM
97# Either yes or no depending on whether this is a relocatable Emacs.app.
98ns_self_contained=@ns_self_contained@
3a4155de 99
067d23c9
KY
100# The default location for installation. Everything is placed in
101# subdirectories of this directory. The default values for many of
102# the variables below are expressed in terms of this one, so you may
103# not need to change them. This defaults to /usr/local.
104prefix=@prefix@
105
106# Like `prefix', but used for architecture-specific files.
107exec_prefix=@exec_prefix@
108
109# Where to install Emacs and other binaries that people will want to
110# run directly (like etags).
111bindir=@bindir@
112
113# The root of the directory tree for read-only architecture-independent
114# data files. ${datadir}, ${infodir} and ${mandir} are based on this.
115datarootdir=@datarootdir@
116
117# Where to install architecture-independent data files. ${lispdir}
118# and ${etcdir} are subdirectories of this.
119datadir=@datadir@
120
121# Where to install and expect the files that Emacs modifies as it
122# runs. These files are all architecture-independent.
123# Right now, this is not used.
124sharedstatedir=@sharedstatedir@
125
126# Where to install and expect executable files to be run by Emacs
3a4155de
GM
127# rather than directly by users (and other architecture-dependent
128# data, although Emacs does not have any). The executables
129# are actually installed in ${archlibdir}, which is (normally)
130# a subdirectory of this.
067d23c9
KY
131libexecdir=@libexecdir@
132
133# Where to install Emacs's man pages.
ab1121bd 134# Note they contain cross-references that expect them to be in section 1.
067d23c9
KY
135mandir=@mandir@
136man1dir=$(mandir)/man1
067d23c9 137
9aa071df 138# Where to install and expect the info files describing Emacs.
067d23c9 139infodir=@infodir@
9aa071df 140# Info files not in the doc/misc directory (we get those via make echo-info).
8045b906
GM
141INFO_EXT=@INFO_EXT@
142INFO_NONMISC=emacs$(INFO_EXT) eintr$(INFO_EXT) elisp$(INFO_EXT)
067d23c9 143
e5365138
GM
144# If no makeinfo was found and configured --without-makeinfo, "no"; else "yes".
145HAVE_MAKEINFO=@HAVE_MAKEINFO@
146
067d23c9
KY
147# Directory for local state files for all programs.
148localstatedir=@localstatedir@
149
150# Where to look for bitmap files.
151bitmapdir=@bitmapdir@
152
153# Where to find the source code. The source code for Emacs's C kernel is
154# expected to be in ${srcdir}/src, and the source code for Emacs's
155# utility programs is expected to be in ${srcdir}/lib-src. This is
156# set by the configure script's `--srcdir' option.
157
158# We use $(srcdir) explicitly in dependencies so as not to depend on VPATH.
159srcdir=@srcdir@
160
161# Where the manpage source files are kept.
162mansrcdir=$(srcdir)/doc/man
163
164# Tell make where to find source files; this is needed for the makefiles.
165VPATH=@srcdir@
166
167# Where to find the application default.
168x_default_search_path=@x_default_search_path@
169
067d23c9
KY
170# Where the etc/emacs.desktop file is to be installed.
171desktopdir=$(datarootdir)/applications
172
173# Where the etc/images/icons/hicolor directory is to be installed.
174icondir=$(datarootdir)/icons
175
176# The source directory for the icon files.
177iconsrcdir=$(srcdir)/etc/images/icons
178
179# ==================== Emacs-specific directories ====================
180
181# These variables hold the values Emacs will actually use. They are
182# based on the values of the standard Make variables above.
183
184# Where to install the lisp files distributed with
185# Emacs. This includes the Emacs version, so that the
186# lisp files for different versions of Emacs will install
187# themselves in separate directories.
188lispdir=@lispdir@
189
190# Directories Emacs should search for lisp files specific
191# to this site (i.e. customizations), before consulting
192# ${lispdir}. This should be a colon-separated list of
193# directories.
194locallisppath=@locallisppath@
195
196# Where Emacs will search to find its lisp files. Before
197# changing this, check to see if your purpose wouldn't
198# better be served by changing locallisppath. This
199# should be a colon-separated list of directories.
200lisppath=@lisppath@
201
202# Where Emacs will search for its lisp files while
203# building. This is only used during the process of
204# compiling Emacs, to help Emacs find its lisp files
205# before they've been installed in their final location.
5b43da69
GM
206# This should be a colon-separated list of directories.
207# Normally it points to the lisp/ directory in the sources.
067d23c9
KY
208buildlisppath=${srcdir}/lisp
209
210# Where to install the other architecture-independent
211# data files distributed with Emacs (like the tutorial,
212# the cookie recipes and the Zippy database). This path
213# usually contains the Emacs version number, so the data
214# files for multiple versions of Emacs may be installed
215# at once.
216etcdir=@etcdir@
217
218# Where to put executables to be run by Emacs rather than
219# the user. This path usually includes the Emacs version
220# and configuration name, so that multiple configurations
221# for multiple versions of Emacs may be installed at
222# once.
223archlibdir=@archlibdir@
224
225# Where to put the docstring file.
226docdir=@docdir@
227
228# Where to install Emacs game score files.
229gamedir=@gamedir@
230
231# ==================== Utility Programs for the Build ====================
232
233# Allow the user to specify the install program.
a36e64d0
GM
234# Note that if the system does not provide a suitable install,
235# configure will use build-aux/install-sh. Annoyingly, it does
236# not use an absolute path. So we must take care to always run
3fe7cdc8 237# INSTALL-type commands from the directory containing the Makefile.
a36e64d0 238# This explains (I think) the cd thisdir seen in several install rules.
067d23c9
KY
239INSTALL = @INSTALL@
240INSTALL_PROGRAM = @INSTALL_PROGRAM@
241INSTALL_DATA = @INSTALL_DATA@
242INSTALL_INFO = @INSTALL_INFO@
243# By default, we uphold the dignity of our programs.
244INSTALL_STRIP =
3fe7cdc8 245MKDIR_P = @MKDIR_P@
067d23c9
KY
246
247# We use gzip to compress installed .el files.
248GZIP_PROG = @GZIP_PROG@
249# If non-nil, gzip the installed Info and man pages.
250GZIP_INFO = @GZIP_INFO@
251
252# ============================= Targets ==============================
253
254# Program name transformation.
255TRANSFORM = @program_transform_name@
256
257# What emacs should be called when installed.
258EMACS = `echo emacs${EXEEXT} | sed '$(TRANSFORM)'`
259EMACSFULL = `echo emacs-${version}${EXEEXT} | sed '$(TRANSFORM)'`
260
9192d37d
GM
261# Subdirectories to make recursively.
262SUBDIR = lib lib-src src lisp leim
067d23c9
KY
263
264# The subdir makefiles created by config.status.
70716b1d 265SUBDIR_MAKEFILES_IN = @SUBDIR_MAKEFILES_IN@
cee4acda 266SUBDIR_MAKEFILES = `echo $(SUBDIR_MAKEFILES_IN:.in=) | sed 's|$(srcdir)/||g'`
067d23c9
KY
267
268# Subdirectories to install, and where they'll go.
269# lib-src's makefile knows how to install it, so we don't do that here.
270# leim's makefile also knows how to install it, so we don't do that here.
271# When installing the info files, we need to do special things to
272# avoid nuking an existing dir file, so we don't do that here;
273# instead, we have written out explicit code in the `install' targets.
274COPYDIR = ${srcdir}/etc ${srcdir}/lisp
275COPYDESTS = $(DESTDIR)${etcdir} $(DESTDIR)${lispdir}
276
9192d37d 277all: ${SUBDIR}
067d23c9
KY
278
279removenullpaths=sed -e 's/^://g' -e 's/:$$//g' -e 's/::/:/g'
280
281# Generate epaths.h from epaths.in. This target is invoked by `configure'.
282# See comments in configure.in for why it is done this way, as opposed
283# to just letting configure generate epaths.h from epaths.in in a
284# similar way to how Makefile is made from Makefile.in.
285epaths-force: FRC
286 @(lisppath=`echo ${lisppath} | ${removenullpaths}` ; \
287 buildlisppath=`echo ${buildlisppath} | ${removenullpaths}` ; \
288 x_default_search_path=`echo ${x_default_search_path}`; \
289 gamedir=`echo ${gamedir}`; \
290 sed < ${srcdir}/src/epaths.in > epaths.h.$$$$ \
291 -e 's;\(#.*PATH_LOADSEARCH\).*$$;\1 "'"$${lisppath}"'";' \
292 -e 's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "'"$${buildlisppath}"'";' \
293 -e 's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";' \
294 -e 's;\(#.*PATH_INFO\).*$$;\1 "${infodir}";' \
295 -e 's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";' \
296 -e 's;\(#.*PATH_BITMAPS\).*$$;\1 "${bitmapdir}";' \
297 -e 's;\(#.*PATH_X_DEFAULTS\).*$$;\1 "${x_default_search_path}";' \
298 -e 's;\(#.*PATH_GAME\).*$$;\1 "${gamedir}";' \
dc3e3e7b 299 -e 's;\(#.*PATH_DOC\).*$$;\1 "${docdir}";') && \
24e0f6b1 300 ${srcdir}/build-aux/move-if-change epaths.h.$$$$ src/epaths.h
067d23c9 301
9a514d4a
PE
302lib-src src: lib
303
067d23c9
KY
304src: lib-src FRC
305
9192d37d 306.RECURSIVE: ${SUBDIR}
067d23c9 307
9192d37d
GM
308# We need to build `emacs' in `src' to compile the *.elc files in `lisp'
309# and `leim'.
310lisp leim: src
067d23c9 311
9a514d4a
PE
312# Maintainers can put a copy of gnulib into $(gnulib_srcdir).
313gnulib_srcdir = ../gnulib
314$(gnulib_srcdir):
315 git clone git://git.savannah.gnu.org/gnulib.git $@
316
125c3718 317# A shorter name that satisfies MS-DOS 8+3 constraints.
c7e95b91 318DOS_gnulib_comp.m4 = gl-comp.m4
125c3718 319
9a514d4a
PE
320# Update modules from gnulib, for maintainers, who should have it in
321# $(gnulib_srcdir) (relative to $(srcdir) and should have build tools
322# as per $(gnulib_srcdir)/DEPENDENCIES.
942f733f 323GNULIB_MODULES = \
fa23e171 324 alloca-opt \
3ce9d0d4 325 careadlinkat crypto/md5 crypto/sha1 crypto/sha256 crypto/sha512 dtoastr \
7a7ef429 326 dup2 \
6db30f83 327 filemode getloadavg getopt-gnu ignore-value intprops lstat \
b8df54ff
PE
328 manywarnings mktime pthread_sigmask readlink \
329 socklen stdarg stdio strftime strtoimax strtoumax symlink sys_stat \
330 warnings
9a514d4a 331GNULIB_TOOL_FLAGS = \
6df37268 332 --avoid=msvc-inval --avoid=msvc-nothrow \
316f8af0 333 --avoid=raise --avoid=threadlib \
19548d08
PE
334 --conditional-dependencies --import --no-changelog --no-vc-files \
335 --makefile-name=gnulib.mk
9a514d4a 336sync-from-gnulib: $(gnulib_srcdir)
c7e95b91 337 -cd $(srcdir)/m4 && cp $(DOS_gnulib_comp.m4) gnulib-comp.m4
9a514d4a
PE
338 cd $(srcdir) && \
339 $(gnulib_srcdir)/gnulib-tool $(GNULIB_TOOL_FLAGS) $(GNULIB_MODULES)
125c3718 340 cd $(srcdir)/m4 && rm gnulib-cache.m4 warn-on-use.m4
c7e95b91 341 cd $(srcdir)/m4 && mv gnulib-comp.m4 $(DOS_gnulib_comp.m4)
9a514d4a
PE
342 cp $(gnulib_srcdir)/build-aux/texinfo.tex $(srcdir)/doc/misc
343 cp \
9a514d4a 344 $(gnulib_srcdir)/build-aux/move-if-change \
24e0f6b1 345 $(srcdir)/build-aux
f6ca84c0 346 cd $(srcdir) && autoreconf -i -I m4
9a514d4a
PE
347.PHONY: sync-from-gnulib
348
067d23c9 349# These targets should be "${SUBDIR} without `src'".
9192d37d 350lib lib-src lisp leim: Makefile FRC
2e5d41e4 351 cd $@ && $(MAKE) all $(MFLAGS) \
067d23c9
KY
352 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
353 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}'
354
355# Pass to src/Makefile.in an additional BOOTSTRAPEMACS variable which
356# is either set to bootstrap-emacs (in case bootstrap-emacs has not been
357# constructed yet) or the empty string (otherwise).
358# src/Makefile.in uses it to implement conditional dependencies, so that
359# files that need bootstrap-emacs to be built do not additionally need
360# to be kept fresher than bootstrap-emacs. Otherwise changing a single
361# file src/foo.c forces dumping a new bootstrap-emacs, then re-byte-compiling
362# all preloaded elisp files, and only then dump the actual src/emacs, which
363# is not wrong, but is overkill in 99.99% of the cases.
364src: Makefile FRC
365 boot=bootstrap-emacs$(EXEEXT); \
366 if [ ! -x "src/$$boot" ]; then \
367 cd $@; $(MAKE) all $(MFLAGS) \
368 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
369 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="$$boot"; \
370 fi;
371 if [ -r .bzr/checkout/dirstate ]; then \
4f8c52a9 372 vcswitness="`pwd`/.bzr/checkout/dirstate"; \
067d23c9
KY
373 fi; \
374 cd $@; $(MAKE) all $(MFLAGS) \
375 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
376 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="" \
377 VCSWITNESS="$$vcswitness"
378
379blessmail: Makefile src FRC
380 cd lib-src; $(MAKE) maybe-blessmail $(MFLAGS) \
381 MAKE='${MAKE}' archlibdir='$(archlibdir)'
382
383# We used to have one rule per */Makefile.in, but that leads to race
384# conditions with parallel makes, so let's assume that the time stamp on
385# ./Makefile is representative of the time stamp on all the other Makefiles.
386Makefile: config.status $(srcdir)/src/config.in \
fa5d79db 387 $(srcdir)/Makefile.in $(SUBDIR_MAKEFILES_IN)
067d23c9
KY
388 ./config.status
389
bfab7d85
SM
390# Don't erase config.status if make is interrupted while refreshing it.
391.PRECIOUS: config.status
392
067d23c9 393config.status: ${srcdir}/configure ${srcdir}/lisp/version.el
bfab7d85
SM
394 if [ -x ./config.status ]; then \
395 ./config.status --recheck; \
396 else \
6c269a38 397 ./configure $(CONFIGURE_FLAGS); \
bfab7d85 398 fi
067d23c9 399
84bbb1ad 400AUTOCONF_INPUTS = @MAINT@ $(srcdir)/configure.in $(srcdir)/aclocal.m4
067d23c9
KY
401
402$(srcdir)/configure: $(AUTOCONF_INPUTS)
403 cd ${srcdir} && autoconf
404
c7e95b91 405ACLOCAL_INPUTS = @MAINT@ $(srcdir)/m4/$(DOS_gnulib_comp.m4)
9a514d4a
PE
406$(srcdir)/aclocal.m4: $(ACLOCAL_INPUTS)
407 cd $(srcdir) && aclocal -I m4
408
16b71f3a 409AUTOMAKE_INPUTS = @MAINT@ $(srcdir)/aclocal.m4 $(srcdir)/lib/Makefile.am $(srcdir)/lib/gnulib.mk
9a514d4a
PE
410$(srcdir)/lib/Makefile.in: $(AUTOMAKE_INPUTS)
411 cd $(srcdir) && automake --gnu -a -c lib/Makefile
925e561d 412am--refresh: $(srcdir)/aclocal.m4 $(srcdir)/configure $(srcdir)/src/config.in
3cbecb8f 413.PHONY: am--refresh
9a514d4a 414
067d23c9
KY
415$(srcdir)/src/config.in: $(srcdir)/src/stamp-h.in
416 @ # Usually, there's no need to rebuild src/config.in just
417 @ # because stamp-h.in has changed (since building stamp-h.in
418 @ # refreshes config.in as well), but if config.in is missing
419 @ # then we really need to do something more.
420 [ -r "$@" ] || ( cd ${srcdir} && autoheader )
421$(srcdir)/src/stamp-h.in: $(AUTOCONF_INPUTS)
422 cd ${srcdir} && autoheader
423 rm -f $(srcdir)/src/stamp-h.in
424 echo timestamp > $(srcdir)/src/stamp-h.in
425
426# ==================== Installation ====================
427
428## If we let lib-src do its own installation, that means we
429## don't have to duplicate the list of utilities to install in
430## this Makefile as well.
431
62061397 432.PHONY: install
067d23c9 433
bfed8334 434install: all install-arch-indep install-doc install-arch-dep blessmail
067d23c9
KY
435 @true
436
53a84f3c 437## Ensure that $subdir contains a subdirs.el file.
7606c360
GM
438## Here and elsewhere, we set the umask so that any created files are
439## world-readable.
440## TODO it might be good to warn about non-standard permissions of
441## pre-existing directories, but that does not seem easy.
53a84f3c
GM
442write_subdir=if [ -f $${subdir}/subdirs.el ]; \
443 then true; \
444 else \
4c54abe1
GM
445 umask 022; \
446 ${MKDIR_P} $${subdir}; \
53a84f3c
GM
447 (echo "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
448 echo " (normal-top-level-add-subdirs-to-load-path))") \
449 > $${subdir}/subdirs.el; \
4c54abe1 450 fi
53a84f3c 451
067d23c9 452### Install the executables that were compiled specifically for this machine.
ed0ba302
GM
453### We do install-arch-indep first because the executable needs the
454### Lisp files and DOC file to work properly.
bfed8334 455install-arch-dep: install-arch-indep install-doc
b533f05e 456 umask 022; ${MKDIR_P} $(DESTDIR)${bindir}
067d23c9
KY
457 (cd lib-src; \
458 $(MAKE) install $(MFLAGS) prefix=${prefix} \
459 exec_prefix=${exec_prefix} bindir=${bindir} \
460 libexecdir=${libexecdir} archlibdir=${archlibdir} \
461 INSTALL_STRIP=${INSTALL_STRIP})
b4a36200 462 if test "${ns_self_contained}" = "no"; then \
96182ae6
GM
463 ${INSTALL_PROGRAM} $(INSTALL_STRIP) src/emacs${EXEEXT} $(DESTDIR)${bindir}/$(EMACSFULL) || exit 1 ; \
464 chmod 1755 $(DESTDIR)${bindir}/$(EMACSFULL) ; \
465 rm -f $(DESTDIR)${bindir}/$(EMACS) ; \
466 ln $(DESTDIR)${bindir}/$(EMACSFULL) $(DESTDIR)${bindir}/$(EMACS) || true ; \
467 else \
05f3d308 468 subdir=${ns_appresdir}/site-lisp; \
05f3d308
GM
469 ${write_subdir} || exit 1; \
470 rm -rf ${ns_appresdir}/share; \
96182ae6 471 fi
067d23c9 472
05f3d308 473## In the share directory, we are deleting:
660c8c1e
GM
474## applications (with emacs.desktop, also found in etc/)
475## emacs (basically empty except for unneeded site-lisp directories)
05f3d308 476## icons (duplicates etc/images/icons/hicolor)
05f3d308 477
6b3868cb
GM
478## This is install-etc for everything except self-contained-ns builds.
479## For them, it is empty.
480INSTALL_ARCH_INDEP_EXTRA = @INSTALL_ARCH_INDEP_EXTRA@
481
067d23c9
KY
482## http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg01672.html
483## Needs to be the user running install, so configure can't set it.
484set_installuser=for installuser in $${LOGNAME} $${USERNAME} $${USER} \
485 `id -un 2> /dev/null`; do \
486 [ -n "$${installuser}" ] && break ; \
487 done
488
489### Install the files that are machine-independent.
29473393
GM
490### Most of them come straight from the distribution; the exception is
491### the DOC file, which is copied from the build directory.
067d23c9 492
7606c360
GM
493## We delete each directory in ${COPYDESTS} before we copy into it;
494## that way, we can reinstall over directories that have been put in
495## place with their files read-only (perhaps because they are checked
496## into RCS). In order to make this safe, we make sure that the
497## source exists and is distinct from the destination.
62061397 498
29473393
GM
499## We delete etc/DOC* because there may be irrelevant DOC files from
500## other builds in the source directory. This is ok because we just
501## deleted the entire installed etc/ directory and recreated it.
502## install-doc installs the relevant DOC.
503
504## Note that the Makefiles in the etc directory are potentially useful
505## in an installed Emacs, so should not be excluded.
506
62061397
GM
507## I'm not sure creating locallisppath here serves any useful purpose.
508## If it has the default value, then the later write_subdir commands
509## will ensure all these components exist.
510## This will only do something if locallisppath has a non-standard value.
511## Is it really Emacs's job to create those directories?
512## Should we also be ensuring they contain subdirs.el files?
513## It would be easy to do, just use write_subdir.
41a2ce39
GM
514
515## Note that we use tar instead of plain old cp -R/-r because the latter
516## is apparently not portable (even in 2012!).
517## http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00278.html
518## I have no idea which platforms Emacs supports where cp -R does not
519## work correctly, and therefore no idea when tar can be replaced.
bfed8334 520install-arch-indep: install-leim install-info install-man ${INSTALL_ARCH_INDEP_EXTRA}
62061397
GM
521 umask 022 ; \
522 $(MKDIR_P) $(DESTDIR)`echo ${locallisppath} | sed 's,:, $(DESTDIR),g'`
067d23c9
KY
523 -set ${COPYDESTS} ; \
524 unset CDPATH; \
067d23c9
KY
525 $(set_installuser); \
526 for dir in ${COPYDIR} ; do \
7606c360 527 [ -d $${dir} ] || exit 1 ; \
067d23c9 528 dest=$$1 ; shift ; \
b7e1feea
GM
529 [ -d $${dest} ] && \
530 [ `(cd $${dest} && /bin/pwd)` = `(cd $${dir} && /bin/pwd)` ] && \
7606c360
GM
531 continue ; \
532 rm -rf $${dest} ; \
533 umask 022; ${MKDIR_P} $${dest} ; \
e39b9806
GM
534 echo "Copying $${dir} to $${dest}..." ; \
535 (cd $${dir}; tar -chf - . ) \
536 | (cd $${dest}; umask 022; \
537 tar -xvf - && cat > /dev/null) || exit 1; \
538 [ "$${dir}" != "${srcdir}/etc" ] || rm -f $${dest}/DOC* ; \
539 for subdir in `find $${dest} -type d -print` ; do \
afdc3477
GM
540 rm -f $${subdir}/.gitignore ; \
541 rm -f $${subdir}/.arch-inventory ; \
542 rm -f $${subdir}/.DS_Store ; \
543 rm -f $${subdir}/\#* ; \
544 rm -f $${subdir}/.\#* ; \
545 rm -f $${subdir}/*~ ; \
546 rm -f $${subdir}/*.orig ; \
547 rm -f $${subdir}/ChangeLog* ; \
e39b9806 548 [ "$${dir}" != "${srcdir}/etc" ] && \
afdc3477 549 rm -f $${subdir}/[mM]akefile*[.-]in $${subdir}/[mM]akefile ; \
e39b9806
GM
550 done ; \
551 find $${dest} -exec chown $${installuser} {} ';' ;\
067d23c9
KY
552 done
553 -rm -f $(DESTDIR)${lispdir}/subdirs.el
42d5aa3e 554 umask 022; $(srcdir)/update-subdirs $(DESTDIR)${lispdir}
9f1ea7dc
GM
555 subdir=$(DESTDIR)${datadir}/emacs/${version}/site-lisp ; \
556 ${write_subdir}
557 subdir=$(DESTDIR)${datadir}/emacs/site-lisp ; \
558 ${write_subdir} || true
6d1a623e
GM
559 [ -z "${GZIP_PROG}" ] || \
560 ( echo "Compressing *.el ..." ; \
561 unset CDPATH; \
562 cd $(DESTDIR)${lispdir}; \
563 for f in `find . -name "*.elc" -print`; do \
564 ${GZIP_PROG} -9n `echo $$f|sed 's/.elc$$/.el/'` ; \
565 done )
660c8c1e
GM
566 -chmod -R a+r $(DESTDIR)${datadir}/emacs/${version} ${COPYDESTS}
567
42d5aa3e
GM
568# The last chmod isn't needed at present.
569
660c8c1e
GM
570## We install only the relevant DOC file if possible
571## (ie DOC-${version}.buildnumber), otherwise DOC-${version}*.
572## (Note "otherwise" is inaccurate since 2009-08-23.)
573
bfed8334
GM
574## Note that install-arch-indep deletes and recreates the entire
575## installed etc/ directory, so we need it to run before this does.
576install-doc: install-arch-indep
660c8c1e 577 -unset CDPATH; \
568c6157 578 umask 022; ${MKDIR_P} $(DESTDIR)${docdir} ; \
067d23c9
KY
579 if [ `(cd ./etc; /bin/pwd)` != `(cd $(DESTDIR)${docdir}; /bin/pwd)` ]; \
580 then \
581 fullversion=`./src/emacs --version | sed -n '1 s/GNU Emacs *//p'`; \
582 if [ -f "./etc/DOC-$${fullversion}" ]; \
583 then \
584 docfile="DOC-$${fullversion}"; \
585 else \
586 docfile="DOC"; \
587 fi; \
588 echo "Copying etc/$${docfile} to $(DESTDIR)${docdir} ..." ; \
e6124927 589 ${INSTALL_DATA} etc/$${docfile} $(DESTDIR)${docdir}/$${docfile}; \
29473393
GM
590 $(set_installuser); \
591 chown $${installuser} $(DESTDIR)${docdir}/$${docfile} || true ; \
067d23c9 592 else true; fi
660c8c1e
GM
593
594install-info: info
b533f05e 595 umask 022; ${MKDIR_P} $(DESTDIR)${infodir}
067d23c9
KY
596 -unset CDPATH; \
597 thisdir=`/bin/pwd`; \
6d1a623e 598 [ `(cd ${srcdir}/info && /bin/pwd)` = `(cd $(DESTDIR)${infodir} && /bin/pwd)` ] || \
067d23c9 599 (cd $(DESTDIR)${infodir}; \
6d1a623e 600 [ -f dir ] || \
067d23c9 601 (cd $${thisdir}; \
37baa3c8 602 ${INSTALL_DATA} ${srcdir}/info/dir $(DESTDIR)${infodir}/dir) ; \
9aa071df 603 info_misc=`cd $${thisdir}/doc/misc; ${MAKE} echo-info | sed '/ing directory/d'`; \
067d23c9 604 cd ${srcdir}/info ; \
9aa071df 605 for elt in ${INFO_NONMISC} $${info_misc}; do \
4f8c52a9 606 test "$(HAVE_MAKEINFO)" = "no" && test ! -f $$elt && continue; \
067d23c9 607 for f in `ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
a36e64d0
GM
608 (cd $${thisdir}; \
609 ${INSTALL_DATA} ${srcdir}/info/$$f $(DESTDIR)${infodir}/$$f); \
6d1a623e
GM
610 ( [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ] ) || continue ; \
611 rm -f $(DESTDIR)${infodir}/$$f.gz; \
612 ${GZIP_PROG} -9n $(DESTDIR)${infodir}/$$f; \
067d23c9 613 done; \
7adecb99
GM
614 (cd $${thisdir}; \
615 ${INSTALL_INFO} --info-dir=$(DESTDIR)${infodir} $(DESTDIR)${infodir}/$$elt); \
6d1a623e 616 done)
660c8c1e
GM
617
618install-man:
b533f05e 619 umask 022; ${MKDIR_P} $(DESTDIR)${man1dir}
067d23c9
KY
620 thisdir=`/bin/pwd`; \
621 cd ${mansrcdir}; \
ab1121bd 622 for page in *.1; do \
067d23c9 623 (cd $${thisdir}; \
6d1a623e
GM
624 ${INSTALL_DATA} ${mansrcdir}/$${page} $(DESTDIR)${man1dir}/$${page}); \
625 ( [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ] ) || continue ; \
626 rm -f $(DESTDIR)${man1dir}/$${page}.gz; \
627 ${GZIP_PROG} -9n $(DESTDIR)${man1dir}/$${page}; \
067d23c9
KY
628 done
629
630## Install those items from etc/ that need to end up elsewhere.
d9a1e2c2
GM
631install-etc:
632 umask 022; ${MKDIR_P} $(DESTDIR)${desktopdir}
067d23c9
KY
633 ${INSTALL_DATA} ${srcdir}/etc/emacs.desktop \
634 $(DESTDIR)${desktopdir}/emacs.desktop
7606c360 635 thisdir=`/bin/pwd`; \
d9a1e2c2
GM
636 cd ${iconsrcdir} || exit 1; umask 022 ; \
637 for dir in */*/apps */*/mimetypes; do \
638 [ -d $${dir} ] || continue ; \
af006ad5 639 ( cd $${thisdir}; ${MKDIR_P} $(DESTDIR)${icondir}/$${dir} ) ; \
d9a1e2c2
GM
640 for icon in $${dir}/*.*; do \
641 [ -r $${icon} ] || continue ; \
7606c360 642 ( cd $${thisdir}; \
af006ad5 643 ${INSTALL_DATA} ${iconsrcdir}/$${icon} $(DESTDIR)${icondir}/$${icon} ) \
7606c360 644 || exit 1; \
d9a1e2c2 645 done ; \
067d23c9
KY
646 done
647
648### Install LEIM files. Although they are machine-independent, we
649### have separate target here instead of including it in
650### `install-arch-indep'. People who extracted LEIM files after they
53964682 651### installed Emacs itself can install only LEIM files by this target.
b533f05e 652install-leim: leim/Makefile
fd9d85c2 653 cd leim && $(MAKE) $(MFLAGS) install
067d23c9
KY
654
655### Build Emacs and install it, stripping binaries while installing them.
656install-strip:
fd9d85c2 657 $(MAKE) $(MFLAGS) INSTALL_STRIP=-s install
067d23c9 658
067d23c9
KY
659### Delete all the installed files that the `install' target would
660### create (but not the noninstalled files such as `make all' would create).
661###
662### Don't delete the lisp and etc directories if they're in the source tree.
663uninstall:
664 (cd lib-src; \
665 $(MAKE) $(MFLAGS) uninstall \
666 prefix=${prefix} exec_prefix=${exec_prefix} \
667 bindir=${bindir} libexecdir=${libexecdir} archlibdir=${archlibdir})
668 -unset CDPATH; \
669 for dir in $(DESTDIR)${lispdir} $(DESTDIR)${etcdir} ; do \
670 if [ -d $${dir} ]; then \
671 case `(cd $${dir} ; /bin/pwd)` in \
672 `(cd ${srcdir} ; /bin/pwd)`* ) ;; \
673 * ) rm -rf $${dir} ;; \
674 esac ; \
675 case $${dir} in \
676 $(DESTDIR)${datadir}/emacs/${version}/* ) \
677 rm -rf $(DESTDIR)${datadir}/emacs/${version} \
678 ;; \
679 esac ; \
680 fi ; \
681 done
067d23c9 682 -rm -rf $(DESTDIR)${libexecdir}/emacs/${version}
a36e64d0 683 thisdir=`/bin/pwd`; \
9aa071df
GM
684 (info_misc=`cd doc/misc; ${MAKE} echo-info | sed '/ing directory/d'`; \
685 cd $(DESTDIR)${infodir} && \
686 for elt in ${INFO_NONMISC} $${info_misc}; do \
a36e64d0
GM
687 (cd $${thisdir}; \
688 $(INSTALL_INFO) --remove --info-dir=$(DESTDIR)${infodir} $(DESTDIR)${infodir}/$$elt); \
7eb21b49
GM
689 if [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ]; then \
690 ext=.gz; else ext=; fi; \
cd3771a0 691 rm -f $$elt$$ext $$elt-[1-9]$$ext $$elt-[1-9][0-9]$$ext; \
067d23c9 692 done;)
7eb21b49
GM
693 (if [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ]; then \
694 ext=.gz; else ext=; fi; \
ab1121bd
GM
695 cd ${mansrcdir} && for page in *.1; do \
696 rm -f $(DESTDIR)${man1dir}/$$page$$ext; done )
067d23c9
KY
697 (cd $(DESTDIR)${bindir} && rm -f $(EMACSFULL) $(EMACS))
698 (cd $(DESTDIR)${icondir} && rm -f hicolor/*x*/apps/emacs.png hicolor/*x*/apps/emacs22.png hicolor/scalable/apps/emacs.svg hicolor/scalable/mimetypes/emacs-document.svg )
699 -rm -f $(DESTDIR)${desktopdir}/emacs.desktop
700 for file in snake-scores tetris-scores; do \
701 file=$(DESTDIR)${gamedir}/$${file}; \
702 [ -s $${file} ] || rm -f $$file; \
703 done
704
705FRC:
706
707# ==================== Cleaning up and miscellanea ====================
708
709.PHONY: mostlyclean clean distclean maintainer-clean extraclean
710
711### `mostlyclean'
712### Like `clean', but may refrain from deleting a few files that people
713### normally don't want to recompile. For example, the `mostlyclean'
714### target for GCC does not delete `libgcc.a', because recompiling it
715### is rarely necessary and takes a lot of time.
716mostlyclean: FRC
717 (cd src; $(MAKE) $(MFLAGS) mostlyclean)
718 (cd oldXMenu; $(MAKE) $(MFLAGS) mostlyclean)
719 (cd lwlib; $(MAKE) $(MFLAGS) mostlyclean)
9a514d4a 720 (cd lib; $(MAKE) $(MFLAGS) mostlyclean)
067d23c9
KY
721 (cd lib-src; $(MAKE) $(MFLAGS) mostlyclean)
722 -(cd doc/emacs && $(MAKE) $(MFLAGS) mostlyclean)
723 -(cd doc/misc && $(MAKE) $(MFLAGS) mostlyclean)
724 -(cd doc/lispref && $(MAKE) $(MFLAGS) mostlyclean)
725 -(cd doc/lispintro && $(MAKE) $(MFLAGS) mostlyclean)
726 (cd leim; $(MAKE) $(MFLAGS) mostlyclean)
727
728### `clean'
729### Delete all files from the current directory that are normally
730### created by building the program. Don't delete the files that
731### record the configuration. Also preserve files that could be made
732### by building, but normally aren't because the distribution comes
733### with them.
734###
735### Delete `.dvi' files here if they are not part of the distribution.
736clean: FRC
737 (cd src; $(MAKE) $(MFLAGS) clean)
738 (cd oldXMenu; $(MAKE) $(MFLAGS) clean)
739 (cd lwlib; $(MAKE) $(MFLAGS) clean)
9a514d4a 740 (cd lib; $(MAKE) $(MFLAGS) clean)
067d23c9
KY
741 (cd lib-src; $(MAKE) $(MFLAGS) clean)
742 -(cd doc/emacs && $(MAKE) $(MFLAGS) clean)
743 -(cd doc/misc && $(MAKE) $(MFLAGS) clean)
744 -(cd doc/lispref && $(MAKE) $(MFLAGS) clean)
745 -(cd doc/lispintro && $(MAKE) $(MFLAGS) clean)
746 (cd leim; $(MAKE) $(MFLAGS) clean)
747
748### `bootclean'
749### Delete all files that need to be remade for a clean bootstrap.
750top_bootclean=\
751 rm -f config.cache config.log
752### `distclean'
753### Delete all files from the current directory that are created by
754### configuring or building the program. If you have unpacked the
755### source and built the program without creating any other files,
756### `make distclean' should leave only the files that were in the
757### distribution.
758top_distclean=\
759 ${top_bootclean}; \
773233f8 760 rm -f config.status config.log~ Makefile stamp-h1 ${SUBDIR_MAKEFILES}
067d23c9
KY
761distclean: FRC
762 (cd src; $(MAKE) $(MFLAGS) distclean)
763 (cd oldXMenu; $(MAKE) $(MFLAGS) distclean)
764 (cd lwlib; $(MAKE) $(MFLAGS) distclean)
9a514d4a 765 (cd lib; $(MAKE) $(MFLAGS) distclean)
067d23c9
KY
766 (cd lib-src; $(MAKE) $(MFLAGS) distclean)
767 (cd doc/emacs && $(MAKE) $(MFLAGS) distclean)
768 (cd doc/misc && $(MAKE) $(MFLAGS) distclean)
769 (cd doc/lispref && $(MAKE) $(MFLAGS) distclean)
770 (cd doc/lispintro && $(MAKE) $(MFLAGS) distclean)
771 (cd leim; $(MAKE) $(MFLAGS) distclean)
772 (cd lisp; $(MAKE) $(MFLAGS) distclean)
773 ${top_distclean}
774
775### `bootstrap-clean'
776### Delete everything that can be reconstructed by `make' and that
777### needs to be deleted in order to force a bootstrap from a clean state.
778bootstrap-clean: FRC
779 (cd src; $(MAKE) $(MFLAGS) bootstrap-clean)
780 (cd oldXMenu; $(MAKE) $(MFLAGS) maintainer-clean)
781 (cd lwlib; $(MAKE) $(MFLAGS) maintainer-clean)
9a514d4a 782 (cd lib; $(MAKE) $(MFLAGS) maintainer-clean)
067d23c9
KY
783 (cd lib-src; $(MAKE) $(MFLAGS) maintainer-clean)
784 -(cd doc/emacs && $(MAKE) $(MFLAGS) maintainer-clean)
785 -(cd doc/misc && $(MAKE) $(MFLAGS) maintainer-clean)
786 -(cd doc/lispref && $(MAKE) $(MFLAGS) maintainer-clean)
787 -(cd doc/lispintro && $(MAKE) $(MFLAGS) maintainer-clean)
788 (cd leim; $(MAKE) $(MFLAGS) maintainer-clean)
789 (cd lisp; $(MAKE) $(MFLAGS) bootstrap-clean)
4f8c52a9 790 [ ! -f config.log ] || mv -f config.log config.log~
067d23c9 791 ${top_bootclean}
773233f8
GM
792## configure; make bootstrap replaces the real config.log from configure
793## with the truncated one from config.status. The former is more useful.
067d23c9
KY
794
795### `maintainer-clean'
796### Delete everything from the current directory that can be
797### reconstructed with this Makefile. This typically includes
798### everything deleted by distclean, plus more: C source files
799### produced by Bison, tags tables, info files, and so on.
800###
801### One exception, however: `make maintainer-clean' should not delete
802### `configure' even if `configure' can be remade using a rule in the
803### Makefile. More generally, `make maintainer-clean' should not delete
804### anything that needs to exist in order to run `configure' and then
805### begin to build the program.
9a514d4a
PE
806top_maintainer_clean=\
807 ${top_distclean}; \
e02ea74b 808 rm -fr autom4te.cache
067d23c9
KY
809maintainer-clean: bootstrap-clean FRC
810 (cd src; $(MAKE) $(MFLAGS) maintainer-clean)
811 (cd lisp; $(MAKE) $(MFLAGS) maintainer-clean)
9a514d4a 812 ${top_maintainer_clean}
067d23c9
KY
813
814### This doesn't actually appear in the coding standards, but Karl
815### says GCC supports it, and that's where the configuration part of
816### the coding standards seem to come from. It's like distclean, but
817### it deletes backup and autosave files too.
818extraclean:
9192d37d 819 for i in ${SUBDIR}; do (cd $$i; $(MAKE) $(MFLAGS) extraclean); done
9a514d4a 820 ${top_maintainer_clean}
067d23c9
KY
821 -rm -f config-tmp-*
822 -rm -f *~ \#*
823
824# The src subdir knows how to do the right thing
825# even when the build directory and source dir are different.
9a514d4a 826TAGS tags: lib lib-src src
5a95c002 827 cd src; $(MAKE) $(MFLAGS) tags
067d23c9
KY
828
829check:
6c7e099d 830 @if test ! -d test/automated; then \
a22d9d2c
GM
831 echo "You do not seem to have the test/ directory."; \
832 echo "Maybe you are using a release tarfile, rather than a repository checkout."; \
833 else \
834 cd test/automated && $(MAKE) $(MFLAGS) check; \
835 fi
067d23c9
KY
836
837dist:
838 cd ${srcdir}; ./make-dist
839
840.PHONY: info dvi dist check html
841
925e561d 842info-real:
067d23c9
KY
843 (cd doc/emacs; $(MAKE) $(MFLAGS) info)
844 (cd doc/misc; $(MAKE) $(MFLAGS) info)
845 (cd doc/lispref; $(MAKE) $(MFLAGS) info)
846 (cd doc/lispintro; $(MAKE) $(MFLAGS) info)
847
848force-info:
849# Note that man/Makefile knows how to put the info files in $(srcdir),
850# so we can do ok running make in the build dir.
851# This used to have a clause that exited with an error if MAKEINFO = no.
852# But it is inappropriate to do so without checking if makeinfo is
853# actually needed - it is not if the info files are up-to-date. (Bug#3982)
854# Only the doc/*/Makefiles can decide that, so we let those rules run
855# and give a standard error if makeinfo is needed but missing.
856# While it would be nice to give a more detailed error message, that
857# would require changing every rule in doc/ that builds an info file,
858# and it's not worth it. This case is only relevant if you download a
859# release, then change the .texi files.
860info: force-info
e5365138 861 @if test "$(HAVE_MAKEINFO)" = "no"; then \
067d23c9
KY
862 echo "Configured --without-makeinfo, not building manuals" ; \
863 else \
864 $(MAKE) $(MFLAGS) info-real ; \
865 fi
866
867# The info/dir file must be updated by hand when new manuals are added.
868check-info-dir: info
869 cd info ; \
870 missing= ; \
871 for file in *; do \
872 test -f "$${file}" || continue ; \
873 case $${file} in \
874 *-[0-9]*|COPYING|dir) continue ;; \
875 esac ; \
8045b906 876 file=`echo $${file} | sed 's/\.info//'` ; \
067d23c9
KY
877 grep -q -F ": ($${file})." dir || missing="$${missing} $${file}" ; \
878 done ; \
879 if test -n "$${missing}"; then \
880 echo "Missing info/dir entries: $${missing}" ; \
881 exit 1 ; \
882 fi ; \
883 echo "info/dir is OK"
884
885dvi:
886 (cd doc/emacs; $(MAKE) $(MFLAGS) dvi)
887 (cd doc/misc; $(MAKE) $(MFLAGS) dvi)
888 (cd doc/lispref; $(MAKE) $(MFLAGS) elisp.dvi)
889 (cd doc/lispintro; $(MAKE) $(MFLAGS) emacs-lisp-intro.dvi)
890
891#### Bootstrapping.
892
893### This first cleans the lisp subdirectory, removing all compiled
894### Lisp files. Then re-run make to build all the files anew.
895
896.PHONY: bootstrap
897
000d802e 898## configure; make bootstrap replaces the real config.log from configure
773233f8 899## with the truncated one from config.status. The former is more useful.
067d23c9
KY
900bootstrap: bootstrap-clean FRC
901 if [ -x ./config.status ]; then \
902 ./config.status; \
903 else \
6c269a38 904 ./configure $(CONFIGURE_FLAGS); \
067d23c9
KY
905 fi
906 $(MAKE) $(MFLAGS) info all
907
908.PHONY: check-declare
909
910check-declare:
4f8c52a9 911 @if [ ! -f $(srcdir)/src/emacs ]; then \
067d23c9
KY
912 echo "You must build Emacs to use this command"; \
913 exit 1; \
914 fi
915 (cd leim; $(MAKE) $(MFLAGS) $@)
916 (cd lisp; $(MAKE) $(MFLAGS) $@)