* nextstep/WISHLIST: Merge into etc/TODO and remove.
[emacs.git] / Makefile.in
blobb212c914e566cd623529b612b06d8ac414787e32
1 ### @configure_input@
3 # Copyright (C) 1992-2016 Free Software Foundation, Inc.
5 # This file is part of GNU Emacs.
7 # GNU Emacs is free software: you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation, either version 3 of the License, or
10 # (at your option) any later version.
12 # GNU Emacs is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
20 ### Commentary:
22 # make all to compile and build Emacs.
23 # make install to install it.
24 # make TAGS to update tags tables.
26 # make clean or make mostlyclean
27 # Delete all files from the current directory that are normally
28 # created by building the program. Don't delete the files that
29 # record the configuration. Also preserve files that could be made
30 # by building, but normally aren't because the distribution comes
31 # with them.
33 # Delete '.dvi' files here if they are not part of the distribution.
35 # make distclean
36 # Delete all files from the current directory that are created by
37 # configuring or building the program. If you have unpacked the
38 # source and built the program without creating any other files,
39 # 'make distclean' should leave only the files that were in the
40 # distribution.
42 # make maintainer-clean
43 # Delete everything from the current directory that can be
44 # reconstructed with this Makefile. This typically includes
45 # everything deleted by distclean, plus more: .elc files,
46 # C source files produced by Bison, tags tables, info files,
47 # and so on.
49 # make extraclean
50 # Still more severe - delete backup and autosave files, too.
51 # Also generated files that do not normally change and can be slow
52 # to rebuild (eg leim/ja-dic).
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 # make check or make check-expensive
62 # Run Emacs test suite. check-expensive runs also tests which
63 # take more time to perform.
65 SHELL = @SHELL@
67 # This only matters when inheriting a CDPATH not starting with the
68 # current directory.
69 CDPATH=
71 # If Make doesn't predefine MAKE, set it here.
72 @SET_MAKE@
74 # ==================== Things 'configure' Might Edit ====================
76 cache_file = @cache_file@
77 CONFIGURE_FLAGS = --cache-file=$(cache_file)
79 AUTOCONF = @AUTOCONF@
80 AUTOMAKE = @AUTOMAKE@
81 AUTOHEADER = @AUTOHEADER@
82 ACLOCAL = @ACLOCAL@
83 AWK = @AWK@
85 EXEEXT=@EXEEXT@
87 ### These help us choose version- and architecture-specific directories
88 ### to install files in.
90 ### This should be the number of the Emacs version we're building,
91 ### like '24.5' or '25.0.50'.
92 version=@version@
94 ### This should be the name of the configuration we're building Emacs
95 ### for, like 'x86_64-unknown-linux-gnu' or 'powerpc-ibm-aix7.1.2.0'.
96 configuration=@configuration@
98 ### The nt/ subdirectory gets built only for MinGW
99 NTDIR=@NTDIR@
101 # 'make' verbosity.
102 AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
104 AM_V_GEN = $(am__v_GEN_@AM_V@)
105 am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
106 am__v_GEN_0 = @echo " GEN " $@;
107 am__v_GEN_1 =
109 AM_V_at = $(am__v_at_@AM_V@)
110 am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
111 am__v_at_0 = @
112 am__v_at_1 =
114 # ==================== Where To Install Things ====================
116 # Location to install Emacs.app under GNUstep / Mac OS X.
117 # Later values may use these.
118 ns_appbindir=@ns_appbindir@
119 ns_appresdir=@ns_appresdir@
120 # Either yes or no depending on whether this is a relocatable Emacs.app.
121 ns_self_contained=@ns_self_contained@
123 # The default location for installation. Everything is placed in
124 # subdirectories of this directory. The default values for many of
125 # the variables below are expressed in terms of this one, so you may
126 # not need to change them. This defaults to /usr/local.
127 prefix=@prefix@
129 # Like 'prefix', but used for architecture-specific files.
130 exec_prefix=@exec_prefix@
132 # Where to install Emacs and other binaries that people will want to
133 # run directly (like etags).
134 bindir=@bindir@
136 # The root of the directory tree for read-only architecture-independent
137 # data files. ${datadir}, ${infodir} and ${mandir} are based on this.
138 datarootdir=@datarootdir@
140 # Where to install architecture-independent data files. ${lispdir}
141 # and ${etcdir} are subdirectories of this.
142 datadir=@datadir@
144 # Where to install and expect the files that Emacs modifies as it
145 # runs. These files are all architecture-independent.
146 # Right now, this is not used.
147 sharedstatedir=@sharedstatedir@
149 # Where to install and expect executable files to be run by Emacs
150 # rather than directly by users (and other architecture-dependent
151 # data, although Emacs does not have any). The executables
152 # are actually installed in ${archlibdir}, which is (normally)
153 # a subdirectory of this.
154 libexecdir=@libexecdir@
156 # Where to install Emacs's man pages.
157 # Note they contain cross-references that expect them to be in section 1.
158 mandir=@mandir@
159 man1dir=$(mandir)/man1
161 # Where to install and expect the info files describing Emacs.
162 infodir=@infodir@
163 # Info files not in the doc/misc directory (we get those via make echo-info).
164 INFO_NONMISC=emacs.info eintr.info elisp.info
166 # If no makeinfo was found and configured --without-makeinfo, "no"; else "yes".
167 HAVE_MAKEINFO=@HAVE_MAKEINFO@
169 # Directory for local state files for all programs.
170 localstatedir=@localstatedir@
172 # Where to look for bitmap files.
173 bitmapdir=@bitmapdir@
175 # Where to find the source code. The source code for Emacs's C kernel is
176 # expected to be in ${srcdir}/src, and the source code for Emacs's
177 # utility programs is expected to be in ${srcdir}/lib-src. This is
178 # set by the configure script's '--srcdir' option.
180 # We use $(srcdir) explicitly in dependencies so as not to depend on VPATH.
181 srcdir=@srcdir@
182 abs_srcdir=@abs_srcdir@
184 # Where the manpage source files are kept.
185 mansrcdir=$(srcdir)/doc/man
187 # Tell make where to find source files; this is needed for the makefiles.
188 VPATH=@srcdir@
190 # Where to find the application default.
191 x_default_search_path=@x_default_search_path@
193 # Where the etc/emacs.desktop file is to be installed.
194 desktopdir=$(datarootdir)/applications
196 # Where the etc/emacs.appdata.xml file is to be installed.
197 appdatadir=$(datarootdir)/appdata
199 # Where the etc/images/icons/hicolor directory is to be installed.
200 icondir=$(datarootdir)/icons
202 # The source directory for the icon files.
203 iconsrcdir=$(srcdir)/etc/images/icons
205 # ==================== Emacs-specific directories ====================
207 # These variables hold the values Emacs will actually use. They are
208 # based on the values of the standard Make variables above.
210 # Where to install the lisp files distributed with Emacs.
211 # This includes the Emacs version, so that the lisp files for different
212 # versions of Emacs will install themselves in separate directories.
213 lispdir=@lispdir@
215 # Directories Emacs should search for standard lisp files.
216 # The default is ${lispdir}.
217 standardlisppath=@standardlisppath@
219 # Directories Emacs should search for lisp files specific to this
220 # site (i.e. customizations), before consulting ${standardlisppath}.
221 # This should be a colon-separated list of directories.
222 locallisppath=@locallisppath@
224 # Where Emacs will search to find its lisp files. Before
225 # changing this, check to see if your purpose wouldn't
226 # better be served by changing locallisppath. This
227 # should be a colon-separated list of directories.
228 # The default is ${locallisppath}:${standardlisppath}.
229 lisppath=@lisppath@
231 # Where Emacs will search for its lisp files while building.
232 # This is only used during the process of compiling Emacs,
233 # to help Emacs find its lisp files before they've been installed
234 # in their final location.
235 # This should be a colon-separated list of directories.
236 # Normally it points to the lisp/ directory in the sources.
237 # NB lread.c relies on lisp/ being first here.
238 buildlisppath=${abs_srcdir}/lisp
240 # Where to install the other architecture-independent
241 # data files distributed with Emacs (like the tutorial,
242 # the cookie recipes and the Zippy database). This path
243 # usually contains the Emacs version number, so the data
244 # files for multiple versions of Emacs may be installed
245 # at once.
246 etcdir=@etcdir@
248 # Where to put executables to be run by Emacs rather than
249 # the user. This path usually includes the Emacs version
250 # and configuration name, so that multiple configurations
251 # for multiple versions of Emacs may be installed at
252 # once.
253 archlibdir=@archlibdir@
255 # Where to put the etc/DOC file.
256 etcdocdir=@etcdocdir@
258 # Where to install Emacs game score files.
259 gamedir=@gamedir@
261 # ==================== Utility Programs for the Build ====================
263 # Allow the user to specify the install program.
264 # Note that if the system does not provide a suitable install,
265 # configure will use build-aux/install-sh. Annoyingly, it does
266 # not use an absolute path. So we must take care to always run
267 # INSTALL-type commands from the directory containing the Makefile.
268 # This explains (I think) the cd thisdir seen in several install rules.
269 INSTALL = @INSTALL@
270 INSTALL_PROGRAM = @INSTALL_PROGRAM@
271 INSTALL_DATA = @INSTALL_DATA@
272 INSTALL_INFO = @INSTALL_INFO@
273 # By default, we uphold the dignity of our programs.
274 INSTALL_STRIP =
275 MKDIR_P = @MKDIR_P@
276 # Create a link to a file in the same directory as the target.
277 LN_S_FILEONLY = @LN_S_FILEONLY@
279 # We use gzip to compress installed .el and some .txt files.
280 GZIP_PROG = @GZIP_PROG@
282 # ============================= Targets ==============================
284 # Program name transformation.
285 TRANSFORM = @program_transform_name@
287 # What emacs should be called when installed.
288 EMACS_NAME = `echo emacs | sed '$(TRANSFORM)'`
289 EMACS = ${EMACS_NAME}${EXEEXT}
290 EMACSFULL = `echo emacs-${version} | sed '$(TRANSFORM)'`${EXEEXT}
292 # Subdirectories to make recursively.
293 SUBDIR = $(NTDIR) lib lib-src src lisp
295 # The subdir makefiles created by config.status.
296 SUBDIR_MAKEFILES_IN = @SUBDIR_MAKEFILES_IN@
297 SUBDIR_MAKEFILES = $(patsubst ${srcdir}/%,%,${SUBDIR_MAKEFILES_IN:.in=})
299 # Subdirectories to install, and where they'll go. lib-src's and nt's
300 # makefiles know how to install them, so we don't do that here.
301 # Directories that cannot simply be copied, eg info, are treated
302 # separately.
303 COPYDIR = ${srcdir}/etc ${srcdir}/lisp
304 COPYDESTS = "$(DESTDIR)${etcdir}" "$(DESTDIR)${lispdir}"
306 all: ${SUBDIR} info
308 .PHONY: all ${SUBDIR} blessmail epaths-force epaths-force-w32 etc-emacsver
310 # If configure were to just generate emacsver.tex from emacsver.tex.in
311 # in the normal way, the timestamp of emacsver.tex would always be
312 # newer than that of the pdf files, which are prebuilt in release tarfiles.
313 # So we use this rule, and move-if-change, to avoid that.
314 etc-emacsver:
315 majorversion=`echo ${version} | sed 's/\..*//'`; \
316 sed "s/[@]majorversion@/$${majorversion}/" \
317 ${srcdir}/etc/refcards/emacsver.tex.in > emacsver.tex.$$$$ && \
318 ${srcdir}/build-aux/move-if-change emacsver.tex.$$$$ \
319 ${srcdir}/etc/refcards/emacsver.tex
321 # Generate epaths.h from epaths.in. This target is invoked by 'configure'.
322 # See comments in configure.ac for why it is done this way, as opposed
323 # to just letting configure generate epaths.h from epaths.in in a
324 # similar way to how Makefile is made from Makefile.in.
325 epaths-force:
326 @for dir in '$(abs_srcdir)' '$(lispdir)' '$(archlibdir)'; do \
327 case $$dir in \
328 *:*) \
329 printf >&2 "Build or installation directory '%s'\\n" "$$dir"; \
330 echo >&2 "cannot contain ':'."; \
331 exit 1;; \
332 esac; \
333 done
334 @(gamedir='${gamedir}'; \
335 sed < ${srcdir}/src/epaths.in > epaths.h.$$$$ \
336 -e 's;\(#.*PATH_LOADSEARCH\).*$$;\1 "${standardlisppath}";' \
337 -e 's;\(#.*PATH_SITELOADSEARCH\).*$$;\1 "${locallisppath}";' \
338 -e 's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "${buildlisppath}";' \
339 -e '/^#define PATH_[^ ]*SEARCH /s/\([":]\):*/\1/g' \
340 -e '/^#define PATH_[^ ]*SEARCH /s/:"/"/' \
341 -e 's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";' \
342 -e 's;\(#.*PATH_INFO\).*$$;\1 "${infodir}";' \
343 -e 's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";' \
344 -e 's;\(#.*PATH_BITMAPS\).*$$;\1 "${bitmapdir}";' \
345 -e 's;\(#.*PATH_X_DEFAULTS\).*$$;\1 "${x_default_search_path}";' \
346 -e 's;\(#.*PATH_GAME\).*$$;\1 "${gamedir}";' \
347 -e 's;\(#.*PATH_DOC\).*$$;\1 "${etcdocdir}";') && \
348 ${srcdir}/build-aux/move-if-change epaths.h.$$$$ src/epaths.h
350 # The w32 build needs a slightly different editing, and it uses
351 # nt/epaths.nt as the template.
353 # Use the value of ${locallisppath} supplied by 'configure',
354 # to support the --enable-locallisppath argument.
356 # In this case, the paths written to 'src/epaths.h' must be in native
357 # MS-Windows format (e.g. 'c:/foo/bar'), because temacs is a MinGW
358 # program that doesn't support MSYS-style paths (e.g. '/c/foo/bar' or
359 # '/foo/bar').
360 epaths-force-w32:
361 @(w32srcdir=`${srcdir}/build-aux/msys-to-w32 "${abs_srcdir}"`; \
362 w32prefix=`${srcdir}/build-aux/msys-to-w32 "${prefix}"`; \
363 w32locallisppath=`${srcdir}/build-aux/msys-to-w32 "${locallisppath}"` ; \
364 w32locallisppath=$${w32locallisppath//$${w32prefix}/"%emacs_dir%"} ; \
365 sed < ${srcdir}/nt/epaths.nt > epaths.h.$$$$ \
366 -e 's;\(#.*PATH_SITELOADSEARCH\).*$$;\1 "'"$${w32locallisppath//;/\\;}"'";' \
367 -e '/^.*#/s/@VER@/${version}/g' \
368 -e '/^.*#/s/@CFG@/${configuration}/g' \
369 -e "/^.*#/s|@SRC@|$${w32srcdir}|g") && \
370 ${srcdir}/build-aux/move-if-change epaths.h.$$$$ src/epaths.h
372 # If lib/Makefile would build files in '.', then build them before
373 # building 'lib', to avoid races with parallel makes.
374 lib: am--refresh
376 lib-src src: $(NTDIR) lib
378 src: lib-src
380 # We need to build 'emacs' in 'src' to compile the *.elc files in 'lisp'.
381 lisp: src
383 # These targets should be "${SUBDIR} without 'src'".
384 lib lib-src lisp nt: Makefile
385 $(MAKE) -C $@ all
387 # Ideally, VCSWITNESS should be a file that is modified whenever the
388 # repository registers a commit from either a local checkin or a
389 # repository pull. In git there is no single file that guarantees
390 # this, but the local log for the current head should be close enough.
392 # Pass an unexpanded $srcdir to src's Makefile, which then
393 # expands it using its own value of srcdir (which points to the
394 # source directory of src/).
395 dirstate = .git/logs/HEAD
396 VCSWITNESS = $(if $(wildcard $(srcdir)/$(dirstate)),$$(srcdir)/../$(dirstate))
397 src: Makefile
398 $(MAKE) -C $@ VCSWITNESS='$(VCSWITNESS)' all
400 blessmail: Makefile src
401 $(MAKE) -C lib-src maybe-blessmail
403 # We used to have one rule per */Makefile.in, but that leads to race
404 # conditions with parallel makes, so let's assume that the time stamp on
405 # ./Makefile is representative of the time stamp on all the other Makefiles.
407 # config.status overrides MAKEFILE_NAME with a bogus name when creating
408 # src/epaths.h, so that 'make epaths-force' does not recursively invoke
409 # config.status and overwrite config.status while executing it (Bug#11214).
411 # 'make bootstrap' overrides MAKEFILE_NAME to a nonexistent file but
412 # then attempts to build that file. This forces 'Makefile', 'lib/Makefile',
413 # etc. to be built without running into similar recursion problems.
414 MAKEFILE_NAME = Makefile
415 $(MAKEFILE_NAME): config.status $(srcdir)/src/config.in \
416 $(srcdir)/Makefile.in $(SUBDIR_MAKEFILES_IN)
417 MAKE='$(MAKE)' ./config.status
419 # Don't erase these files if make is interrupted while refreshing them.
420 .PRECIOUS: Makefile config.status
422 config.status: ${srcdir}/configure
423 if [ -x ./config.status ]; then \
424 $(CFG) ./config.status --recheck; \
425 else \
426 $(CFG) $(srcdir)/configure $(CONFIGURE_FLAGS); \
429 AUTOCONF_INPUTS = $(srcdir)/configure.ac $(srcdir)/aclocal.m4
431 $(srcdir)/configure: $(AUTOCONF_INPUTS)
432 cd ${srcdir} && ${AUTOCONF}
434 ACLOCAL_PATH = @ACLOCAL_PATH@
435 ACLOCAL_INPUTS = $(srcdir)/configure.ac $(srcdir)/m4/*.m4
436 $(srcdir)/aclocal.m4: $(ACLOCAL_INPUTS)
437 cd $(srcdir) && ACLOCAL_PATH='$(ACLOCAL_PATH)' $(ACLOCAL) -I m4
439 AUTOMAKE_INPUTS = $(srcdir)/aclocal.m4 $(srcdir)/lib/Makefile.am \
440 $(srcdir)/lib/gnulib.mk
441 $(srcdir)/lib/Makefile.in: $(AUTOMAKE_INPUTS)
442 cd $(srcdir) && $(AUTOMAKE) --gnu -a -c lib/Makefile
444 # Regenerate files that this makefile would have made, if this makefile
445 # had been built by Automake. The name 'am--refresh' is for
446 # compatibility with subsidiary Automake-generated makefiles.
447 am--refresh: $(srcdir)/aclocal.m4 $(srcdir)/configure $(srcdir)/src/config.in
448 .PHONY: am--refresh
450 $(srcdir)/src/config.in: $(srcdir)/src/stamp-h.in
451 @ # Usually, there's no need to rebuild src/config.in just
452 @ # because stamp-h.in has changed (since building stamp-h.in
453 @ # refreshes config.in as well), but if config.in is missing
454 @ # then we really need to do something more.
455 $(if $(wildcard $@),,cd $(srcdir) && $(AUTOHEADER))
456 $(srcdir)/src/stamp-h.in: $(AUTOCONF_INPUTS)
457 cd ${srcdir} && ${AUTOHEADER}
458 rm -f $@
459 echo timestamp > $@
461 # ==================== Installation ====================
463 .PHONY: install install-arch-dep install-arch-indep install-etcdoc install-info
464 .PHONY: install-man install-etc install-strip install-$(NTDIR)
465 .PHONY: uninstall uninstall-$(NTDIR)
467 ## If we let lib-src do its own installation, that means we
468 ## don't have to duplicate the list of utilities to install in
469 ## this Makefile as well.
471 install: all install-arch-indep install-etcdoc install-arch-dep install-$(NTDIR) blessmail
472 @true
474 ## Ensure that $subdir contains a subdirs.el file.
475 ## Here and elsewhere, we set the umask so that any created files are
476 ## world-readable.
477 ## TODO it might be good to warn about non-standard permissions of
478 ## pre-existing directories, but that does not seem easy.
479 write_subdir=if [ -f "$${subdir}/subdirs.el" ]; \
480 then true; \
481 else \
482 umask 022; \
483 ${MKDIR_P} "$${subdir}"; \
484 (echo "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
485 echo " (normal-top-level-add-subdirs-to-load-path))") \
486 > "$${subdir}/subdirs.el"; \
489 ### Install the executables that were compiled specifically for this machine.
490 ### We do install-arch-indep first because the executable needs the
491 ### Lisp files and DOC file to work properly.
492 install-arch-dep: src install-arch-indep install-etcdoc install-$(NTDIR)
493 umask 022; ${MKDIR_P} "$(DESTDIR)${bindir}"
494 $(MAKE) -C lib-src install
495 ifeq (${ns_self_contained},no)
496 ${INSTALL_PROGRAM} $(INSTALL_STRIP) src/emacs${EXEEXT} "$(DESTDIR)${bindir}/$(EMACSFULL)"
497 -chmod 755 "$(DESTDIR)${bindir}/$(EMACSFULL)"
498 ifndef NO_BIN_LINK
499 rm -f "$(DESTDIR)${bindir}/$(EMACS)"
500 cd "$(DESTDIR)${bindir}" && $(LN_S_FILEONLY) $(EMACSFULL) $(EMACS)
501 endif
502 else
503 subdir=${ns_appresdir}/site-lisp && ${write_subdir}
504 rm -rf ${ns_appresdir}/share
505 endif
507 ### Windows-specific install target for installing programs produced
508 ### in nt/, and its Posix do-nothing shadow.
509 install-:
510 install-nt:
511 $(MAKE) -C $(NTDIR) install
513 ## In the share directory, we are deleting:
514 ## applications (with emacs.desktop, also found in etc/)
515 ## emacs (basically empty except for unneeded site-lisp directories)
516 ## icons (duplicates etc/images/icons/hicolor)
518 ## This is install-etc for everything except self-contained-ns builds.
519 ## For them, it is empty.
520 INSTALL_ARCH_INDEP_EXTRA = @INSTALL_ARCH_INDEP_EXTRA@
522 ## http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg01672.html
523 ## Needs to be the user running install, so configure can't set it.
524 set_installuser=for installuser in $${LOGNAME} $${USERNAME} $${USER} \
525 `id -un 2> /dev/null`; do \
526 [ -n "$${installuser}" ] && break ; \
527 done
529 ### Install the files that are machine-independent.
530 ### Most of them come straight from the distribution; the exception is
531 ### the DOC file, which is copied from the build directory.
533 ## We delete each directory in ${COPYDESTS} before we copy into it;
534 ## that way, we can reinstall over directories that have been put in
535 ## place with their files read-only (perhaps because they are checked
536 ## into RCS). In order to make this safe, we make sure that the
537 ## source exists and is distinct from the destination.
539 ## We delete etc/DOC* because there may be irrelevant DOC files from
540 ## other builds in the source directory. This is ok because we just
541 ## deleted the entire installed etc/ directory and recreated it.
542 ## install-etcdoc installs the relevant DOC.
544 ## Note that we install etc/refcards/*.ps if present.
545 ## TODO we should compress these if GZIP_PROG is set.
546 ## It would be simpler to have a separate install rule for etc/refcards
547 ## (maybe move it to doc/refcards?).
549 ## Note that the Makefiles in the etc directory are potentially useful
550 ## in an installed Emacs, so should not be excluded.
552 ## We always create the _default_ locallisppath directories, and
553 ## ensure that they contain a subdirs.el file (via write_subdir).
554 ## This is true even if locallisppath has a non-default value.
555 ## In case of non-default value, we used to create the specified directories,
556 ## but not add subdirs.el to them. This was a strange halfway house.
557 ## Nowadays we do not create non-default directories.
559 ## Note that we use tar instead of plain old cp -R/-r because the latter
560 ## is apparently not portable (even in 2012!).
561 ## http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00278.html
562 ## I have no idea which platforms Emacs supports where cp -R does not
563 ## work correctly, and therefore no idea when tar can be replaced.
564 ## See also these comments from 2004 about cp -r working fine:
565 ## http://lists.gnu.org/archive/html/autoconf-patches/2004-11/msg00005.html
566 install-arch-indep: lisp install-info install-man ${INSTALL_ARCH_INDEP_EXTRA}
567 -set ${COPYDESTS} ; \
568 unset CDPATH; \
569 $(set_installuser); \
570 for dir in ${COPYDIR} ; do \
571 [ -d $${dir} ] || exit 1 ; \
572 dest="$$1" ; shift ; \
573 if [ -d "$${dest}" ]; then \
574 exp_dest=`cd "$${dest}" && /bin/pwd`; \
575 [ "$$exp_dest" = "`cd $${dir} && /bin/pwd`" ] && continue ; \
576 else true; \
577 fi; \
578 rm -rf "$${dest}" ; \
579 umask 022; ${MKDIR_P} "$${dest}" ; \
580 printf 'Copying %s to %s...\n' "$$dir" "$$dest" ; \
581 (cd $${dir}; tar -chf - . ) \
582 | (cd "$${dest}"; umask 022; \
583 tar -xvf - && cat > /dev/null) || exit 1; \
584 if [ "$${dir}" = "${srcdir}/etc" ]; then \
585 rm -f "$${dest}/DOC"* ; \
586 rm -f "$${dest}/refcards"/*.aux "$${dest}/refcards"/*.dvi; \
587 rm -f "$${dest}/refcards"/*.log; \
588 else true; \
589 fi; \
590 (cd "$${dest}" || exit 1; \
591 for subdir in `find . -type d -print` ; do \
592 chmod a+rx $${subdir} ; \
593 rm -f $${subdir}/.gitignore ; \
594 rm -f $${subdir}/.arch-inventory ; \
595 rm -f $${subdir}/.DS_Store ; \
596 rm -f $${subdir}/#* ; \
597 rm -f $${subdir}/.#* ; \
598 rm -f $${subdir}/*~ ; \
599 rm -f $${subdir}/*.orig ; \
600 rm -f $${subdir}/ChangeLog* ; \
601 [ "$${dir}" != "${srcdir}/etc" ] && \
602 rm -f $${subdir}/[mM]akefile*[.-]in $${subdir}/[mM]akefile ; \
603 done ); \
604 find "$${dest}" -exec chown $${installuser} {} ';' ;\
605 done
606 -rm -f "$(DESTDIR)${lispdir}/subdirs.el"
607 umask 022; $(srcdir)/build-aux/update-subdirs "$(DESTDIR)${lispdir}"
608 subdir="$(DESTDIR)${datadir}/emacs/${version}/site-lisp" ; \
609 ${write_subdir}
610 subdir="$(DESTDIR)${datadir}/emacs/site-lisp" ; \
611 ${write_subdir} || true
612 [ -z "${GZIP_PROG}" ] || { \
613 echo "Compressing *.el etc. ..." && \
614 cd "$(DESTDIR)${lispdir}" && \
615 for f in `find . -name "*.elc" -print | sed 's/.elc$$/.el/'`; do \
616 ${GZIP_PROG} -9n "$$f"; \
617 done; \
618 ${GZIP_PROG} -9n "../etc/publicsuffix.txt"; \
620 -chmod -R a+r "$(DESTDIR)${datadir}/emacs/${version}" ${COPYDESTS}
622 ## The above chmods are needed because "umask 022; tar ..." is not
623 ## guaranteed to do the right thing; eg if we are root and tar is
624 ## preserving source permissions.
626 ## Note that install-arch-indep deletes and recreates the entire
627 ## installed etc/ directory, so we need it to run before this does.
628 install-etcdoc: src install-arch-indep
629 -unset CDPATH; \
630 umask 022; ${MKDIR_P} "$(DESTDIR)${etcdocdir}" ; \
631 exp_etcdocdir=`cd "$(DESTDIR)${etcdocdir}"; /bin/pwd`; \
632 if [ "`cd ./etc; /bin/pwd`" != "$$exp_etcdocdir" ]; \
633 then \
634 docfile="DOC"; \
635 printf 'Copying %s to %s ...\n' "etc/$$docfile" \
636 "$(DESTDIR)${etcdocdir}"; \
637 ${INSTALL_DATA} etc/$${docfile} "$(DESTDIR)${etcdocdir}/$${docfile}"; \
638 $(set_installuser); \
639 chown $${installuser} "$(DESTDIR)${etcdocdir}/$${docfile}" || true ; \
640 else true; fi
642 ## FIXME:
643 ## If info/dir is missing, but we have install-info, we should let
644 ## that handle it. If info/dir is present and we do not have install-info,
645 ## we should check for missing entries and add them by hand.
647 ## FIXME:
648 ## If HAVE_MAKEINFO = no and there are no info files, do not install info/dir.
649 install-info: info
650 umask 022; ${MKDIR_P} "$(DESTDIR)${infodir}"
651 -unset CDPATH; \
652 thisdir=`/bin/pwd`; \
653 exp_infodir=`cd "$(DESTDIR)${infodir}" && /bin/pwd`; \
654 if [ "`cd ${srcdir}/info && /bin/pwd`" = "$$exp_infodir" ]; then \
655 true; \
656 else \
657 [ -f "$(DESTDIR)${infodir}/dir" ] || \
658 [ ! -f ${srcdir}/info/dir ] || \
659 ${INSTALL_DATA} ${srcdir}/info/dir "$(DESTDIR)${infodir}/dir"; \
660 info_misc=`$(MAKE) --no-print-directory -s -C doc/misc echo-info`; \
661 cd ${srcdir}/info ; \
662 for elt in ${INFO_NONMISC} $${info_misc}; do \
663 test "$(HAVE_MAKEINFO)" = "no" && test ! -f $$elt && continue; \
664 for f in `ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
665 (cd "$${thisdir}"; \
666 ${INSTALL_DATA} ${srcdir}/info/$$f "$(DESTDIR)${infodir}/$$f"); \
667 [ -n "${GZIP_PROG}" ] || continue ; \
668 rm -f "$(DESTDIR)${infodir}/$$f.gz"; \
669 ${GZIP_PROG} -9n "$(DESTDIR)${infodir}/$$f"; \
670 done; \
671 (cd "$${thisdir}"; \
672 ${INSTALL_INFO} --info-dir="$(DESTDIR)${infodir}" "$(DESTDIR)${infodir}/$$elt"); \
673 done; \
676 ## "gzip || true" is because some gzips exit with non-zero status
677 ## if compression would not reduce the file size. Eg, the gzip in
678 ## OpenBSD 4.9 seems to do this (2013/03). In Emacs, this can
679 ## only happen with the tiny ctags.1 manpage. We don't really care if
680 ## ctags.1 is compressed or not. "gzip -f" is another option here,
681 ## but not sure if portable.
682 install-man:
683 umask 022; ${MKDIR_P} "$(DESTDIR)${man1dir}"
684 thisdir=`/bin/pwd`; \
685 cd ${mansrcdir}; \
686 for page in *.1; do \
687 test "$$page" = ChangeLog.1 && continue; \
688 dest=`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1; \
689 (cd "$${thisdir}"; \
690 ${INSTALL_DATA} ${mansrcdir}/$${page} "$(DESTDIR)${man1dir}/$${dest}"); \
691 [ -n "${GZIP_PROG}" ] || continue ; \
692 rm -f "$(DESTDIR)${man1dir}/$${dest}.gz"; \
693 ${GZIP_PROG} -9n "$(DESTDIR)${man1dir}/$${dest}" || true; \
694 done
696 ## Install those items from etc/ that need to end up elsewhere.
698 ## If you prefer, choose "emacs22" at installation time.
699 ## Note: emacs22 does not have all the resolutions.
700 EMACS_ICON=emacs
702 install-etc:
703 umask 022; ${MKDIR_P} "$(DESTDIR)${desktopdir}"
704 tmp=etc/emacs.tmpdesktop; rm -f $${tmp}; \
705 emacs_name=`echo emacs | sed '$(TRANSFORM)'`; \
706 sed -e "/^Exec=emacs/ s/emacs/$${emacs_name}/" \
707 -e "/^Icon=emacs/ s/emacs/$${emacs_name}/" \
708 ${srcdir}/etc/emacs.desktop > $${tmp}; \
709 ${INSTALL_DATA} $${tmp} "$(DESTDIR)${desktopdir}/${EMACS_NAME}.desktop"; \
710 rm -f $${tmp}
711 umask 022; ${MKDIR_P} "$(DESTDIR)${appdatadir}"
712 tmp=etc/emacs.tmpappdata; rm -f $${tmp}; \
713 sed -e "s/emacs\.desktop/${EMACS_NAME}.desktop/" \
714 ${srcdir}/etc/emacs.appdata.xml > $${tmp}; \
715 ${INSTALL_DATA} $${tmp} "$(DESTDIR)${appdatadir}/${EMACS_NAME}.appdata.xml"; \
716 rm -f $${tmp}
717 thisdir=`/bin/pwd`; \
718 cd ${iconsrcdir} || exit 1; umask 022 ; \
719 for dir in */*/apps */*/mimetypes; do \
720 [ -d $${dir} ] || continue ; \
721 ( cd "$${thisdir}"; ${MKDIR_P} "$(DESTDIR)${icondir}/$${dir}" ) ; \
722 for icon in $${dir}/${EMACS_ICON}[.-]*; do \
723 [ -r $${icon} ] || continue ; \
724 ext=`echo "$${icon}" | sed -e 's|.*\.||'`; \
725 dest=`echo "$${icon}" | sed -e 's|.*/||' -e "s|\\.$${ext}\$$||" -e 's/$(EMACS_ICON)/emacs/' -e '$(TRANSFORM)'`.$${ext} ; \
726 ( cd "$${thisdir}"; \
727 ${INSTALL_DATA} ${iconsrcdir}/$${icon} "$(DESTDIR)${icondir}/$${dir}/$${dest}" ) \
728 || exit 1; \
729 done ; \
730 done
732 ### Build Emacs and install it, stripping binaries while installing them.
733 install-strip:
734 $(MAKE) INSTALL_STRIP=-s install
736 ### Delete all the installed files that the 'install' target would
737 ### create (but not the noninstalled files such as 'make all' would create).
739 ### Don't delete the lisp and etc directories if they're in the source tree.
740 uninstall: uninstall-$(NTDIR) uninstall-doc
741 $(MAKE) -C lib-src uninstall
742 -unset CDPATH; \
743 for dir in "$(DESTDIR)${lispdir}" "$(DESTDIR)${etcdir}" ; do \
744 if [ -d "$${dir}" ]; then \
745 case `cd "$${dir}" ; /bin/pwd` in \
746 "`cd ${srcdir} ; /bin/pwd`"* ) ;; \
747 * ) rm -rf "$${dir}" ;; \
748 esac ; \
749 case "$${dir}" in \
750 "$(DESTDIR)${datadir}/emacs/${version}"/* ) \
751 rm -rf "$(DESTDIR)${datadir}/emacs/${version}" \
752 ;; \
753 esac ; \
754 fi ; \
755 done
756 -rm -rf "$(DESTDIR)${libexecdir}/emacs/${version}"
757 thisdir=`/bin/pwd`; \
758 (info_misc=`$(MAKE) --no-print-directory -s -C doc/misc echo-info`; \
759 if cd "$(DESTDIR)${infodir}"; then \
760 for elt in ${INFO_NONMISC} $${info_misc}; do \
761 (cd "$${thisdir}"; \
762 $(INSTALL_INFO) --remove --info-dir="$(DESTDIR)${infodir}" "$(DESTDIR)${infodir}/$$elt"); \
763 if [ -n "${GZIP_PROG}" ]; then \
764 ext=.gz; else ext=; fi; \
765 rm -f $$elt$$ext $$elt-[1-9]$$ext $$elt-[1-9][0-9]$$ext; \
766 done; \
768 (if [ -n "${GZIP_PROG}" ]; then \
769 ext=.gz; else ext=; fi; \
770 if cd ${mansrcdir}; then \
771 for page in *.1; do \
772 rm -f "$(DESTDIR)${man1dir}"/`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1$$ext; done; \
774 (cd "$(DESTDIR)${bindir}" && rm -f $(EMACSFULL) $(EMACS) || true)
775 (if cd "$(DESTDIR)${icondir}"; then \
776 rm -f hicolor/*x*/apps/${EMACS_NAME}.png \
777 hicolor/scalable/apps/${EMACS_NAME}.svg \
778 hicolor/scalable/mimetypes/`echo emacs-document | sed '$(TRANSFORM)'`.svg; \
780 -rm -f "$(DESTDIR)${desktopdir}/${EMACS_NAME}.desktop"
781 -rm -f "$(DESTDIR)${appdatadir}/${EMACS_NAME}.appdata.xml"
782 for file in snake-scores tetris-scores; do \
783 file="$(DESTDIR)${gamedir}/$${file}"; \
784 [ -s "$${file}" ] || rm -f "$$file"; \
785 done
787 ### Windows-specific uninstall target for removing programs produced
788 ### in nt/, and its Posix do-nothing shadow.
789 uninstall-:
790 uninstall-nt:
791 $(MAKE) -C $(NTDIR) uninstall
793 # ==================== Cleaning up and miscellanea ====================
795 .PHONY: mostlyclean clean distclean bootstrap-clean maintainer-clean extraclean
797 ## Eg:
798 ## src_clean:
799 ## make -C src clean
800 define submake_template
801 .PHONY: $(1)_$(2)
802 $(1)_$(2):
803 $$(MAKE) -C $(1) $(2)
804 endef
806 ### 'mostlyclean'
807 ### Like 'clean', but may refrain from deleting a few files that people
808 ### normally don't want to recompile. For example, the 'mostlyclean'
809 ### target for GCC does not delete 'libgcc.a', because recompiling it
810 ### is rarely necessary and takes a lot of time.
811 mostlyclean_dirs = src oldXMenu lwlib lib lib-src nt doc/emacs doc/misc \
812 doc/lispref doc/lispintro
814 $(foreach dir,$(mostlyclean_dirs),$(eval $(call submake_template,$(dir),mostlyclean)))
816 mostlyclean: $(mostlyclean_dirs:=_mostlyclean)
817 for dir in test/automated; do \
818 [ ! -d $$dir ] || $(MAKE) -C $$dir mostlyclean; \
819 done
821 ### 'clean'
822 ### Delete all files from the current directory that are normally
823 ### created by building the program. Don't delete the files that
824 ### record the configuration. Also preserve files that could be made
825 ### by building, but normally aren't because the distribution comes
826 ### with them.
828 ### Delete '.dvi' files here if they are not part of the distribution.
829 clean_dirs = $(mostlyclean_dirs) nextstep
831 $(foreach dir,$(clean_dirs),$(eval $(call submake_template,$(dir),clean)))
833 clean: $(clean_dirs:=_clean)
834 for dir in test/automated admin/charsets; do \
835 [ ! -d $$dir ] || $(MAKE) -C $$dir clean; \
836 done
837 -rm -f *.tmp etc/*.tmp*
838 -rm -rf info-dir.*
840 ### 'bootclean'
841 ### Delete all files that need to be remade for a clean bootstrap.
842 top_bootclean=\
843 rm -f config.cache config.log ${srcdir}/doc/man/emacs.1
845 ### 'distclean'
846 ### Delete all files from the current directory that are created by
847 ### configuring or building the program. If you have unpacked the
848 ### source and built the program without creating any other files,
849 ### 'make distclean' should leave only the files that were in the
850 ### distribution.
851 top_distclean=\
852 ${top_bootclean}; \
853 rm -f config.status config.log~ Makefile stamp-h1 ${SUBDIR_MAKEFILES}
855 distclean_dirs = $(clean_dirs) leim lisp
857 $(foreach dir,$(distclean_dirs),$(eval $(call submake_template,$(dir),distclean)))
859 maybeclean_dirs = test/automated admin/grammars admin/unidata admin/charsets
861 distclean: $(distclean_dirs:=_distclean)
862 for dir in ${maybeclean_dirs}; do \
863 [ ! -d $$dir ] || $(MAKE) -C $$dir distclean; \
864 done
865 ${top_distclean}
867 ### 'bootstrap-clean'
868 ### Delete everything that can be reconstructed by 'make' and that
869 ### needs to be deleted in order to force a bootstrap from a clean state.
870 $(foreach dir,$(distclean_dirs),$(eval $(call submake_template,$(dir),bootstrap-clean)))
872 bootstrap-clean: $(distclean_dirs:=_bootstrap-clean)
873 for dir in ${maybeclean_dirs}; do \
874 [ ! -d $$dir ] || $(MAKE) -C $$dir bootstrap-clean; \
875 done
876 [ ! -f config.log ] || mv -f config.log config.log~
877 rm -rf ${srcdir}/info
878 rm -f ${srcdir}/etc/refcards/emacsver.tex
879 ${top_bootclean}
881 ### 'maintainer-clean'
882 ### Delete everything from the current directory that can be
883 ### reconstructed with this Makefile. This typically includes
884 ### everything deleted by distclean, plus more: C source files
885 ### produced by Bison, tags tables, info files, and so on.
887 ### One exception, however: 'make maintainer-clean' should not delete
888 ### 'configure' even if 'configure' can be remade using a rule in the
889 ### Makefile. More generally, 'make maintainer-clean' should not delete
890 ### anything that needs to exist in order to run 'configure' and then
891 ### begin to build the program.
892 top_maintainer_clean=\
893 ${top_distclean}; \
894 rm -fr autom4te.cache
896 maintainer_clean_dirs = src leim lisp
898 $(foreach dir,$(maintainer_clean_dirs),$(eval $(call submake_template,$(dir),maintainer-clean)))
900 maintainer-clean: bootstrap-clean $(maintainer_clean_dirs:=_maintainer-clean)
901 for dir in ${maybeclean_dirs}; do \
902 [ ! -d $$dir ] || $(MAKE) -C $$dir maintainer-clean; \
903 done
904 ${top_maintainer_clean}
906 ### This doesn't actually appear in the coding standards, but Karl
907 ### says GCC supports it, and that's where the configuration part of
908 ### the coding standards seem to come from. It's like distclean, but
909 ### it deletes backup and autosave files too.
910 ### Note that we abuse this in some subdirectories (eg leim),
911 ### to delete some generated files that are slow to rebuild.
912 extraclean_dirs = ${NTDIR} lib-src src leim \
913 admin/charsets admin/grammars admin/unidata
915 $(foreach dir,$(extraclean_dirs),$(eval $(call submake_template,$(dir),extraclean)))
917 extraclean: $(extraclean_dirs:=_extraclean)
918 ${top_maintainer_clean}
919 -rm -f config-tmp-*
920 -rm -f *~ \#*
922 # The src subdir knows how to do the right thing
923 # even when the build directory and source dir are different.
924 .PHONY: TAGS tags
925 TAGS tags: lib lib-src src
926 $(MAKE) -C src tags
928 check check-expensive: all
929 @if test ! -d test/automated; then \
930 echo "You do not seem to have the test/ directory."; \
931 echo "Maybe you are using a release tarfile, rather than a repository checkout."; \
932 else \
933 $(MAKE) -C test/automated $@; \
936 dist:
937 cd ${srcdir}; ./make-dist
939 DVIS = lispref-dvi lispintro-dvi emacs-dvi misc-dvi
940 HTMLS = lispref-html lispintro-html emacs-html misc-html
941 INFOS = lispref-info lispintro-info emacs-info misc-info
942 PDFS = lispref-pdf lispintro-pdf emacs-pdf misc-pdf
943 PSS = lispref-ps lispintro-ps emacs-ps misc-ps
945 DOCS = $(DVIS) $(HTMLS) $(INFOS) $(PDFS) $(PSS)
946 $(DOCS):
947 $(MAKE) -C doc/$(subst -, ,$@)
949 .PHONY: $(DOCS) docs pdf ps
950 .PHONY: info dvi dist check check-expensive html info-real info-dir check-info
952 ## TODO add etc/refcards.
953 docs: $(DOCS)
954 dvi: $(DVIS)
955 html: $(HTMLS)
956 info-real: $(INFOS)
957 pdf: $(PDFS)
958 ps: $(PSS)
960 info-dir: ${srcdir}/info/dir
962 ## Hopefully doc/misc/*.texi is not too long for some systems?
963 srcdir_doc_info_dir_inputs = \
964 ${srcdir}/doc/emacs/emacs.texi \
965 ${srcdir}/doc/lispintro/emacs-lisp-intro.texi \
966 ${srcdir}/doc/lispref/elisp.texi \
967 $(sort $(wildcard ${srcdir}/doc/misc/*.texi))
968 info_dir_inputs = \
969 ../build-aux/dir_top \
970 $(subst ${srcdir}/doc/,,${srcdir_doc_info_dir_inputs})
971 info_dir_deps = \
972 ${srcdir}/build-aux/make-info-dir \
973 ${srcdir}/build-aux/dir_top \
974 ${srcdir_doc_info_dir_inputs}
976 ## It would be much simpler if info/dir was only created in the
977 ## installation location by the install-info rule, but we also
978 ## need one in the source directory for people running uninstalled.
979 ## FIXME it would be faster to use the install-info program if we have it,
980 ## but then we would need to depend on info-real, which would
981 ## slow down parallelization.
982 ${srcdir}/info/dir: ${info_dir_deps}
983 $(AM_V_at)${MKDIR_P} ${srcdir}/info
984 $(AM_V_GEN)tempfile=info-dir.$$$$; \
985 rm -f $${tempfile}; \
986 (cd ${srcdir}/doc && \
987 AWK='${AWK}' ../build-aux/make-info-dir ${info_dir_inputs} \
988 ) >$$tempfile && \
989 ${srcdir}/build-aux/move-if-change $${tempfile} ${srcdir}/info/dir
991 INSTALL_DVI = install-emacs-dvi install-lispref-dvi \
992 install-lispintro-dvi install-misc-dvi
993 INSTALL_HTML = install-emacs-html install-lispref-html \
994 install-lispintro-html install-misc-html
995 INSTALL_PDF = install-emacs-pdf install-lispref-pdf \
996 install-lispintro-pdf install-misc-pdf
997 INSTALL_PS = install-emacs-ps install-lispref-ps \
998 install-lispintro-ps install-misc-ps
999 INSTALL_DOC = $(INSTALL_DVI) $(INSTALL_HTML) $(INSTALL_PDF) $(INSTALL_PS)
1001 ## Install non .info forms of the documentation.
1002 ## TODO add etc/refcards.
1003 $(INSTALL_DOC):
1004 $(MAKE) -C doc/$(subst -, install-,$(subst install-,,$@))
1006 .PHONY: $(INSTALL_DOC) install-doc
1007 .PHONY: install-dvi install-html install-pdf install-ps
1009 install-doc: $(INSTALL_DOC)
1010 install-dvi: $(INSTALL_DVI)
1011 install-html: $(INSTALL_HTML)
1012 install-pdf: $(INSTALL_PDF)
1013 install-ps: $(INSTALL_PS)
1016 UNINSTALL_DVI = uninstall-emacs-dvi uninstall-lispref-dvi \
1017 uninstall-lispintro-dvi uninstall-misc-dvi
1018 UNINSTALL_HTML = uninstall-emacs-html uninstall-lispref-html \
1019 uninstall-lispintro-html uninstall-misc-html
1020 UNINSTALL_PDF = uninstall-emacs-pdf uninstall-lispref-pdf \
1021 uninstall-lispintro-pdf uninstall-misc-pdf
1022 UNINSTALL_PS = uninstall-emacs-ps uninstall-lispref-ps \
1023 uninstall-lispintro-ps uninstall-misc-ps
1024 UNINSTALL_DOC = $(UNINSTALL_DVI) $(UNINSTALL_HTML) $(UNINSTALL_PDF) $(UNINSTALL_PS)
1026 $(UNINSTALL_DOC):
1027 $(MAKE) -C doc/$(subst -, uninstall-,$(subst uninstall-,,$@))
1029 .PHONY: $(UNINSTALL_DOC) uninstall-doc
1030 .PHONY: uninstall-dvi uninstall-html uninstall-pdf uninstall-ps
1032 uninstall-doc: $(UNINSTALL_DOC)
1033 uninstall-dvi: $(UNINSTALL_DVI)
1034 uninstall-html: $(UNINSTALL_HTML)
1035 uninstall-pdf: $(UNINSTALL_PDF)
1036 uninstall-ps: $(UNINSTALL_PS)
1039 # Note that man/Makefile knows how to put the info files in $(srcdir),
1040 # so we can do ok running make in the build dir.
1041 # This used to have a clause that exited with an error if MAKEINFO = no.
1042 # But it is inappropriate to do so without checking if makeinfo is
1043 # actually needed - it is not if the info files are up-to-date. (Bug#3982)
1044 # Only the doc/*/Makefiles can decide that, so we let those rules run
1045 # and give a standard error if makeinfo is needed but missing.
1046 # While it would be nice to give a more detailed error message, that
1047 # would require changing every rule in doc/ that builds an info file,
1048 # and it's not worth it. This case is only relevant if you download a
1049 # release, then change the .texi files.
1050 info:
1051 ifneq ($(HAVE_MAKEINFO),no)
1052 $(MAKE) info-real info-dir
1053 endif
1055 ## build-aux/make-info-dir expects only certain dircategories.
1056 check-info: info
1057 cd info ; \
1058 bad= ; \
1059 for file in *; do \
1060 test -f "$${file}" || continue ; \
1061 case $${file} in \
1062 *-[0-9]*|COPYING|dir) continue ;; \
1063 esac ; \
1064 cat=`sed -n 's/^INFO-DIR-SECTION //p' $${file}`; \
1065 case $${cat} in \
1066 "Texinfo documentation system" | "Emacs"| "Emacs lisp" | \
1067 "Emacs editing modes" | "Emacs network features" | \
1068 "Emacs misc features" | "Emacs lisp libraries" ) : ;; \
1069 *) bad="$${bad} $${file}" ;; \
1070 esac; \
1071 done ; \
1072 if test -n "$${bad}"; then \
1073 echo "Unexpected dircategory in: $${bad}" ; \
1074 exit 1 ; \
1075 fi ; \
1076 echo "info files are OK"
1078 #### Bootstrapping.
1080 ### This first cleans the lisp subdirectory, removing all compiled
1081 ### Lisp files. Then re-run make to build all the files anew.
1083 .PHONY: bootstrap
1085 # Bootstrapping does the following:
1086 # * Remove files to start from a bootstrap-clean slate.
1087 # * Run autogen.sh.
1088 # * Rebuild Makefile, to update the build procedure itself.
1089 # * Do the actual build.
1090 bootstrap: bootstrap-clean
1091 cd $(srcdir) && ./autogen.sh
1092 $(MAKE) MAKEFILE_NAME=force-Makefile force-Makefile
1093 $(MAKE) all
1095 .PHONY: ChangeLog change-history change-history-commit change-history-nocommit
1096 .PHONY: emacs-25-branch-is-current unchanged-history-files
1098 CHANGELOG = ChangeLog
1099 emacslog = build-aux/gitlog-to-emacslog
1100 # The ChangeLog history files are called ChangeLog.1, ChangeLog.2, ...,
1101 # ChangeLog.$(CHANGELOG_HISTORY_INDEX_MAX). $(CHANGELOG_N) stands for
1102 # the newest (highest-numbered) ChangeLog history file.
1103 CHANGELOG_HISTORY_INDEX_MAX = 2
1104 CHANGELOG_N = ChangeLog.$(CHANGELOG_HISTORY_INDEX_MAX)
1106 # Convert git commit log to ChangeLog file. make-dist uses this.
1107 # I guess this is PHONY so it always updates?
1108 ChangeLog:
1109 $(AM_V_GEN)cd $(srcdir) && \
1110 ./$(emacslog) -o $(CHANGELOG) -n $(CHANGELOG_HISTORY_INDEX_MAX)
1112 # Check that we are in a good state for changing history.
1113 emacs-25-branch-is-current:
1114 git branch | grep -q '^\* emacs-25$$'
1115 unchanged-history-files:
1116 x=$$(git diff-files --name-only $(CHANGELOG_N) $(emacslog)) && \
1117 test -z "$$x"
1119 # Regular expression that matches the newest commit covered by a ChangeLog.
1120 new_commit_regexp = ^commit [0123456789abcdef]* (inclusive)
1122 # Copy newer commit messages to the start of the ChangeLog history file,
1123 # and consider them to be older.
1124 change-history-nocommit: emacs-25-branch-is-current unchanged-history-files
1125 -rm -f ChangeLog.tmp
1126 $(MAKE) ChangeLog CHANGELOG=ChangeLog.tmp
1127 sed '/^This file records repository revisions/,$$d' \
1128 ChangeLog.tmp >$(CHANGELOG_N).tmp
1129 new_commit_line=`grep '$(new_commit_regexp)' ChangeLog.tmp` && \
1130 sed 's/$(new_commit_regexp).*/'"$$new_commit_line/" \
1131 $(CHANGELOG_N) >>$(CHANGELOG_N).tmp
1132 rm ChangeLog.tmp
1133 mv $(CHANGELOG_N).tmp $(CHANGELOG_N)
1135 change-history: change-history-nocommit
1136 $(MAKE) $@-commit
1138 # If 'make change-history' fails because the newest ChangeLog history
1139 # file contains invalid text, fix the file by hand and then run
1140 # 'make change-history-commit'.
1141 change-history-commit:
1142 git commit -m'; make $@' $(CHANGELOG_N) $(emacslog)
1144 .PHONY: check-declare
1146 check-declare:
1147 @if [ ! -f $(srcdir)/src/emacs ]; then \
1148 echo "You must build Emacs to use this command"; \
1149 exit 1; \
1151 $(MAKE) -C lisp $@