Fix typos in comments. Use xassert.
[emacs.git] / Makefile.in
bloba8cdd6a901d4bb08e74043c2cf7a91eec96b47bd
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.
5 # Copyright (C) 1992-2011 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/>.
22 ### Commentary:
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
33 # with them.
35 # Delete `.dvi' files here if they are not part of the distribution.
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.
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.
51 # make extraclean
52 # Still more severe - delete backup and autosave files, too.
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.
58 SHELL = /bin/sh
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.
62 CDPATH=
64 # If Make doesn't predefine MAKE, set it here.
65 @SET_MAKE@
67 # ==================== Things `configure' Might Edit ====================
69 CC=@CC@
70 CFLAGS=@CFLAGS@
71 LDFLAGS=@LDFLAGS@
72 CPPFLAGS=@CPPFLAGS@
73 EXEEXT=@EXEEXT@
75 ### These help us choose version- and architecture-specific directories
76 ### to install files in.
78 ### This should be the number of the Emacs version we're building,
79 ### like `18.59' or `19.0'.
80 version=@version@
82 ### This should be the name of the configuration we're building Emacs
83 ### for, like `mips-dec-ultrix' or `sparc-sun-sunos'.
84 configuration=@configuration@
86 # ==================== Where To Install Things ====================
88 # The default location for installation. Everything is placed in
89 # subdirectories of this directory. The default values for many of
90 # the variables below are expressed in terms of this one, so you may
91 # not need to change them. This defaults to /usr/local.
92 prefix=@prefix@
94 # Like `prefix', but used for architecture-specific files.
95 exec_prefix=@exec_prefix@
97 # Where to install Emacs and other binaries that people will want to
98 # run directly (like etags).
99 bindir=@bindir@
101 # The root of the directory tree for read-only architecture-independent
102 # data files. ${datadir}, ${infodir} and ${mandir} are based on this.
103 datarootdir=@datarootdir@
105 # Where to install architecture-independent data files. ${lispdir}
106 # and ${etcdir} are subdirectories of this.
107 datadir=@datadir@
109 # Where to install and expect the files that Emacs modifies as it
110 # runs. These files are all architecture-independent.
111 # Right now, this is not used.
112 sharedstatedir=@sharedstatedir@
114 # Where to install and expect executable files to be run by Emacs
115 # rather than directly by users, and other architecture-dependent
116 # data. ${archlibdir} is a subdirectory of this.
117 libexecdir=@libexecdir@
119 # Where to install Emacs's man pages.
120 # This used to allow choice of the numeric extension, but this made
121 # little sense since the files were always installed in man1/
122 # (and they contain cross-references that expect them to be there).
123 mandir=@mandir@
124 man1dir=$(mandir)/man1
125 MAN_PAGES=ctags.1 ebrowse.1 emacs.1 emacsclient.1 etags.1 \
126 grep-changelog.1 rcs-checkin.1
128 # Where to install and expect the info files describing Emacs. In the
129 # past, this defaulted to a subdirectory of ${prefix}/lib/emacs, but
130 # since there are now many packages documented with the texinfo
131 # system, it is inappropriate to imply that it is part of Emacs.
132 infodir=@infodir@
133 INFO_FILES=ada-mode auth autotype calc ccmode cl dbus dired-x ebrowse \
134 ede ediff edt eieio efaq eintr elisp emacs emacs-mime epa erc \
135 ert eshell eudc flymake forms gnus idlwave info mairix-el \
136 message mh-e newsticker nxml-mode org pcl-cvs pgg rcirc \
137 reftex remember sasl sc semantic ses sieve smtpmail speedbar \
138 tramp url vip viper widget woman
140 # If no makeinfo was found and configured --without-makeinfo, "no"; else "yes".
141 HAVE_MAKEINFO=@HAVE_MAKEINFO@
143 # Directory for local state files for all programs.
144 localstatedir=@localstatedir@
146 # Where to look for bitmap files.
147 bitmapdir=@bitmapdir@
149 # Where to find the source code. The source code for Emacs's C kernel is
150 # expected to be in ${srcdir}/src, and the source code for Emacs's
151 # utility programs is expected to be in ${srcdir}/lib-src. This is
152 # set by the configure script's `--srcdir' option.
154 # We use $(srcdir) explicitly in dependencies so as not to depend on VPATH.
155 srcdir=@srcdir@
157 # Where the manpage source files are kept.
158 mansrcdir=$(srcdir)/doc/man
160 # Tell make where to find source files; this is needed for the makefiles.
161 VPATH=@srcdir@
163 # Where to find the application default.
164 x_default_search_path=@x_default_search_path@
166 # Location to install Emacs.app under NeXT/Open/GNUstep / Cocoa
167 ns_appbindir=@ns_appbindir@
168 ns_appresdir=@ns_appresdir@
170 # Where the etc/emacs.desktop file is to be installed.
171 desktopdir=$(datarootdir)/applications
173 # Where the etc/images/icons/hicolor directory is to be installed.
174 icondir=$(datarootdir)/icons
176 # The source directory for the icon files.
177 iconsrcdir=$(srcdir)/etc/images/icons
179 # ==================== Emacs-specific directories ====================
181 # These variables hold the values Emacs will actually use. They are
182 # based on the values of the standard Make variables above.
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.
188 lispdir=@lispdir@
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.
194 locallisppath=@locallisppath@
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.
200 lisppath=@lisppath@
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.
206 # It's usually identical to lisppath, except that
207 # it does not include locallisppath, and the
208 # entry for the directory containing the installed lisp
209 # files has been replaced with ../lisp. This should be a
210 # colon-separated list of directories.
211 buildlisppath=${srcdir}/lisp
213 # Where to install the other architecture-independent
214 # data files distributed with Emacs (like the tutorial,
215 # the cookie recipes and the Zippy database). This path
216 # usually contains the Emacs version number, so the data
217 # files for multiple versions of Emacs may be installed
218 # at once.
219 etcdir=@etcdir@
221 # Where to put executables to be run by Emacs rather than
222 # the user. This path usually includes the Emacs version
223 # and configuration name, so that multiple configurations
224 # for multiple versions of Emacs may be installed at
225 # once.
226 archlibdir=@archlibdir@
228 # Where to put the docstring file.
229 docdir=@docdir@
231 # Where to install Emacs game score files.
232 gamedir=@gamedir@
234 # ==================== Utility Programs for the Build ====================
236 # Allow the user to specify the install program.
237 INSTALL = @INSTALL@
238 INSTALL_PROGRAM = @INSTALL_PROGRAM@
239 INSTALL_DATA = @INSTALL_DATA@
240 INSTALL_INFO = @INSTALL_INFO@
241 # By default, we uphold the dignity of our programs.
242 INSTALL_STRIP =
244 # We use gzip to compress installed .el files.
245 GZIP_PROG = @GZIP_PROG@
246 # If non-nil, gzip the installed Info and man pages.
247 GZIP_INFO = @GZIP_INFO@
249 # ============================= Targets ==============================
251 # Program name transformation.
252 TRANSFORM = @program_transform_name@
254 # What emacs should be called when installed.
255 EMACS = `echo emacs${EXEEXT} | sed '$(TRANSFORM)'`
256 EMACSFULL = `echo emacs-${version}${EXEEXT} | sed '$(TRANSFORM)'`
258 # Subdirectories to make recursively. `lisp' is not included
259 # because the compiled lisp files are part of the distribution.
260 # leim is not included because it needs special handling.
262 # Actually, we now include `lisp' as well, since the compiled files
263 # are not included any more in case of bootstrap or in case Emacs was
264 # checked out from a VCS.
265 SUBDIR = lib lib-src src lisp
267 # The subdir makefiles created by config.status.
268 SUBDIR_MAKEFILES = lib/Makefile lib-src/Makefile doc/emacs/Makefile doc/misc/Makefile doc/lispref/Makefile doc/lispintro/Makefile src/Makefile oldXMenu/Makefile lwlib/Makefile leim/Makefile lisp/Makefile test/automated/Makefile
270 # Subdirectories to install, and where they'll go.
271 # lib-src's makefile knows how to install it, so we don't do that here.
272 # leim's makefile also knows how to install it, so we don't do that here.
273 # When installing the info files, we need to do special things to
274 # avoid nuking an existing dir file, so we don't do that here;
275 # instead, we have written out explicit code in the `install' targets.
276 COPYDIR = ${srcdir}/etc ${srcdir}/lisp
277 COPYDESTS = $(DESTDIR)${etcdir} $(DESTDIR)${lispdir}
279 all: ${SUBDIR} leim
281 removenullpaths=sed -e 's/^://g' -e 's/:$$//g' -e 's/::/:/g'
283 # Generate epaths.h from epaths.in. This target is invoked by `configure'.
284 # See comments in configure.in for why it is done this way, as opposed
285 # to just letting configure generate epaths.h from epaths.in in a
286 # similar way to how Makefile is made from Makefile.in.
287 epaths-force: FRC
288 @(lisppath=`echo ${lisppath} | ${removenullpaths}` ; \
289 buildlisppath=`echo ${buildlisppath} | ${removenullpaths}` ; \
290 x_default_search_path=`echo ${x_default_search_path}`; \
291 gamedir=`echo ${gamedir}`; \
292 sed < ${srcdir}/src/epaths.in > epaths.h.$$$$ \
293 -e 's;\(#.*PATH_LOADSEARCH\).*$$;\1 "'"$${lisppath}"'";' \
294 -e 's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "'"$${buildlisppath}"'";' \
295 -e 's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";' \
296 -e 's;\(#.*PATH_INFO\).*$$;\1 "${infodir}";' \
297 -e 's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";' \
298 -e 's;\(#.*PATH_BITMAPS\).*$$;\1 "${bitmapdir}";' \
299 -e 's;\(#.*PATH_X_DEFAULTS\).*$$;\1 "${x_default_search_path}";' \
300 -e 's;\(#.*PATH_GAME\).*$$;\1 "${gamedir}";' \
301 -e 's;\(#.*PATH_DOC\).*$$;\1 "${docdir}";') && \
302 ${srcdir}/move-if-change epaths.h.$$$$ src/epaths.h
304 # For parallel make, src should be built before leim.
305 # "export PARALLEL=0" is for SGI's Make, to prevent it from
306 # running more than 1 process in the leim directory, especially for
307 # the $TIT files there.
308 leim: src Makefile FRC
309 (export PARALLEL; PARALLEL=0; cd $@; $(MAKE) all $(MFLAGS) \
310 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
311 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}')
313 lib-src src: lib
315 src: lib-src FRC
317 .RECURSIVE: ${SUBDIR} leim
319 # We need to build `emacs' in `src' to compile the *.elc files in `lisp'.
320 lisp: src
322 # Maintainers can put a copy of gnulib into $(gnulib_srcdir).
323 gnulib_srcdir = ../gnulib
324 $(gnulib_srcdir):
325 git clone git://git.savannah.gnu.org/gnulib.git $@
327 # A shorter name that satisfies MS-DOS 8+3 constraints.
328 DOS_gnulib_comp.m4 = gl-comp.m4
330 # Update modules from gnulib, for maintainers, who should have it in
331 # $(gnulib_srcdir) (relative to $(srcdir) and should have build tools
332 # as per $(gnulib_srcdir)/DEPENDENCIES.
333 GNULIB_MODULES = \
334 careadlinkat crypto/md5 dtoastr filemode getloadavg getopt-gnu \
335 ignore-value intprops lstat mktime readlink \
336 socklen stdarg stdio strftime strtoumax symlink sys_stat
337 GNULIB_TOOL_FLAGS = \
338 --conditional-dependencies --import --no-changelog --no-vc-files \
339 --makefile-name=gnulib.mk
340 sync-from-gnulib: $(gnulib_srcdir)
341 -cd $(srcdir)/m4 && cp $(DOS_gnulib_comp.m4) gnulib-comp.m4
342 cd $(srcdir) && \
343 $(gnulib_srcdir)/gnulib-tool $(GNULIB_TOOL_FLAGS) $(GNULIB_MODULES)
344 cd $(srcdir)/m4 && rm gnulib-cache.m4 warn-on-use.m4
345 cd $(srcdir)/m4 && mv gnulib-comp.m4 $(DOS_gnulib_comp.m4)
346 cp $(gnulib_srcdir)/build-aux/texinfo.tex $(srcdir)/doc/misc
347 cp \
348 $(gnulib_srcdir)/build-aux/move-if-change \
349 $(srcdir)
350 cd $(srcdir) && autoreconf -i -I m4
351 .PHONY: sync-from-gnulib
353 # These targets should be "${SUBDIR} without `src'".
354 lib lib-src lisp: Makefile FRC
355 cd $@; $(MAKE) all $(MFLAGS) \
356 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
357 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}'
359 # Pass to src/Makefile.in an additional BOOTSTRAPEMACS variable which
360 # is either set to bootstrap-emacs (in case bootstrap-emacs has not been
361 # constructed yet) or the empty string (otherwise).
362 # src/Makefile.in uses it to implement conditional dependencies, so that
363 # files that need bootstrap-emacs to be built do not additionally need
364 # to be kept fresher than bootstrap-emacs. Otherwise changing a single
365 # file src/foo.c forces dumping a new bootstrap-emacs, then re-byte-compiling
366 # all preloaded elisp files, and only then dump the actual src/emacs, which
367 # is not wrong, but is overkill in 99.99% of the cases.
368 src: Makefile FRC
369 boot=bootstrap-emacs$(EXEEXT); \
370 if [ ! -x "src/$$boot" ]; then \
371 cd $@; $(MAKE) all $(MFLAGS) \
372 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
373 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="$$boot"; \
375 if [ -r .bzr/checkout/dirstate ]; then \
376 vcswitness="$$(pwd)/.bzr/checkout/dirstate"; \
377 fi; \
378 cd $@; $(MAKE) all $(MFLAGS) \
379 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
380 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="" \
381 VCSWITNESS="$$vcswitness"
383 blessmail: Makefile src FRC
384 cd lib-src; $(MAKE) maybe-blessmail $(MFLAGS) \
385 MAKE='${MAKE}' archlibdir='$(archlibdir)'
387 # We used to have one rule per */Makefile.in, but that leads to race
388 # conditions with parallel makes, so let's assume that the time stamp on
389 # ./Makefile is representative of the time stamp on all the other Makefiles.
390 Makefile: config.status $(srcdir)/src/config.in \
391 $(srcdir)/Makefile.in \
392 $(srcdir)/src/Makefile.in \
393 $(srcdir)/lib/Makefile.in \
394 $(srcdir)/lib-src/Makefile.in \
395 $(srcdir)/doc/emacs/Makefile.in \
396 $(srcdir)/doc/misc/Makefile.in \
397 $(srcdir)/doc/lispref/Makefile.in \
398 $(srcdir)/doc/lispintro/Makefile.in \
399 $(srcdir)/oldXMenu/Makefile.in \
400 $(srcdir)/lwlib/Makefile.in \
401 $(srcdir)/leim/Makefile.in \
402 $(srcdir)/lisp/Makefile.in \
403 $(srcdir)/test/automated/Makefile.in
404 ./config.status
406 # Don't erase config.status if make is interrupted while refreshing it.
407 .PRECIOUS: config.status
409 config.status: ${srcdir}/configure ${srcdir}/lisp/version.el
410 if [ -x ./config.status ]; then \
411 ./config.status --recheck; \
412 else \
413 ./configure; \
416 AUTOCONF_INPUTS = @MAINT@ $(srcdir)/configure.in $(srcdir)/aclocal.m4
418 $(srcdir)/configure: $(AUTOCONF_INPUTS)
419 cd ${srcdir} && autoconf
421 ACLOCAL_INPUTS = @MAINT@ $(srcdir)/m4/$(DOS_gnulib_comp.m4)
422 $(srcdir)/aclocal.m4: $(ACLOCAL_INPUTS)
423 cd $(srcdir) && aclocal -I m4
425 AUTOMAKE_INPUTS = @MAINT@ $(srcdir)/aclocal.m4 $(srcdir)/lib/Makefile.am
426 $(srcdir)/lib/Makefile.in: $(AUTOMAKE_INPUTS)
427 cd $(srcdir) && automake --gnu -a -c lib/Makefile
428 am--refresh: $(srcdir)/aclocal.m4 $(srcdir)/configure $(srcdir)/src/config.in
429 .PHONY: am--refresh
431 $(srcdir)/src/config.in: $(srcdir)/src/stamp-h.in
432 @ # Usually, there's no need to rebuild src/config.in just
433 @ # because stamp-h.in has changed (since building stamp-h.in
434 @ # refreshes config.in as well), but if config.in is missing
435 @ # then we really need to do something more.
436 [ -r "$@" ] || ( cd ${srcdir} && autoheader )
437 $(srcdir)/src/stamp-h.in: $(AUTOCONF_INPUTS)
438 cd ${srcdir} && autoheader
439 rm -f $(srcdir)/src/stamp-h.in
440 echo timestamp > $(srcdir)/src/stamp-h.in
442 # ==================== Installation ====================
444 ## If we let lib-src do its own installation, that means we
445 ## don't have to duplicate the list of utilities to install in
446 ## this Makefile as well.
448 ## On AIX, use tar xBf.
449 ## On Xenix, use tar xpf.
451 .PHONY: install mkdir
453 ## We delete each directory in ${COPYDESTS} before we copy into it;
454 ## that way, we can reinstall over directories that have been put in
455 ## place with their files read-only (perhaps because they are checked
456 ## into RCS). In order to make this safe, we make sure that the
457 ## source exists and is distinct from the destination.
458 ### We do install-arch-indep first because
459 ### the executable needs the Lisp files and DOC file to work properly.
460 install: all install-arch-indep install-arch-dep install-leim blessmail
461 @true
463 MV_DIRS = for i in $$dir; do rm -fr `basename "$$i"` ; mv "$$i" . ; done
465 ### Install the executables that were compiled specifically for this machine.
466 ### It would be nice to do something for a parallel make
467 ### to ensure that install-arch-indep finishes before this starts.
468 install-arch-dep: mkdir
469 (cd lib-src; \
470 $(MAKE) install $(MFLAGS) prefix=${prefix} \
471 exec_prefix=${exec_prefix} bindir=${bindir} \
472 libexecdir=${libexecdir} archlibdir=${archlibdir} \
473 INSTALL_STRIP=${INSTALL_STRIP})
474 ${INSTALL_PROGRAM} $(INSTALL_STRIP) src/emacs${EXEEXT} $(DESTDIR)${bindir}/$(EMACSFULL)
475 -chmod 1755 $(DESTDIR)${bindir}/$(EMACSFULL)
476 rm -f $(DESTDIR)${bindir}/$(EMACS)
477 -ln $(DESTDIR)${bindir}/$(EMACSFULL) $(DESTDIR)${bindir}/$(EMACS)
478 if test "${ns_appresdir}" != ""; then \
479 ( cd ${ns_appresdir} ; \
480 if test -d share/emacs ; then dir=share/emacs/*/*; $(MV_DIRS); fi;\
481 if test -d share/info ; then dir=share/info; $(MV_DIRS) ; fi ; \
482 rm -fr share ) ; \
483 ( cd ${ns_appbindir}libexec ; dir=emacs/*/*/* ; $(MV_DIRS); \
484 rm -fr emacs ) ; \
485 ( cd ${ns_appbindir}bin ; rm -f emacs emacs-24* ; \
486 ln -sf ../libexec/* .) ; \
487 else true ; fi
489 ## FIXME is the emacs-24* bit above really necessary and correct?
490 ## What if I have 24.1 and 24.2 installed at the same time?
491 ## In any case, it should use something like echo $version | sed 's/\..*//'
492 ## instead of hard-coding a version.
494 ## http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg01672.html
495 ## Needs to be the user running install, so configure can't set it.
496 set_installuser=for installuser in $${LOGNAME} $${USERNAME} $${USER} \
497 `id -un 2> /dev/null`; do \
498 [ -n "$${installuser}" ] && break ; \
499 done
501 ### Install the files that are machine-independent.
502 ### Most of them come straight from the distribution;
503 ### the exception is the DOC-* files, which are copied
504 ### from the build directory.
506 ## Note that we copy DOC* and then delete DOC
507 ## as a workaround for a bug in tar on Ultrix 4.2.
509 ## We install only the relevant DOC file if possible
510 ## (ie DOC-${version}.buildnumber), otherwise DOC-${version}*.
512 ## If people complain about the h flag in tar command, take that out.
513 ## That flag is also used in leim/Makefile.in
515 ## Note that the Makefiles in the etc directory are potentially useful
516 ## in an installed Emacs, so should not be excluded.
518 install-arch-indep: mkdir info install-etc
519 -set ${COPYDESTS} ; \
520 unset CDPATH; \
521 for dir in ${COPYDIR} ; do \
522 if [ `(cd $$1 && /bin/pwd)` != `(cd $${dir} && /bin/pwd)` ] ; then \
523 rm -rf $$1 ; \
524 fi ; \
525 shift ; \
526 done
527 -set ${COPYDESTS} ; \
528 mkdir ${COPYDESTS} ; \
529 chmod ugo+rx ${COPYDESTS} ; \
530 unset CDPATH; \
531 $(set_installuser); \
532 for dir in ${COPYDIR} ; do \
533 dest=$$1 ; shift ; \
534 [ -d $${dir} ] \
535 && [ `(cd $${dir} && /bin/pwd)` != `(cd $${dest} && /bin/pwd)` ] \
536 && (echo "Copying $${dir} to $${dest}..." ; \
537 (cd $${dir}; tar -chf - . ) \
538 | (cd $${dest}; umask 022; \
539 tar -xvf - && cat > /dev/null) || exit 1; \
540 find $${dest} -exec chown $${installuser} {} ';' ;\
541 for subdir in `find $${dest} -type d -print` ; do \
542 chmod a+rx $${subdir} ; \
543 rm -f $${subdir}/.gitignore ; \
544 rm -f $${subdir}/.arch-inventory ; \
545 rm -f $${subdir}/.DS_Store ; \
546 rm -f $${subdir}/\#* ; \
547 rm -f $${subdir}/.\#* ; \
548 rm -f $${subdir}/*~ ; \
549 rm -f $${subdir}/*.orig ; \
550 [ "$${dir}" != "${srcdir}/etc" ] && \
551 rm -f $${subdir}/[mM]akefile*.c $${subdir}/[mM]akefile*[.-]in \
552 $${subdir}/[mM]akefile ; \
553 rm -f $${subdir}/ChangeLog* ; \
554 done) ; \
555 done
556 -rm -f $(DESTDIR)${lispdir}/subdirs.el
557 $(srcdir)/update-subdirs $(DESTDIR)${lispdir}
558 if [ -f $(DESTDIR)${datadir}/emacs/${version}/site-lisp/subdirs.el ]; \
559 then true; \
560 else \
561 (echo "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
562 echo " (normal-top-level-add-subdirs-to-load-path))") \
563 > $(DESTDIR)${datadir}/emacs/${version}/site-lisp/subdirs.el; \
565 chmod a+r $(DESTDIR)${datadir}/emacs/${version}/site-lisp/subdirs.el
566 -if [ -f $(DESTDIR)${datadir}/emacs/site-lisp/subdirs.el ]; \
567 then true; \
568 else \
569 (echo "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
570 echo " (normal-top-level-add-subdirs-to-load-path))") \
571 > $(DESTDIR)${datadir}/emacs/site-lisp/subdirs.el; \
573 -chmod a+r $(DESTDIR)${datadir}/emacs/site-lisp/subdirs.el
574 -unset CDPATH; \
575 if [ `(cd ./etc; /bin/pwd)` != `(cd $(DESTDIR)${docdir}; /bin/pwd)` ]; \
576 then \
577 fullversion=`./src/emacs --version | sed -n '1 s/GNU Emacs *//p'`; \
578 if [ -f "./etc/DOC-$${fullversion}" ]; \
579 then \
580 docfile="DOC-$${fullversion}"; \
581 else \
582 docfile="DOC"; \
583 fi; \
584 echo "Copying etc/$${docfile} to $(DESTDIR)${docdir} ..." ; \
585 (cd ./etc; tar -chf - $${docfile}) \
586 |(cd $(DESTDIR)${docdir}; umask 022; tar -xvf - && cat > /dev/null) || exit 1; \
587 (cd $(DESTDIR)$(docdir); \
588 $(set_installuser); \
589 chown $${installuser} DOC*; chmod a+r DOC*; \
590 if test "`echo DOC-*`" != "DOC-*"; then rm -f DOC; fi); \
591 else true; fi
592 -unset CDPATH; \
593 if [ -r ./lisp ] \
594 && [ -r ./lisp/simple.el ] \
595 && [ x`(cd ./lisp; /bin/pwd)` != x`(cd $(DESTDIR)${lispdir}; /bin/pwd)` ] \
596 && [ x`(cd ${srcdir}/lisp; /bin/pwd)` != x`(cd ./lisp; /bin/pwd)` ]; \
597 then \
598 echo "Copying lisp/*.el and lisp/*.elc to $(DESTDIR)${lispdir} ..." ; \
599 (cd lisp; tar -chf - *.el *.elc) \
600 |(cd $(DESTDIR)${lispdir}; umask 022; tar -xvf - && cat > /dev/null) || exit 1; \
601 (cd $(DESTDIR)${lispdir}; \
602 $(set_installuser); \
603 find . -exec chown $${installuser} {} ';') ; \
604 else true; fi
605 -unset CDPATH; \
606 if [ -n "${GZIP_PROG}" ]; \
607 then \
608 echo "Compressing *.el ..." ; \
609 (cd $(DESTDIR)${lispdir}; for f in `find . -name "*.elc" -print`; do \
610 ${GZIP_PROG} -9n `echo $$f|sed 's/.elc$$/.el/'` ; \
611 done) \
612 else true; fi
613 -unset CDPATH; \
614 thisdir=`/bin/pwd`; \
615 if [ `(cd ${srcdir}/info && /bin/pwd)` != `(cd $(DESTDIR)${infodir} && /bin/pwd)` ]; \
616 then \
617 (cd $(DESTDIR)${infodir}; \
618 if [ -f dir ]; then true; \
619 else \
620 (cd $${thisdir}; \
621 ${INSTALL_DATA} ${srcdir}/info/dir $(DESTDIR)${infodir}/dir; \
622 chmod a+r $(DESTDIR)${infodir}/dir); \
623 fi; \
624 cd ${srcdir}/info ; \
625 for elt in $(INFO_FILES); do \
626 test "$(HAVE_MAKEINFO)" = "no" && ! test -e $$elt && continue; \
627 for f in `ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
628 ${INSTALL_DATA} $$f $(DESTDIR)${infodir}/$$f; \
629 chmod a+r $(DESTDIR)${infodir}/$$f; \
630 if [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ]; then \
631 rm -f $(DESTDIR)${infodir}/$$f.gz; \
632 ${GZIP_PROG} -9n $(DESTDIR)${infodir}/$$f; \
633 else true; fi; \
634 done; \
635 done); \
636 else true; fi
637 -unset CDPATH; \
638 thisdir=`/bin/pwd`; \
639 if [ `(cd ${srcdir}/info && /bin/pwd)` != `(cd $(DESTDIR)${infodir} && /bin/pwd)` ]; \
640 then \
641 for elt in $(INFO_FILES); do \
642 test "$(HAVE_MAKEINFO)" = "no" && ! test -e $$elt && continue; \
643 (cd $${thisdir}; \
644 ${INSTALL_INFO} --info-dir=$(DESTDIR)${infodir} $(DESTDIR)${infodir}/$$elt); \
645 done; \
646 else true; fi
647 -chmod -R a+r $(DESTDIR)${datadir}/emacs/${version} ${COPYDESTS}
648 thisdir=`/bin/pwd`; \
649 cd ${mansrcdir}; \
650 for page in ${MAN_PAGES}; do \
651 (cd $${thisdir}; \
652 ${INSTALL_DATA} ${mansrcdir}/$${page} $(DESTDIR)${man1dir}/$${page}; \
653 chmod a+r $(DESTDIR)${man1dir}/$${page}; \
654 if [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ]; then \
655 rm -f $(DESTDIR)${man1dir}/$${page}.gz; \
656 ${GZIP_PROG} -9n $(DESTDIR)${man1dir}/$${page}; \
657 else true; fi ); \
658 done
660 ## Install those items from etc/ that need to end up elsewhere.
661 install-etc: mkdir
662 ${INSTALL_DATA} ${srcdir}/etc/emacs.desktop \
663 $(DESTDIR)${desktopdir}/emacs.desktop
664 for icon in $(iconsrcdir)/*/*/apps/*.* \
665 $(iconsrcdir)/*/*/mimetypes/*.*; do \
666 if [ -r $${icon} ]; then \
667 iicon=`echo "$${icon}" | sed 's,$(srcdir)/etc/images/icons,$(DESTDIR)${icondir},'` ; \
668 ${INSTALL_DATA} $${icon} $${iicon} ; \
669 fi ; \
670 done
672 ### Install LEIM files. Although they are machine-independent, we
673 ### have separate target here instead of including it in
674 ### `install-arch-indep'. People who extracted LEIM files after they
675 ### insalled Emacs itself can install only LEIM files by this target.
676 install-leim: leim/Makefile mkdir
677 cd leim; $(MAKE) install
679 ### Build Emacs and install it, stripping binaries while installing them.
680 install-strip:
681 $(MAKE) INSTALL_STRIP=-s install
683 ### Build all the directories we're going to install Emacs in. Since
684 ### we may be creating several layers of directories (for example,
685 ### /usr/local/lib/emacs/19.0/mips-dec-ultrix4.2), we use install-sh -d
686 ### instead of mkdir. Not all systems' mkdir programs have the `-p' flag.
687 ### We set the umask so that any created directories are world-readable.
688 ### FIXME it would be good to warn about non-standard permissions of
689 ### pre-existing directories, but that does not seem easy.
690 mkdir: FRC
691 icondirs= ; \
692 for dir in $(iconsrcdir)/*/*/apps $(iconsrcdir)/*/*/mimetypes; do \
693 if [ -d $${dir} ]; then \
694 icondirs="$${icondirs} $${dir}" ; \
695 fi ; \
696 done ; \
697 icondirs=`echo "$${icondirs}" | sed 's,$(srcdir)/etc/images/icons,$(DESTDIR)${icondir},g'` ; \
698 umask 022 ; \
699 $(srcdir)/install-sh -d $(DESTDIR)${datadir} ${COPYDESTS} \
700 $(DESTDIR)${infodir} $(DESTDIR)${man1dir} \
701 $(DESTDIR)${bindir} $(DESTDIR)${docdir} $(DESTDIR)${libexecdir} \
702 $(DESTDIR)${datadir}/emacs/site-lisp \
703 $(DESTDIR)${datadir}/emacs/${version}/site-lisp \
704 $(DESTDIR)`echo ${locallisppath} | sed 's,:, $(DESTDIR),g'` \
705 $(DESTDIR)${desktopdir} $${icondirs}
707 ### Delete all the installed files that the `install' target would
708 ### create (but not the noninstalled files such as `make all' would create).
710 ### Don't delete the lisp and etc directories if they're in the source tree.
711 uninstall:
712 (cd lib-src; \
713 $(MAKE) $(MFLAGS) uninstall \
714 prefix=${prefix} exec_prefix=${exec_prefix} \
715 bindir=${bindir} libexecdir=${libexecdir} archlibdir=${archlibdir})
716 -unset CDPATH; \
717 for dir in $(DESTDIR)${lispdir} $(DESTDIR)${etcdir} ; do \
718 if [ -d $${dir} ]; then \
719 case `(cd $${dir} ; /bin/pwd)` in \
720 `(cd ${srcdir} ; /bin/pwd)`* ) ;; \
721 * ) rm -rf $${dir} ;; \
722 esac ; \
723 case $${dir} in \
724 $(DESTDIR)${datadir}/emacs/${version}/* ) \
725 rm -rf $(DESTDIR)${datadir}/emacs/${version} \
726 ;; \
727 esac ; \
728 fi ; \
729 done
730 -rm -rf $(DESTDIR)${libexecdir}/emacs/${version}
731 (cd $(DESTDIR)${infodir} && \
732 for elt in $(INFO_FILES); do \
733 $(INSTALL_INFO) --remove --info-dir=. $$elt; \
734 for f in `ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
735 rm -f $$f; \
736 done; \
737 done;)
738 (cd $(DESTDIR)${man1dir} && rm -f $(MAN_PAGES))
739 (cd $(DESTDIR)${bindir} && rm -f $(EMACSFULL) $(EMACS))
740 (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 )
741 -rm -f $(DESTDIR)${desktopdir}/emacs.desktop
742 for file in snake-scores tetris-scores; do \
743 file=$(DESTDIR)${gamedir}/$${file}; \
744 [ -s $${file} ] || rm -f $$file; \
745 done
747 FRC:
749 # ==================== Cleaning up and miscellanea ====================
751 .PHONY: mostlyclean clean distclean maintainer-clean extraclean
753 ### `mostlyclean'
754 ### Like `clean', but may refrain from deleting a few files that people
755 ### normally don't want to recompile. For example, the `mostlyclean'
756 ### target for GCC does not delete `libgcc.a', because recompiling it
757 ### is rarely necessary and takes a lot of time.
758 mostlyclean: FRC
759 (cd src; $(MAKE) $(MFLAGS) mostlyclean)
760 (cd oldXMenu; $(MAKE) $(MFLAGS) mostlyclean)
761 (cd lwlib; $(MAKE) $(MFLAGS) mostlyclean)
762 (cd lib; $(MAKE) $(MFLAGS) mostlyclean)
763 (cd lib-src; $(MAKE) $(MFLAGS) mostlyclean)
764 -(cd doc/emacs && $(MAKE) $(MFLAGS) mostlyclean)
765 -(cd doc/misc && $(MAKE) $(MFLAGS) mostlyclean)
766 -(cd doc/lispref && $(MAKE) $(MFLAGS) mostlyclean)
767 -(cd doc/lispintro && $(MAKE) $(MFLAGS) mostlyclean)
768 (cd leim; $(MAKE) $(MFLAGS) mostlyclean)
770 ### `clean'
771 ### Delete all files from the current directory that are normally
772 ### created by building the program. Don't delete the files that
773 ### record the configuration. Also preserve files that could be made
774 ### by building, but normally aren't because the distribution comes
775 ### with them.
777 ### Delete `.dvi' files here if they are not part of the distribution.
778 clean: FRC
779 (cd src; $(MAKE) $(MFLAGS) clean)
780 (cd oldXMenu; $(MAKE) $(MFLAGS) clean)
781 (cd lwlib; $(MAKE) $(MFLAGS) clean)
782 (cd lib; $(MAKE) $(MFLAGS) clean)
783 (cd lib-src; $(MAKE) $(MFLAGS) clean)
784 -(cd doc/emacs && $(MAKE) $(MFLAGS) clean)
785 -(cd doc/misc && $(MAKE) $(MFLAGS) clean)
786 -(cd doc/lispref && $(MAKE) $(MFLAGS) clean)
787 -(cd doc/lispintro && $(MAKE) $(MFLAGS) clean)
788 (cd leim; $(MAKE) $(MFLAGS) clean)
790 ### `bootclean'
791 ### Delete all files that need to be remade for a clean bootstrap.
792 top_bootclean=\
793 rm -f config.cache config.log
794 ### `distclean'
795 ### Delete all files from the current directory that are created by
796 ### configuring or building the program. If you have unpacked the
797 ### source and built the program without creating any other files,
798 ### `make distclean' should leave only the files that were in the
799 ### distribution.
800 top_distclean=\
801 ${top_bootclean}; \
802 rm -f config.status config.log~ Makefile stamp-h1 ${SUBDIR_MAKEFILES}
803 distclean: FRC
804 (cd src; $(MAKE) $(MFLAGS) distclean)
805 (cd oldXMenu; $(MAKE) $(MFLAGS) distclean)
806 (cd lwlib; $(MAKE) $(MFLAGS) distclean)
807 (cd lib; $(MAKE) $(MFLAGS) distclean)
808 (cd lib-src; $(MAKE) $(MFLAGS) distclean)
809 (cd doc/emacs && $(MAKE) $(MFLAGS) distclean)
810 (cd doc/misc && $(MAKE) $(MFLAGS) distclean)
811 (cd doc/lispref && $(MAKE) $(MFLAGS) distclean)
812 (cd doc/lispintro && $(MAKE) $(MFLAGS) distclean)
813 (cd leim; $(MAKE) $(MFLAGS) distclean)
814 (cd lisp; $(MAKE) $(MFLAGS) distclean)
815 ${top_distclean}
817 ### `bootstrap-clean'
818 ### Delete everything that can be reconstructed by `make' and that
819 ### needs to be deleted in order to force a bootstrap from a clean state.
820 bootstrap-clean: FRC
821 (cd src; $(MAKE) $(MFLAGS) bootstrap-clean)
822 (cd oldXMenu; $(MAKE) $(MFLAGS) maintainer-clean)
823 (cd lwlib; $(MAKE) $(MFLAGS) maintainer-clean)
824 (cd lib; $(MAKE) $(MFLAGS) maintainer-clean)
825 (cd lib-src; $(MAKE) $(MFLAGS) maintainer-clean)
826 -(cd doc/emacs && $(MAKE) $(MFLAGS) maintainer-clean)
827 -(cd doc/misc && $(MAKE) $(MFLAGS) maintainer-clean)
828 -(cd doc/lispref && $(MAKE) $(MFLAGS) maintainer-clean)
829 -(cd doc/lispintro && $(MAKE) $(MFLAGS) maintainer-clean)
830 (cd leim; $(MAKE) $(MFLAGS) maintainer-clean)
831 (cd lisp; $(MAKE) $(MFLAGS) bootstrap-clean)
832 [ ! -e config.log ] || mv -f config.log config.log~
833 ${top_bootclean}
834 ## configure; make bootstrap replaces the real config.log from configure
835 ## with the truncated one from config.status. The former is more useful.
837 ### `maintainer-clean'
838 ### Delete everything from the current directory that can be
839 ### reconstructed with this Makefile. This typically includes
840 ### everything deleted by distclean, plus more: C source files
841 ### produced by Bison, tags tables, info files, and so on.
843 ### One exception, however: `make maintainer-clean' should not delete
844 ### `configure' even if `configure' can be remade using a rule in the
845 ### Makefile. More generally, `make maintainer-clean' should not delete
846 ### anything that needs to exist in order to run `configure' and then
847 ### begin to build the program.
848 top_maintainer_clean=\
849 ${top_distclean}; \
850 rm -fr autom4te.cache
851 maintainer-clean: bootstrap-clean FRC
852 (cd src; $(MAKE) $(MFLAGS) maintainer-clean)
853 (cd lisp; $(MAKE) $(MFLAGS) maintainer-clean)
854 ${top_maintainer_clean}
856 ### This doesn't actually appear in the coding standards, but Karl
857 ### says GCC supports it, and that's where the configuration part of
858 ### the coding standards seem to come from. It's like distclean, but
859 ### it deletes backup and autosave files too.
860 extraclean:
861 for i in ${SUBDIR} leim; do (cd $$i; $(MAKE) $(MFLAGS) extraclean); done
862 ${top_maintainer_clean}
863 -rm -f config-tmp-*
864 -rm -f *~ \#*
866 # The src subdir knows how to do the right thing
867 # even when the build directory and source dir are different.
868 TAGS tags: lib lib-src src
869 cd src; $(MAKE) tags
871 check:
872 cd test/automated; $(MAKE) check
874 dist:
875 cd ${srcdir}; ./make-dist
877 .PHONY: info dvi dist check html
879 info-real:
880 (cd doc/emacs; $(MAKE) $(MFLAGS) info)
881 (cd doc/misc; $(MAKE) $(MFLAGS) info)
882 (cd doc/lispref; $(MAKE) $(MFLAGS) info)
883 (cd doc/lispintro; $(MAKE) $(MFLAGS) info)
885 force-info:
886 # Note that man/Makefile knows how to put the info files in $(srcdir),
887 # so we can do ok running make in the build dir.
888 # This used to have a clause that exited with an error if MAKEINFO = no.
889 # But it is inappropriate to do so without checking if makeinfo is
890 # actually needed - it is not if the info files are up-to-date. (Bug#3982)
891 # Only the doc/*/Makefiles can decide that, so we let those rules run
892 # and give a standard error if makeinfo is needed but missing.
893 # While it would be nice to give a more detailed error message, that
894 # would require changing every rule in doc/ that builds an info file,
895 # and it's not worth it. This case is only relevant if you download a
896 # release, then change the .texi files.
897 info: force-info
898 @if test "$(HAVE_MAKEINFO)" = "no"; then \
899 echo "Configured --without-makeinfo, not building manuals" ; \
900 else \
901 $(MAKE) $(MFLAGS) info-real ; \
904 # The info/dir file must be updated by hand when new manuals are added.
905 check-info-dir: info
906 cd info ; \
907 missing= ; \
908 for file in *; do \
909 test -f "$${file}" || continue ; \
910 case $${file} in \
911 *-[0-9]*|COPYING|dir) continue ;; \
912 esac ; \
913 grep -q -F ": ($${file})." dir || missing="$${missing} $${file}" ; \
914 done ; \
915 if test -n "$${missing}"; then \
916 echo "Missing info/dir entries: $${missing}" ; \
917 exit 1 ; \
918 fi ; \
919 echo "info/dir is OK"
921 dvi:
922 (cd doc/emacs; $(MAKE) $(MFLAGS) dvi)
923 (cd doc/misc; $(MAKE) $(MFLAGS) dvi)
924 (cd doc/lispref; $(MAKE) $(MFLAGS) elisp.dvi)
925 (cd doc/lispintro; $(MAKE) $(MFLAGS) emacs-lisp-intro.dvi)
927 #### Bootstrapping.
929 ### This first cleans the lisp subdirectory, removing all compiled
930 ### Lisp files. Then re-run make to build all the files anew.
932 .PHONY: bootstrap
934 ## configure; make bootstrap replaces the real config.log from configure
935 ## with the truncated one from config.status. The former is more useful.
936 bootstrap: bootstrap-clean FRC
937 if [ -x ./config.status ]; then \
938 ./config.status; \
939 else \
940 ./configure --enable-maintainer-mode; \
942 $(MAKE) $(MFLAGS) info all
944 .PHONY: check-declare
946 check-declare:
947 @if [ ! -e $(srcdir)/src/emacs ]; then \
948 echo "You must build Emacs to use this command"; \
949 exit 1; \
951 (cd leim; $(MAKE) $(MFLAGS) $@)
952 (cd lisp; $(MAKE) $(MFLAGS) $@)