Merge from trunk.
[emacs.git] / Makefile.in
blob13b452d30d1dadc642a74920d9fc5d62680e36f7
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-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/>.
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 # make docs
59 # Make Emacs documentation files from their sources; requires makeinfo.
61 SHELL = /bin/sh
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.
65 CDPATH=
67 # If Make doesn't predefine MAKE, set it here.
68 @SET_MAKE@
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)
79 CC=@CC@
80 CFLAGS=@CFLAGS@
81 LDFLAGS=@LDFLAGS@
82 CPPFLAGS=@CPPFLAGS@
83 EXEEXT=@EXEEXT@
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'.
90 version=@version@
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
97 NTDIR=@NTDIR@
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.
112 prefix=@prefix@
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).
119 bindir=@bindir@
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.
127 datadir=@datadir@
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.
143 mandir=@mandir@
144 man1dir=$(mandir)/man1
146 # Where to install and expect the info files describing Emacs.
147 infodir=@infodir@
148 # Info files not in the doc/misc directory (we get those via make echo-info).
149 INFO_EXT=@INFO_EXT@
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.
167 srcdir=@srcdir@
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.
173 VPATH=@srcdir@
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.
196 lispdir=@lispdir@
197 leimdir=@leimdir@
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}.
213 lisppath=@lisppath@
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
228 # at once.
229 etcdir=@etcdir@
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
235 # once.
236 archlibdir=@archlibdir@
238 # Where to put the docstring file.
239 docdir=@docdir@
241 # Where to install Emacs game score files.
242 gamedir=@gamedir@
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.
252 INSTALL = @INSTALL@
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.
257 INSTALL_STRIP =
258 MKDIR_P = @MKDIR_P@
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
288 # exists twice.
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
292 all: ${SUBDIR}
294 .PHONY: all ${SUBDIR} blessmail epaths-force epaths-force-w32 FRC
296 removenullpaths=sed -e 's/^://g' -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.
302 epaths-force: FRC
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 file name into x:/foo that Windows can grok.
322 msys_to_w32=sed -e 's,^/\([A-Za-z]\)/,\1:/,'
324 # The w32 build needs a slightly different editing, and it uses
325 # nt/epaths.nt as the template.
326 epaths-force-w32: FRC
327 @(w32srcdir=`echo "${srcdir}" | ${msys_to_w32}` ; \
328 sed < ${srcdir}/nt/epaths.nt > epaths.h.$$$$ \
329 -e '/^.*#/s/@VER@/${version}/g' \
330 -e '/^.*#/s/@CFG@/${configuration}/g' \
331 -e "/^.*#/s|@SRC@|$${w32srcdir}|g") && \
332 ${srcdir}/build-aux/move-if-change epaths.h.$$$$ src/epaths.h
334 lib-src src: $(NTDIR) lib
336 src: lib-src FRC
338 # We need to build `emacs' in `src' to compile the *.elc files in `lisp'
339 # and `leim'.
340 lisp leim: src
342 # These targets should be "${SUBDIR} without `src'".
343 lib lib-src lisp leim nt: Makefile FRC
344 cd $@ && $(MAKE) all $(MFLAGS) \
345 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
346 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}'
348 # Pass to src/Makefile.in an additional BOOTSTRAPEMACS variable which
349 # is either set to bootstrap-emacs (in case bootstrap-emacs has not been
350 # constructed yet) or the empty string (otherwise).
351 # src/Makefile.in uses it to implement conditional dependencies, so that
352 # files that need bootstrap-emacs to be built do not additionally need
353 # to be kept fresher than bootstrap-emacs. Otherwise changing a single
354 # file src/foo.c forces dumping a new bootstrap-emacs, then re-byte-compiling
355 # all preloaded elisp files, and only then dump the actual src/emacs, which
356 # is not wrong, but is overkill in 99.99% of the cases.
357 src: Makefile FRC
358 boot=bootstrap-emacs$(EXEEXT); \
359 if [ ! -x "src/$$boot" ]; then \
360 cd $@; $(MAKE) all $(MFLAGS) \
361 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
362 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="$$boot"; \
364 if [ -r .bzr/checkout/dirstate ]; then \
365 vcswitness="`pwd`/.bzr/checkout/dirstate"; \
366 fi; \
367 cd $@; $(MAKE) all $(MFLAGS) \
368 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
369 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="" \
370 VCSWITNESS="$$vcswitness"
372 blessmail: Makefile src FRC
373 cd lib-src && $(MAKE) maybe-blessmail $(MFLAGS) \
374 MAKE='${MAKE}' archlibdir='$(archlibdir)'
376 # We used to have one rule per */Makefile.in, but that leads to race
377 # conditions with parallel makes, so let's assume that the time stamp on
378 # ./Makefile is representative of the time stamp on all the other Makefiles.
380 # config.status overrides MAKEFILE_NAME with a bogus name when creating
381 # src/epaths.h, so that 'make epaths-force' does not recursively invoke
382 # config.status and overwrite config.status while executing it (Bug#11214).
384 # 'make bootstrap' overrides MAKEFILE_NAME to a nonexistent file but
385 # then attempts to build that file. This forces 'Makefile', 'lib/Makefile',
386 # etc. to be built without running into similar recursion problems.
387 MAKEFILE_NAME = Makefile
388 $(MAKEFILE_NAME): config.status $(srcdir)/src/config.in \
389 $(srcdir)/Makefile.in $(SUBDIR_MAKEFILES_IN) $(srcdir)/src/lisp.mk
390 MAKE='$(MAKE)' ./config.status
392 # Don't erase these files if make is interrupted while refreshing them.
393 .PRECIOUS: Makefile config.status
395 config.status: ${srcdir}/configure ${srcdir}/lisp/version.el
396 if [ -x ./config.status ]; then \
397 $(CFG) ./config.status --recheck; \
398 else \
399 $(CFG) $(srcdir)/configure $(CONFIGURE_FLAGS); \
402 AUTOCONF_INPUTS = $(srcdir)/configure.ac $(srcdir)/aclocal.m4
404 $(srcdir)/configure: $(AUTOCONF_INPUTS)
405 cd ${srcdir} && autoconf
407 ACLOCAL_INPUTS = $(srcdir)/m4/gnulib-comp.m4
408 $(srcdir)/aclocal.m4: $(ACLOCAL_INPUTS)
409 cd $(srcdir) && aclocal -I m4
411 AUTOMAKE_INPUTS = $(srcdir)/aclocal.m4 $(srcdir)/lib/Makefile.am \
412 $(srcdir)/lib/gnulib.mk
413 $(srcdir)/lib/Makefile.in: $(AUTOMAKE_INPUTS)
414 cd $(srcdir) && automake --gnu -a -c lib/Makefile
416 # Regenerate files that this makefile would have made, if this makefile
417 # had been built by Automake. The name 'am--refresh' is for
418 # compatibility with subsidiary Automake-generated makefiles.
419 am--refresh: $(srcdir)/aclocal.m4 $(srcdir)/configure $(srcdir)/src/config.in
420 .PHONY: am--refresh
422 $(srcdir)/src/config.in: $(srcdir)/src/stamp-h.in
423 @ # Usually, there's no need to rebuild src/config.in just
424 @ # because stamp-h.in has changed (since building stamp-h.in
425 @ # refreshes config.in as well), but if config.in is missing
426 @ # then we really need to do something more.
427 [ -r "$@" ] || ( cd ${srcdir} && autoheader )
428 $(srcdir)/src/stamp-h.in: $(AUTOCONF_INPUTS)
429 cd ${srcdir} && autoheader
430 rm -f $(srcdir)/src/stamp-h.in
431 echo timestamp > $(srcdir)/src/stamp-h.in
433 # ==================== Installation ====================
435 .PHONY: install install-arch-dep install-arch-indep install-doc install-info
436 .PHONY: install-man install-etc install-strip install-$(NTDIR)
437 .PHONY: uninstall uninstall-$(NTDIR)
439 ## If we let lib-src do its own installation, that means we
440 ## don't have to duplicate the list of utilities to install in
441 ## this Makefile as well.
443 install: all install-arch-indep install-doc install-arch-dep install-$(NTDIR) blessmail
444 @true
446 ## Ensure that $subdir contains a subdirs.el file.
447 ## Here and elsewhere, we set the umask so that any created files are
448 ## world-readable.
449 ## TODO it might be good to warn about non-standard permissions of
450 ## pre-existing directories, but that does not seem easy.
451 write_subdir=if [ -f $${subdir}/subdirs.el ]; \
452 then true; \
453 else \
454 umask 022; \
455 ${MKDIR_P} $${subdir}; \
456 (echo "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
457 echo " (normal-top-level-add-subdirs-to-load-path))") \
458 > $${subdir}/subdirs.el; \
461 ### Install the executables that were compiled specifically for this machine.
462 ### We do install-arch-indep first because the executable needs the
463 ### Lisp files and DOC file to work properly.
464 install-arch-dep: src install-arch-indep install-doc install-$(NTDIR)
465 umask 022; ${MKDIR_P} $(DESTDIR)${bindir}
466 cd lib-src && \
467 $(MAKE) install $(MFLAGS) prefix=${prefix} \
468 exec_prefix=${exec_prefix} bindir=${bindir} \
469 libexecdir=${libexecdir} archlibdir=${archlibdir} \
470 INSTALL_STRIP=${INSTALL_STRIP}
471 if test "${ns_self_contained}" = "no"; then \
472 ${INSTALL_PROGRAM} $(INSTALL_STRIP) src/emacs${EXEEXT} $(DESTDIR)${bindir}/$(EMACSFULL) || exit 1 ; \
473 chmod 1755 $(DESTDIR)${bindir}/$(EMACSFULL) || true; \
474 if test "x${NO_BIN_LINK}" = x; then \
475 rm -f $(DESTDIR)${bindir}/$(EMACS) ; \
476 cd $(DESTDIR)${bindir} && $(LN_S_FILEONLY) $(EMACSFULL) $(EMACS); \
477 fi; \
478 else \
479 subdir=${ns_appresdir}/site-lisp; \
480 ${write_subdir} || exit 1; \
481 rm -rf ${ns_appresdir}/share; \
484 ### Windows-specific install target for installing programs produced
485 ### in nt/, and its Posix do-nothing shadow.
486 install-:
487 install-nt:
488 cd $(NTDIR) && \
489 $(MAKE) install $(MFLAGS) prefix=${prefix} \
490 exec_prefix=${exec_prefix} bindir=${bindir} \
491 libexecdir=${libexecdir} archlibdir=${archlibdir} \
492 INSTALL_STRIP=${INSTALL_STRIP}
494 ## In the share directory, we are deleting:
495 ## applications (with emacs.desktop, also found in etc/)
496 ## emacs (basically empty except for unneeded site-lisp directories)
497 ## icons (duplicates etc/images/icons/hicolor)
499 ## This is install-etc for everything except self-contained-ns builds.
500 ## For them, it is empty.
501 INSTALL_ARCH_INDEP_EXTRA = @INSTALL_ARCH_INDEP_EXTRA@
503 ## http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg01672.html
504 ## Needs to be the user running install, so configure can't set it.
505 set_installuser=for installuser in $${LOGNAME} $${USERNAME} $${USER} \
506 `id -un 2> /dev/null`; do \
507 [ -n "$${installuser}" ] && break ; \
508 done
510 ### Install the files that are machine-independent.
511 ### Most of them come straight from the distribution; the exception is
512 ### the DOC file, which is copied from the build directory.
514 ## We delete each directory in ${COPYDESTS} before we copy into it;
515 ## that way, we can reinstall over directories that have been put in
516 ## place with their files read-only (perhaps because they are checked
517 ## into RCS). In order to make this safe, we make sure that the
518 ## source exists and is distinct from the destination.
520 ## We delete etc/DOC* because there may be irrelevant DOC files from
521 ## other builds in the source directory. This is ok because we just
522 ## deleted the entire installed etc/ directory and recreated it.
523 ## install-doc installs the relevant DOC.
525 ## Note that the Makefiles in the etc directory are potentially useful
526 ## in an installed Emacs, so should not be excluded.
528 ## I'm not sure creating locallisppath here serves any useful purpose.
529 ## If it has the default value, then the later write_subdir commands
530 ## will ensure all these components exist.
531 ## This will only do something if locallisppath has a non-standard value.
532 ## Is it really Emacs's job to create those directories?
533 ## Should we also be ensuring they contain subdirs.el files?
534 ## It would be easy to do, just use write_subdir.
536 ## Note that we use tar instead of plain old cp -R/-r because the latter
537 ## is apparently not portable (even in 2012!).
538 ## http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00278.html
539 ## I have no idea which platforms Emacs supports where cp -R does not
540 ## work correctly, and therefore no idea when tar can be replaced.
541 ## See also these comments from 2004 about cp -r working fine:
542 ## http://lists.gnu.org/archive/html/autoconf-patches/2004-11/msg00005.html
543 install-arch-indep: lisp leim install-info install-man ${INSTALL_ARCH_INDEP_EXTRA}
544 umask 022 ; \
545 locallisppath='${locallisppath}'; \
546 IFS=:; \
547 for d in $$locallisppath; do \
548 ${MKDIR_P} "$(DESTDIR)$$d"; \
549 done
550 -set ${COPYDESTS} ; \
551 unset CDPATH; \
552 $(set_installuser); \
553 for dir in ${COPYDIR} ; do \
554 [ -d $${dir} ] || exit 1 ; \
555 dest=$$1 ; shift ; \
556 [ -d $${dest} ] && \
557 [ `cd $${dest} && /bin/pwd` = `cd $${dir} && /bin/pwd` ] && \
558 continue ; \
559 if [ "$${dir}" = "leim/quail" ]; then \
560 [ `cd $${dir} && /bin/pwd` = `cd ${srcdir}/leim/quail && /bin/pwd` ] && \
561 continue ; \
562 else \
563 rm -rf $${dest} ; \
564 umask 022; ${MKDIR_P} $${dest} ; \
565 fi ; \
566 echo "Copying $${dir} to $${dest}..." ; \
567 (cd $${dir}; tar -chf - . ) \
568 | (cd $${dest}; umask 022; \
569 tar -xvf - && cat > /dev/null) || exit 1; \
570 [ "$${dir}" != "${srcdir}/etc" ] || rm -f $${dest}/DOC* ; \
571 for subdir in `find $${dest} -type d -print` ; do \
572 chmod a+rx $${subdir} ; \
573 rm -f $${subdir}/.gitignore ; \
574 rm -f $${subdir}/.arch-inventory ; \
575 rm -f $${subdir}/.DS_Store ; \
576 rm -f $${subdir}/\#* ; \
577 rm -f $${subdir}/.\#* ; \
578 rm -f $${subdir}/*~ ; \
579 rm -f $${subdir}/*.orig ; \
580 rm -f $${subdir}/ChangeLog* ; \
581 [ "$${dir}" != "${srcdir}/etc" ] && \
582 rm -f $${subdir}/[mM]akefile*[.-]in $${subdir}/[mM]akefile ; \
583 done ; \
584 find $${dest} -exec chown $${installuser} {} ';' ;\
585 done
586 -rm -f $(DESTDIR)${leimdir}/leim-list.el
587 ${INSTALL_DATA} leim/leim-list.el $(DESTDIR)${leimdir}/leim-list.el
588 -rm -f $(DESTDIR)${lispdir}/subdirs.el
589 umask 022; $(srcdir)/build-aux/update-subdirs $(DESTDIR)${lispdir}
590 subdir=$(DESTDIR)${datadir}/emacs/${version}/site-lisp ; \
591 ${write_subdir}
592 subdir=$(DESTDIR)${datadir}/emacs/site-lisp ; \
593 ${write_subdir} || true
594 [ -z "${GZIP_PROG}" ] || \
595 ( echo "Compressing *.el ..." ; \
596 unset CDPATH; \
597 thisdir=`/bin/pwd`; \
598 for dir in $(DESTDIR)${lispdir} $(DESTDIR)${leimdir}; do \
599 cd $${thisdir} ; \
600 cd $${dir} || exit 1 ; \
601 for f in `find . -name "*.elc" -print`; do \
602 ${GZIP_PROG} -9n `echo $$f|sed 's/.elc$$/.el/'` ; \
603 done ; \
604 done )
605 -chmod -R a+r $(DESTDIR)${datadir}/emacs/${version} ${COPYDESTS}
607 ## The above chmods are needed because "umask 022; tar ..." is not
608 ## guaranteed to do the right thing; eg if we are root and tar is
609 ## preserving source permissions.
611 ## We install only the relevant DOC file if possible
612 ## (ie DOC-${version}.buildnumber), otherwise DOC-${version}*.
613 ## (Note "otherwise" is inaccurate since 2009-08-23.)
615 ## Note that install-arch-indep deletes and recreates the entire
616 ## installed etc/ directory, so we need it to run before this does.
617 install-doc: src install-arch-indep
618 -unset CDPATH; \
619 umask 022; ${MKDIR_P} $(DESTDIR)${docdir} ; \
620 if [ `cd ./etc; /bin/pwd` != `cd $(DESTDIR)${docdir}; /bin/pwd` ]; \
621 then \
622 fullversion=`./src/emacs --version | sed -n '1 s/GNU Emacs *//p'`; \
623 if [ -f "./etc/DOC-$${fullversion}" ]; \
624 then \
625 docfile="DOC-$${fullversion}"; \
626 else \
627 docfile="DOC"; \
628 fi; \
629 echo "Copying etc/$${docfile} to $(DESTDIR)${docdir} ..." ; \
630 ${INSTALL_DATA} etc/$${docfile} $(DESTDIR)${docdir}/$${docfile}; \
631 $(set_installuser); \
632 chown $${installuser} $(DESTDIR)${docdir}/$${docfile} || true ; \
633 else true; fi
635 install-info: info
636 umask 022; ${MKDIR_P} $(DESTDIR)${infodir}
637 -unset CDPATH; \
638 thisdir=`/bin/pwd`; \
639 [ `cd ${srcdir}/info && /bin/pwd` = `cd $(DESTDIR)${infodir} && /bin/pwd` ] || \
640 (cd $(DESTDIR)${infodir}; \
641 [ -f dir ] || \
642 (cd $${thisdir}; \
643 ${INSTALL_DATA} ${srcdir}/info/dir $(DESTDIR)${infodir}/dir) ; \
644 info_misc=`cd $${thisdir}/doc/misc && \
645 $(QUIET_SUBMAKE) $(MAKE) -s echo-info \
646 `; \
647 cd ${srcdir}/info ; \
648 for elt in ${INFO_NONMISC} $${info_misc}; do \
649 test "$(HAVE_MAKEINFO)" = "no" && test ! -f $$elt && continue; \
650 for f in `ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
651 (cd $${thisdir}; \
652 ${INSTALL_DATA} ${srcdir}/info/$$f $(DESTDIR)${infodir}/$$f); \
653 ( [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ] ) || continue ; \
654 rm -f $(DESTDIR)${infodir}/$$f.gz; \
655 ${GZIP_PROG} -9n $(DESTDIR)${infodir}/$$f; \
656 done; \
657 (cd $${thisdir}; \
658 ${INSTALL_INFO} --info-dir=$(DESTDIR)${infodir} $(DESTDIR)${infodir}/$$elt); \
659 done)
661 ## "gzip || true" is because some gzips exit with non-zero status
662 ## if compression would not reduce the file size. Eg, the gzip in
663 ## OpenBSD 4.9 seems to do this (2013/03). In Emacs, this can
664 ## only happen with the tiny ctags.1 manpage. We don't really care if
665 ## ctags.1 is compressed or not. "gzip -f" is another option here,
666 ## but not sure if portable.
667 install-man:
668 umask 022; ${MKDIR_P} $(DESTDIR)${man1dir}
669 thisdir=`/bin/pwd`; \
670 cd ${mansrcdir}; \
671 for page in *.1; do \
672 dest=`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1; \
673 (cd $${thisdir}; \
674 ${INSTALL_DATA} ${mansrcdir}/$${page} $(DESTDIR)${man1dir}/$${dest}); \
675 ( [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ] ) || continue ; \
676 rm -f $(DESTDIR)${man1dir}/$${dest}.gz; \
677 ${GZIP_PROG} -9n $(DESTDIR)${man1dir}/$${dest} || true; \
678 done
680 ## Install those items from etc/ that need to end up elsewhere.
682 ## If you prefer, choose "emacs22" at installation time.
683 ## Note: emacs22 does not have all the resolutions.
684 EMACS_ICON=emacs
686 install-etc:
687 umask 022; ${MKDIR_P} $(DESTDIR)${desktopdir}
688 tmp=etc/emacs.tmpdesktop; rm -f $${tmp}; \
689 emacs_name=`echo emacs | sed '$(TRANSFORM)'`; \
690 sed -e "/^Exec=emacs/ s/emacs/$${emacs_name}/" \
691 -e "/^Icon=emacs/ s/emacs/$${emacs_name}/" \
692 ${srcdir}/etc/emacs.desktop > $${tmp}; \
693 ${INSTALL_DATA} $${tmp} $(DESTDIR)${desktopdir}/${EMACS_NAME}.desktop; \
694 rm -f $${tmp}
695 thisdir=`/bin/pwd`; \
696 cd ${iconsrcdir} || exit 1; umask 022 ; \
697 for dir in */*/apps */*/mimetypes; do \
698 [ -d $${dir} ] || continue ; \
699 ( cd $${thisdir}; ${MKDIR_P} $(DESTDIR)${icondir}/$${dir} ) ; \
700 for icon in $${dir}/${EMACS_ICON}[.-]*; do \
701 [ -r $${icon} ] || continue ; \
702 ext=`echo "$${icon}" | sed -e 's|.*\.||'`; \
703 dest=`echo "$${icon}" | sed -e 's|.*/||' -e "s|\.$${ext}$$||" -e 's/$(EMACS_ICON)/emacs/' -e '$(TRANSFORM)'`.$${ext} ; \
704 ( cd $${thisdir}; \
705 ${INSTALL_DATA} ${iconsrcdir}/$${icon} $(DESTDIR)${icondir}/$${dir}/$${dest} ) \
706 || exit 1; \
707 done ; \
708 done
710 ### Build Emacs and install it, stripping binaries while installing them.
711 install-strip:
712 $(MAKE) $(MFLAGS) INSTALL_STRIP=-s install
714 ### Delete all the installed files that the `install' target would
715 ### create (but not the noninstalled files such as `make all' would create).
717 ### Don't delete the lisp and etc directories if they're in the source tree.
718 uninstall: uninstall-$(NTDIR)
719 cd lib-src && \
720 $(MAKE) $(MFLAGS) uninstall \
721 prefix=${prefix} exec_prefix=${exec_prefix} \
722 bindir=${bindir} libexecdir=${libexecdir} archlibdir=${archlibdir}
724 -unset CDPATH; \
725 for dir in $(DESTDIR)${lispdir} $(DESTDIR)${etcdir} ; do \
726 if [ -d $${dir} ]; then \
727 case `cd $${dir} ; /bin/pwd` in \
728 `cd ${srcdir} ; /bin/pwd`* ) ;; \
729 * ) rm -rf $${dir} ;; \
730 esac ; \
731 case $${dir} in \
732 $(DESTDIR)${datadir}/emacs/${version}/* ) \
733 rm -rf $(DESTDIR)${datadir}/emacs/${version} \
734 ;; \
735 esac ; \
736 fi ; \
737 done
738 -rm -rf $(DESTDIR)${libexecdir}/emacs/${version}
739 thisdir=`/bin/pwd`; \
740 (info_misc=`cd doc/misc && $(QUIET_SUBMAKE) $(MAKE) -s echo-info`; \
741 if cd $(DESTDIR)${infodir}; then \
742 for elt in ${INFO_NONMISC} $${info_misc}; do \
743 (cd $${thisdir}; \
744 $(INSTALL_INFO) --remove --info-dir=$(DESTDIR)${infodir} $(DESTDIR)${infodir}/$$elt); \
745 if [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ]; then \
746 ext=.gz; else ext=; fi; \
747 rm -f $$elt$$ext $$elt-[1-9]$$ext $$elt-[1-9][0-9]$$ext; \
748 done; \
750 (if [ -n "${GZIP_INFO}" ] && [ -n "${GZIP_PROG}" ]; then \
751 ext=.gz; else ext=; fi; \
752 if cd ${mansrcdir}; then \
753 for page in *.1; do \
754 rm -f $(DESTDIR)${man1dir}/`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1$$ext; done; \
756 (cd $(DESTDIR)${bindir} && rm -f $(EMACSFULL) $(EMACS) || true)
757 (if cd $(DESTDIR)${icondir}; then \
758 rm -f hicolor/*x*/apps/${EMACS_NAME}.png \
759 hicolor/scalable/apps/${EMACS_NAME}.svg \
760 hicolor/scalable/mimetypes/`echo emacs-document | sed '$(TRANSFORM)'`.svg; \
762 -rm -f $(DESTDIR)${desktopdir}/${EMACS_NAME}.desktop
763 for file in snake-scores tetris-scores; do \
764 file=$(DESTDIR)${gamedir}/$${file}; \
765 [ -s $${file} ] || rm -f $$file; \
766 done
768 ### Windows-specific uninstall target for removing programs produced
769 ### in nt/, and its Posix do-nothing shadow.
770 uninstall-:
771 uninstall-nt:
772 cd $(NTDIR) && \
773 $(MAKE) $(MFLAGS) uninstall \
774 prefix=${prefix} exec_prefix=${exec_prefix} \
775 bindir=${bindir} libexecdir=${libexecdir} archlibdir=${archlibdir}
777 FRC:
779 # ==================== Cleaning up and miscellanea ====================
781 .PHONY: mostlyclean clean distclean bootstrap-clean maintainer-clean extraclean
783 ### `mostlyclean'
784 ### Like `clean', but may refrain from deleting a few files that people
785 ### normally don't want to recompile. For example, the `mostlyclean'
786 ### target for GCC does not delete `libgcc.a', because recompiling it
787 ### is rarely necessary and takes a lot of time.
788 mostlyclean: FRC
789 (cd src; $(MAKE) $(MFLAGS) mostlyclean)
790 (cd oldXMenu; $(MAKE) $(MFLAGS) mostlyclean)
791 (cd lwlib; $(MAKE) $(MFLAGS) mostlyclean)
792 (cd lib; $(MAKE) $(MFLAGS) mostlyclean)
793 (cd lib-src; $(MAKE) $(MFLAGS) mostlyclean)
794 (cd nt; $(MAKE) $(MFLAGS) mostlyclean)
795 -(cd doc/emacs && $(MAKE) $(MFLAGS) mostlyclean)
796 -(cd doc/misc && $(MAKE) $(MFLAGS) mostlyclean)
797 -(cd doc/lispref && $(MAKE) $(MFLAGS) mostlyclean)
798 -(cd doc/lispintro && $(MAKE) $(MFLAGS) mostlyclean)
799 (cd leim; $(MAKE) $(MFLAGS) mostlyclean)
801 ### `clean'
802 ### Delete all files from the current directory that are normally
803 ### created by building the program. Don't delete the files that
804 ### record the configuration. Also preserve files that could be made
805 ### by building, but normally aren't because the distribution comes
806 ### with them.
808 ### Delete `.dvi' files here if they are not part of the distribution.
809 clean: FRC
810 -rm -f etc/emacs.tmpdesktop
811 (cd src; $(MAKE) $(MFLAGS) clean)
812 (cd oldXMenu; $(MAKE) $(MFLAGS) clean)
813 (cd lwlib; $(MAKE) $(MFLAGS) clean)
814 (cd lib; $(MAKE) $(MFLAGS) clean)
815 (cd lib-src; $(MAKE) $(MFLAGS) clean)
816 (cd nt; $(MAKE) $(MFLAGS) clean)
817 -(cd doc/emacs && $(MAKE) $(MFLAGS) clean)
818 -(cd doc/misc && $(MAKE) $(MFLAGS) clean)
819 -(cd doc/lispref && $(MAKE) $(MFLAGS) clean)
820 -(cd doc/lispintro && $(MAKE) $(MFLAGS) clean)
821 (cd leim; $(MAKE) $(MFLAGS) clean)
822 (cd nextstep && $(MAKE) $(MFLAGS) clean)
824 ### `bootclean'
825 ### Delete all files that need to be remade for a clean bootstrap.
826 top_bootclean=\
827 rm -f config.cache config.log
828 ### `distclean'
829 ### Delete all files from the current directory that are created by
830 ### configuring or building the program. If you have unpacked the
831 ### source and built the program without creating any other files,
832 ### `make distclean' should leave only the files that were in the
833 ### distribution.
834 top_distclean=\
835 ${top_bootclean}; \
836 rm -f config.status config.log~ Makefile stamp-h1 ${SUBDIR_MAKEFILES}
837 distclean: FRC
838 (cd src; $(MAKE) $(MFLAGS) distclean)
839 (cd oldXMenu; $(MAKE) $(MFLAGS) distclean)
840 (cd lwlib; $(MAKE) $(MFLAGS) distclean)
841 (cd lib; $(MAKE) $(MFLAGS) distclean)
842 (cd lib-src; $(MAKE) $(MFLAGS) distclean)
843 (cd nt; $(MAKE) $(MFLAGS) distclean)
844 (cd doc/emacs && $(MAKE) $(MFLAGS) distclean)
845 (cd doc/misc && $(MAKE) $(MFLAGS) distclean)
846 (cd doc/lispref && $(MAKE) $(MFLAGS) distclean)
847 (cd doc/lispintro && $(MAKE) $(MFLAGS) distclean)
848 (cd leim; $(MAKE) $(MFLAGS) distclean)
849 (cd lisp; $(MAKE) $(MFLAGS) distclean)
850 (cd nextstep && $(MAKE) $(MFLAGS) distclean)
851 ${top_distclean}
853 ### `bootstrap-clean'
854 ### Delete everything that can be reconstructed by `make' and that
855 ### needs to be deleted in order to force a bootstrap from a clean state.
856 bootstrap-clean: FRC
857 (cd src; $(MAKE) $(MFLAGS) bootstrap-clean)
858 (cd oldXMenu; $(MAKE) $(MFLAGS) maintainer-clean)
859 (cd lwlib; $(MAKE) $(MFLAGS) maintainer-clean)
860 (cd lib; $(MAKE) $(MFLAGS) maintainer-clean)
861 (cd lib-src; $(MAKE) $(MFLAGS) maintainer-clean)
862 (cd nt; $(MAKE) $(MFLAGS) maintainer-clean)
863 -(cd doc/emacs && $(MAKE) $(MFLAGS) maintainer-clean)
864 -(cd doc/misc && $(MAKE) $(MFLAGS) maintainer-clean)
865 -(cd doc/lispref && $(MAKE) $(MFLAGS) maintainer-clean)
866 -(cd doc/lispintro && $(MAKE) $(MFLAGS) maintainer-clean)
867 (cd leim; $(MAKE) $(MFLAGS) maintainer-clean)
868 (cd lisp; $(MAKE) $(MFLAGS) bootstrap-clean)
869 (cd nextstep && $(MAKE) $(MFLAGS) maintainer-clean)
870 [ ! -f config.log ] || mv -f config.log config.log~
871 ${top_bootclean}
873 ### `maintainer-clean'
874 ### Delete everything from the current directory that can be
875 ### reconstructed with this Makefile. This typically includes
876 ### everything deleted by distclean, plus more: C source files
877 ### produced by Bison, tags tables, info files, and so on.
879 ### One exception, however: `make maintainer-clean' should not delete
880 ### `configure' even if `configure' can be remade using a rule in the
881 ### Makefile. More generally, `make maintainer-clean' should not delete
882 ### anything that needs to exist in order to run `configure' and then
883 ### begin to build the program.
884 top_maintainer_clean=\
885 ${top_distclean}; \
886 rm -fr autom4te.cache
887 maintainer-clean: bootstrap-clean FRC
888 (cd src; $(MAKE) $(MFLAGS) maintainer-clean)
889 (cd lisp; $(MAKE) $(MFLAGS) maintainer-clean)
890 ${top_maintainer_clean}
892 ### This doesn't actually appear in the coding standards, but Karl
893 ### says GCC supports it, and that's where the configuration part of
894 ### the coding standards seem to come from. It's like distclean, but
895 ### it deletes backup and autosave files too.
896 extraclean:
897 for i in ${SUBDIR}; do (cd $$i; $(MAKE) $(MFLAGS) extraclean); done
898 ${top_maintainer_clean}
899 -rm -f config-tmp-*
900 -rm -f *~ \#*
902 # The src subdir knows how to do the right thing
903 # even when the build directory and source dir are different.
904 .PHONY: TAGS tags
905 TAGS tags: lib lib-src src
906 cd src; $(MAKE) $(MFLAGS) tags
908 check:
909 @if test ! -d test/automated; then \
910 echo "You do not seem to have the test/ directory."; \
911 echo "Maybe you are using a release tarfile, rather than a repository checkout."; \
912 else \
913 cd test/automated && $(MAKE) $(MFLAGS) check; \
916 dist:
917 cd ${srcdir}; ./make-dist
919 DVIS = lispref-dvi lispintro-dvi emacs-dvi misc-dvi
920 HTMLS = lispref-html lispintro-html emacs-html misc-html
921 INFOS = lispref-info lispintro-info emacs-info misc-info
922 PDFS = lispref-pdf lispintro-pdf emacs-pdf misc-pdf
923 PSS = lispref-ps lispintro-ps emacs-ps # no misc-ps
925 DOCS = $(DVIS) $(HTMLS) $(INFOS) $(PDFS) $(PSS)
926 $(DOCS):
927 t=$@; IFS=-; set $$t; IFS=; cd doc/$$1 && $(MAKE) $(MFLAGS) $$2
929 .PHONY: $(DOCS) docs pdf ps
930 .PHONY: info dvi dist check html info-real force-info check-info-dir
932 docs: $(DOCS)
933 dvi: $(DVIS)
934 html: $(HTMLS)
935 info-real: $(INFOS)
936 pdf: $(PDFS)
937 ps: $(PSS)
939 force-info:
940 # Note that man/Makefile knows how to put the info files in $(srcdir),
941 # so we can do ok running make in the build dir.
942 # This used to have a clause that exited with an error if MAKEINFO = no.
943 # But it is inappropriate to do so without checking if makeinfo is
944 # actually needed - it is not if the info files are up-to-date. (Bug#3982)
945 # Only the doc/*/Makefiles can decide that, so we let those rules run
946 # and give a standard error if makeinfo is needed but missing.
947 # While it would be nice to give a more detailed error message, that
948 # would require changing every rule in doc/ that builds an info file,
949 # and it's not worth it. This case is only relevant if you download a
950 # release, then change the .texi files.
951 info: force-info
952 @if test "$(HAVE_MAKEINFO)" = "no"; then \
953 echo "Configured --without-makeinfo, not building manuals" ; \
954 else \
955 $(MAKE) $(MFLAGS) info-real ; \
958 # The info/dir file must be updated by hand when new manuals are added.
959 check-info-dir: info
960 cd info ; \
961 missing= ; \
962 for file in *; do \
963 test -f "$${file}" || continue ; \
964 case $${file} in \
965 *-[0-9]*|COPYING|dir) continue ;; \
966 esac ; \
967 file=`echo $${file} | sed 's/\.info//'` ; \
968 grep -q -F ": ($${file})." dir || missing="$${missing} $${file}" ; \
969 done ; \
970 if test -n "$${missing}"; then \
971 echo "Missing info/dir entries: $${missing}" ; \
972 exit 1 ; \
973 fi ; \
974 echo "info/dir is OK"
976 #### Bootstrapping.
978 ### This first cleans the lisp subdirectory, removing all compiled
979 ### Lisp files. Then re-run make to build all the files anew.
981 .PHONY: bootstrap
983 # Bootstrapping does the following:
984 # * Remove files to start from a bootstrap-clean slate.
985 # * Run autogen.sh, falling back on copy_autogen if autogen.sh fails.
986 # * Rebuild Makefile, to update the build procedure itself.
987 # * Do the actual build.
988 bootstrap: bootstrap-clean FRC
989 cd $(srcdir) && { ./autogen.sh || autogen/copy_autogen; }
990 $(MAKE) $(MFLAGS) MAKEFILE_NAME=force-Makefile force-Makefile
991 $(MAKE) $(MFLAGS) info all
993 .PHONY: check-declare
995 check-declare:
996 @if [ ! -f $(srcdir)/src/emacs ]; then \
997 echo "You must build Emacs to use this command"; \
998 exit 1; \
1000 (cd leim; $(MAKE) $(MFLAGS) $@)
1001 (cd lisp; $(MAKE) $(MFLAGS) $@)