Fix references in EIEIO documentation.
[emacs.git] / Makefile.in
blobe69998e3e524fb9753370f172ea440e7dd384cc2
1 ### @configure_input@
3 # Copyright (C) 1992-2014 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 SHELL = @SHELL@
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@
168 abs_srcdir=@abs_srcdir@
169 # MinGW CPPFLAGS may use this.
170 abs_top_srcdir=@abs_top_srcdir@
172 # Where the manpage source files are kept.
173 mansrcdir=$(srcdir)/doc/man
175 # Tell make where to find source files; this is needed for the makefiles.
176 VPATH=@srcdir@
178 # Where to find the application default.
179 x_default_search_path=@x_default_search_path@
181 # Where the etc/emacs.desktop file is to be installed.
182 desktopdir=$(datarootdir)/applications
184 # Where the etc/images/icons/hicolor directory is to be installed.
185 icondir=$(datarootdir)/icons
187 # The source directory for the icon files.
188 iconsrcdir=$(srcdir)/etc/images/icons
190 # ==================== Emacs-specific directories ====================
192 # These variables hold the values Emacs will actually use. They are
193 # based on the values of the standard Make variables above.
195 # Where to install the lisp files distributed with Emacs.
196 # This includes the Emacs version, so that the lisp files for different
197 # versions of Emacs will install themselves in separate directories.
198 lispdir=@lispdir@
200 # Directories Emacs should search for standard lisp files.
201 # The default is ${lispdir}.
202 standardlisppath=@standardlisppath@
204 # Directories Emacs should search for lisp files specific to this
205 # site (i.e. customizations), before consulting ${standardlisppath}.
206 # This should be a colon-separated list of directories.
207 locallisppath=@locallisppath@
209 # Where Emacs will search to find its lisp files. Before
210 # changing this, check to see if your purpose wouldn't
211 # better be served by changing locallisppath. This
212 # should be a colon-separated list of directories.
213 # The default is ${locallisppath}:${standardlisppath}.
214 lisppath=@lisppath@
216 # Where Emacs will search for its lisp files while building.
217 # This is only used during the process of compiling Emacs,
218 # to help Emacs find its lisp files before they've been installed
219 # in their final location.
220 # This should be a colon-separated list of directories.
221 # Normally it points to the lisp/ directory in the sources.
222 # NB lread.c relies on lisp/ being first here.
223 buildlisppath=${abs_srcdir}/lisp
225 # Where to install the other architecture-independent
226 # data files distributed with Emacs (like the tutorial,
227 # the cookie recipes and the Zippy database). This path
228 # usually contains the Emacs version number, so the data
229 # files for multiple versions of Emacs may be installed
230 # at once.
231 etcdir=@etcdir@
233 # Where to put executables to be run by Emacs rather than
234 # the user. This path usually includes the Emacs version
235 # and configuration name, so that multiple configurations
236 # for multiple versions of Emacs may be installed at
237 # once.
238 archlibdir=@archlibdir@
240 # Where to put the etc/DOC file.
241 etcdocdir=@etcdocdir@
243 # Where to install Emacs game score files.
244 gamedir=@gamedir@
246 # ==================== Utility Programs for the Build ====================
248 # Allow the user to specify the install program.
249 # Note that if the system does not provide a suitable install,
250 # configure will use build-aux/install-sh. Annoyingly, it does
251 # not use an absolute path. So we must take care to always run
252 # INSTALL-type commands from the directory containing the Makefile.
253 # This explains (I think) the cd thisdir seen in several install rules.
254 INSTALL = @INSTALL@
255 INSTALL_PROGRAM = @INSTALL_PROGRAM@
256 INSTALL_DATA = @INSTALL_DATA@
257 INSTALL_INFO = @INSTALL_INFO@
258 # By default, we uphold the dignity of our programs.
259 INSTALL_STRIP =
260 MKDIR_P = @MKDIR_P@
261 # Create a link to a file in the same directory as the target.
262 LN_S_FILEONLY = @LN_S_FILEONLY@
264 # We use gzip to compress installed .el files.
265 GZIP_PROG = @GZIP_PROG@
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
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.
288 COPYDIR = ${srcdir}/etc ${srcdir}/lisp
289 COPYDESTS = "$(DESTDIR)${etcdir}" "$(DESTDIR)${lispdir}"
291 all: ${SUBDIR}
293 .PHONY: all ${SUBDIR} blessmail epaths-force epaths-force-w32 FRC
295 removenullpaths=sed -e 's/^:*//' -e 's/:*$$//g' -e 's/::*/:/g'
297 # Generate epaths.h from epaths.in. This target is invoked by `configure'.
298 # See comments in configure.ac for why it is done this way, as opposed
299 # to just letting configure generate epaths.h from epaths.in in a
300 # similar way to how Makefile is made from Makefile.in.
301 epaths-force: FRC
302 @(standardlisppath=`echo "${standardlisppath}" | ${removenullpaths}` ; \
303 locallisppath=`echo "${locallisppath}" | ${removenullpaths}` ; \
304 buildlisppath=`echo "${buildlisppath}" | ${removenullpaths}` ; \
305 x_default_search_path=`echo ${x_default_search_path}`; \
306 gamedir=`echo ${gamedir}`; \
307 sed < ${srcdir}/src/epaths.in > epaths.h.$$$$ \
308 -e 's;\(#.*PATH_LOADSEARCH\).*$$;\1 "'"$${standardlisppath}"'";' \
309 -e 's;\(#.*PATH_SITELOADSEARCH\).*$$;\1 "'"$${locallisppath}"'";' \
310 -e 's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "'"$${buildlisppath}"'";' \
311 -e 's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";' \
312 -e 's;\(#.*PATH_INFO\).*$$;\1 "${infodir}";' \
313 -e 's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";' \
314 -e 's;\(#.*PATH_BITMAPS\).*$$;\1 "${bitmapdir}";' \
315 -e 's;\(#.*PATH_X_DEFAULTS\).*$$;\1 "${x_default_search_path}";' \
316 -e 's;\(#.*PATH_GAME\).*$$;\1 "${gamedir}";' \
317 -e 's;\(#.*PATH_DOC\).*$$;\1 "${etcdocdir}";') && \
318 ${srcdir}/build-aux/move-if-change epaths.h.$$$$ src/epaths.h
320 # Replace "${w32prefix}" with '%emacs_dir%' (which expands to install
321 # directory at runtime).
322 msys_w32prefix_subst=sed -e 's!\(^\|;\)'"$${w32prefixpattern}"'\([;/]\|$$\)!\1%emacs_dir%\2!g'
324 # Quote Sed special characters (except backslash and newline) with
325 # a double backslash.
326 msys_sed_sh_escape=sed -e 's/[];$$*.^[]/\\\\&/g'
328 # The w32 build needs a slightly different editing, and it uses
329 # nt/epaths.nt as the template.
331 # Use the value of ${locallisppath} supplied by `configure',
332 # to support the --enable-locallisppath argument.
334 # In this case, the paths written to 'src/epaths.h' must be in native
335 # MS-Windows format (e.g. 'c:/foo/bar'), because temacs is a MinGW
336 # program that doesn't support MSYS-style paths (e.g. '/c/foo/bar' or
337 # '/foo/bar').
338 epaths-force-w32: FRC
339 @(w32srcdir=`${srcdir}/build-aux/msys-to-w32 "${srcdir}"`; \
340 w32prefix=`${srcdir}/build-aux/msys-to-w32 "${prefix}" N`; \
341 w32prefixpattern=`echo "$${w32prefix}" | ${msys_sed_sh_escape}` ; \
342 w32locallisppath=`${srcdir}/build-aux/msys-to-w32 "${locallisppath}" N ":" "\\;" | ${msys_w32prefix_subst}` ; \
343 sed < ${srcdir}/nt/epaths.nt > epaths.h.$$$$ \
344 -e 's;\(#.*PATH_SITELOADSEARCH\).*$$;\1 "'"$${w32locallisppath}"'";' \
345 -e '/^.*#/s/@VER@/${version}/g' \
346 -e '/^.*#/s/@CFG@/${configuration}/g' \
347 -e "/^.*#/s|@SRC@|$${w32srcdir}|g") && \
348 ${srcdir}/build-aux/move-if-change epaths.h.$$$$ src/epaths.h
350 # If lib/Makefile would build files in '.', then build them before
351 # building 'lib', to avoid races with parallel makes.
352 lib: am--refresh
354 lib-src src: $(NTDIR) lib
356 src: lib-src
358 # We need to build `emacs' in `src' to compile the *.elc files in `lisp'.
359 lisp: src
361 # These targets should be "${SUBDIR} without `src'".
362 lib lib-src lisp nt: Makefile FRC
363 cd $@ && $(MAKE) all $(MFLAGS) \
364 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
365 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}'
367 # Pass to src/Makefile.in an additional BOOTSTRAPEMACS variable which
368 # is either set to bootstrap-emacs (in case bootstrap-emacs has not been
369 # constructed yet) or the empty string (otherwise).
370 # src/Makefile.in uses it to implement conditional dependencies, so that
371 # files that need bootstrap-emacs to be built do not additionally need
372 # to be kept fresher than bootstrap-emacs. Otherwise changing a single
373 # file src/foo.c forces dumping a new bootstrap-emacs, then re-byte-compiling
374 # all preloaded elisp files, and only then dump the actual src/emacs, which
375 # is not wrong, but is overkill in 99.99% of the cases.
377 # Note the use of single quotes in the value of vcswitness.
378 # This passes an unexpanded $srcdir to src's Makefile, which then
379 # expands it using its own value of srcdir (which points to the
380 # source directory of src/).
381 src: Makefile FRC
382 dirstate='.bzr/checkout/dirstate'; \
383 vcswitness='$$(srcdir)/../'$$dirstate; \
384 [ -r "$(srcdir)/$$dirstate" ] || vcswitness=''; \
385 cd $@ || exit; \
386 boot=bootstrap-emacs$(EXEEXT); \
387 [ ! -x "$$boot" ] || boot=''; \
388 $(MAKE) all $(MFLAGS) \
389 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
390 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="$$boot" \
391 VCSWITNESS="$$vcswitness"
393 blessmail: Makefile src FRC
394 cd lib-src && $(MAKE) maybe-blessmail $(MFLAGS) \
395 MAKE='${MAKE}' archlibdir='$(archlibdir)'
397 # We used to have one rule per */Makefile.in, but that leads to race
398 # conditions with parallel makes, so let's assume that the time stamp on
399 # ./Makefile is representative of the time stamp on all the other Makefiles.
401 # config.status overrides MAKEFILE_NAME with a bogus name when creating
402 # src/epaths.h, so that 'make epaths-force' does not recursively invoke
403 # config.status and overwrite config.status while executing it (Bug#11214).
405 # 'make bootstrap' overrides MAKEFILE_NAME to a nonexistent file but
406 # then attempts to build that file. This forces 'Makefile', 'lib/Makefile',
407 # etc. to be built without running into similar recursion problems.
408 MAKEFILE_NAME = Makefile
409 $(MAKEFILE_NAME): config.status $(srcdir)/src/config.in \
410 $(srcdir)/Makefile.in $(SUBDIR_MAKEFILES_IN) $(srcdir)/src/lisp.mk
411 MAKE='$(MAKE)' ./config.status
413 # Don't erase these files if make is interrupted while refreshing them.
414 .PRECIOUS: Makefile config.status
416 config.status: ${srcdir}/configure ${srcdir}/lisp/version.el
417 if [ -x ./config.status ]; then \
418 $(CFG) ./config.status --recheck; \
419 else \
420 $(CFG) $(srcdir)/configure $(CONFIGURE_FLAGS); \
423 AUTOCONF_INPUTS = $(srcdir)/configure.ac $(srcdir)/aclocal.m4
425 $(srcdir)/configure: $(AUTOCONF_INPUTS)
426 cd ${srcdir} && autoconf
428 ACLOCAL_INPUTS = $(srcdir)/configure.ac $(srcdir)/m4/gnulib-comp.m4
429 $(srcdir)/aclocal.m4: $(ACLOCAL_INPUTS)
430 cd $(srcdir) && aclocal -I m4
432 AUTOMAKE_INPUTS = $(srcdir)/aclocal.m4 $(srcdir)/lib/Makefile.am \
433 $(srcdir)/lib/gnulib.mk
434 $(srcdir)/lib/Makefile.in: $(AUTOMAKE_INPUTS)
435 cd $(srcdir) && automake --gnu -a -c lib/Makefile
437 # Regenerate files that this makefile would have made, if this makefile
438 # had been built by Automake. The name 'am--refresh' is for
439 # compatibility with subsidiary Automake-generated makefiles.
440 am--refresh: $(srcdir)/aclocal.m4 $(srcdir)/configure $(srcdir)/src/config.in
441 .PHONY: am--refresh
443 $(srcdir)/src/config.in: $(srcdir)/src/stamp-h.in
444 @ # Usually, there's no need to rebuild src/config.in just
445 @ # because stamp-h.in has changed (since building stamp-h.in
446 @ # refreshes config.in as well), but if config.in is missing
447 @ # then we really need to do something more.
448 [ -r "$@" ] || ( cd ${srcdir} && autoheader )
449 $(srcdir)/src/stamp-h.in: $(AUTOCONF_INPUTS)
450 cd ${srcdir} && autoheader
451 rm -f $(srcdir)/src/stamp-h.in
452 echo timestamp > $(srcdir)/src/stamp-h.in
454 # ==================== Installation ====================
456 .PHONY: install install-arch-dep install-arch-indep install-etcdoc install-info
457 .PHONY: install-man install-etc install-strip install-$(NTDIR)
458 .PHONY: uninstall uninstall-$(NTDIR)
460 ## If we let lib-src do its own installation, that means we
461 ## don't have to duplicate the list of utilities to install in
462 ## this Makefile as well.
464 install: all install-arch-indep install-etcdoc install-arch-dep install-$(NTDIR) blessmail
465 @true
467 ## Ensure that $subdir contains a subdirs.el file.
468 ## Here and elsewhere, we set the umask so that any created files are
469 ## world-readable.
470 ## TODO it might be good to warn about non-standard permissions of
471 ## pre-existing directories, but that does not seem easy.
472 write_subdir=if [ -f "$${subdir}/subdirs.el" ]; \
473 then true; \
474 else \
475 umask 022; \
476 ${MKDIR_P} "$${subdir}"; \
477 (echo "(if (fboundp 'normal-top-level-add-subdirs-to-load-path)"; \
478 echo " (normal-top-level-add-subdirs-to-load-path))") \
479 > "$${subdir}/subdirs.el"; \
482 ### Install the executables that were compiled specifically for this machine.
483 ### We do install-arch-indep first because the executable needs the
484 ### Lisp files and DOC file to work properly.
485 install-arch-dep: src install-arch-indep install-etcdoc install-$(NTDIR)
486 umask 022; ${MKDIR_P} "$(DESTDIR)${bindir}"
487 cd lib-src && \
488 $(MAKE) install $(MFLAGS) prefix="${prefix}" \
489 exec_prefix="${exec_prefix}" bindir="${bindir}" \
490 libexecdir="${libexecdir}" archlibdir="${archlibdir}" \
491 INSTALL_STRIP=${INSTALL_STRIP}
492 if test "${ns_self_contained}" = "no"; then \
493 ${INSTALL_PROGRAM} $(INSTALL_STRIP) src/emacs${EXEEXT} "$(DESTDIR)${bindir}/$(EMACSFULL)" || exit 1 ; \
494 chmod 1755 "$(DESTDIR)${bindir}/$(EMACSFULL)" || true; \
495 if test "x${NO_BIN_LINK}" = x; then \
496 rm -f "$(DESTDIR)${bindir}/$(EMACS)" ; \
497 cd "$(DESTDIR)${bindir}" && $(LN_S_FILEONLY) $(EMACSFULL) $(EMACS); \
498 fi; \
499 else \
500 subdir=${ns_appresdir}/site-lisp; \
501 ${write_subdir} || exit 1; \
502 rm -rf ${ns_appresdir}/share; \
505 ### Windows-specific install target for installing programs produced
506 ### in nt/, and its Posix do-nothing shadow.
507 install-:
508 install-nt:
509 cd $(NTDIR) && \
510 $(MAKE) install $(MFLAGS) prefix="${prefix}" \
511 exec_prefix="${exec_prefix}" bindir="${bindir}" \
512 libexecdir="${libexecdir}" archlibdir="${archlibdir}" \
513 INSTALL_STRIP=${INSTALL_STRIP}
515 ## In the share directory, we are deleting:
516 ## applications (with emacs.desktop, also found in etc/)
517 ## emacs (basically empty except for unneeded site-lisp directories)
518 ## icons (duplicates etc/images/icons/hicolor)
520 ## This is install-etc for everything except self-contained-ns builds.
521 ## For them, it is empty.
522 INSTALL_ARCH_INDEP_EXTRA = @INSTALL_ARCH_INDEP_EXTRA@
524 ## http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg01672.html
525 ## Needs to be the user running install, so configure can't set it.
526 set_installuser=for installuser in $${LOGNAME} $${USERNAME} $${USER} \
527 `id -un 2> /dev/null`; do \
528 [ -n "$${installuser}" ] && break ; \
529 done
531 ### Install the files that are machine-independent.
532 ### Most of them come straight from the distribution; the exception is
533 ### the DOC file, which is copied from the build directory.
535 ## We delete each directory in ${COPYDESTS} before we copy into it;
536 ## that way, we can reinstall over directories that have been put in
537 ## place with their files read-only (perhaps because they are checked
538 ## into RCS). In order to make this safe, we make sure that the
539 ## source exists and is distinct from the destination.
541 ## We delete etc/DOC* because there may be irrelevant DOC files from
542 ## other builds in the source directory. This is ok because we just
543 ## deleted the entire installed etc/ directory and recreated it.
544 ## install-etcdoc installs the relevant DOC.
546 ## Note that we install etc/refcards/*.ps if present.
547 ## TODO we should compress these if GZIP_PROG is set.
548 ## It would be simpler to have a separate install rule for etc/refcards
549 ## (maybe move it to doc/refcards?).
551 ## Note that the Makefiles in the etc directory are potentially useful
552 ## in an installed Emacs, so should not be excluded.
554 ## We always create the _default_ locallisppath directories, and
555 ## ensure that they contain a subdirs.el file (via write_subdir).
556 ## This is true even if locallisppath has a non-default value.
557 ## In case of non-default value, we used to create the specified directories,
558 ## but not add subdirs.el to them. This was a strange halfway house.
559 ## Nowadays we do not create non-default directories.
561 ## Note that we use tar instead of plain old cp -R/-r because the latter
562 ## is apparently not portable (even in 2012!).
563 ## http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00278.html
564 ## I have no idea which platforms Emacs supports where cp -R does not
565 ## work correctly, and therefore no idea when tar can be replaced.
566 ## See also these comments from 2004 about cp -r working fine:
567 ## http://lists.gnu.org/archive/html/autoconf-patches/2004-11/msg00005.html
568 install-arch-indep: lisp install-info install-man ${INSTALL_ARCH_INDEP_EXTRA}
569 -set ${COPYDESTS} ; \
570 unset CDPATH; \
571 $(set_installuser); \
572 for dir in ${COPYDIR} ; do \
573 [ -d $${dir} ] || exit 1 ; \
574 dest="$$1" ; shift ; \
575 if [ -d "$${dest}" ]; then \
576 exp_dest=`cd "$${dest}" && /bin/pwd`; \
577 [ "$$exp_dest" = "`cd $${dir} && /bin/pwd`" ] && continue ; \
578 else true; \
579 fi; \
580 rm -rf "$${dest}" ; \
581 umask 022; ${MKDIR_P} "$${dest}" ; \
582 echo "Copying $${dir} to $${dest}..." ; \
583 (cd $${dir}; tar -chf - . ) \
584 | (cd "$${dest}"; umask 022; \
585 tar -xvf - && cat > /dev/null) || exit 1; \
586 if [ "$${dir}" = "${srcdir}/etc" ]; then \
587 rm -f "$${dest}/DOC"* ; \
588 rm -f "$${dest}/refcards"/*.aux "$${dest}/refcards"/*.dvi; \
589 rm -f "$${dest}/refcards"/*.log; \
590 else true; \
591 fi; \
592 (cd "$${dest}" || exit 1; \
593 for subdir in `find . -type d -print` ; do \
594 chmod a+rx $${subdir} ; \
595 rm -f $${subdir}/.gitignore ; \
596 rm -f $${subdir}/.arch-inventory ; \
597 rm -f $${subdir}/.DS_Store ; \
598 rm -f $${subdir}/\#* ; \
599 rm -f $${subdir}/.\#* ; \
600 rm -f $${subdir}/*~ ; \
601 rm -f $${subdir}/*.orig ; \
602 rm -f $${subdir}/ChangeLog* ; \
603 [ "$${dir}" != "${srcdir}/etc" ] && \
604 rm -f $${subdir}/[mM]akefile*[.-]in $${subdir}/[mM]akefile ; \
605 done ); \
606 find "$${dest}" -exec chown $${installuser} {} ';' ;\
607 done
608 -rm -f "$(DESTDIR)${lispdir}/subdirs.el"
609 umask 022; $(srcdir)/build-aux/update-subdirs "$(DESTDIR)${lispdir}"
610 subdir="$(DESTDIR)${datadir}/emacs/${version}/site-lisp" ; \
611 ${write_subdir}
612 subdir="$(DESTDIR)${datadir}/emacs/site-lisp" ; \
613 ${write_subdir} || true
614 [ -z "${GZIP_PROG}" ] || \
615 ( echo "Compressing *.el ..." ; \
616 unset CDPATH; \
617 thisdir=`/bin/pwd`; \
618 for dir in "$(DESTDIR)${lispdir}"; do \
619 cd "$${thisdir}" ; \
620 cd "$${dir}" || exit 1 ; \
621 for f in `find . -name "*.elc" -print`; do \
622 f_el=`echo "$$f" | sed 's/.elc$$/.el/'`; \
623 ${GZIP_PROG} -9n "$$f_el" ; \
624 done ; \
625 done )
626 -chmod -R a+r "$(DESTDIR)${datadir}/emacs/${version}" ${COPYDESTS}
628 ## The above chmods are needed because "umask 022; tar ..." is not
629 ## guaranteed to do the right thing; eg if we are root and tar is
630 ## preserving source permissions.
632 ## Note that install-arch-indep deletes and recreates the entire
633 ## installed etc/ directory, so we need it to run before this does.
634 install-etcdoc: src install-arch-indep
635 -unset CDPATH; \
636 umask 022; ${MKDIR_P} "$(DESTDIR)${etcdocdir}" ; \
637 exp_etcdocdir=`cd "$(DESTDIR)${etcdocdir}"; /bin/pwd`; \
638 if [ "`cd ./etc; /bin/pwd`" != "$$exp_etcdocdir" ]; \
639 then \
640 docfile="DOC"; \
641 echo "Copying etc/$${docfile} to $(DESTDIR)${etcdocdir} ..." ; \
642 ${INSTALL_DATA} etc/$${docfile} "$(DESTDIR)${etcdocdir}/$${docfile}"; \
643 $(set_installuser); \
644 chown $${installuser} "$(DESTDIR)${etcdocdir}/$${docfile}" || true ; \
645 else true; fi
647 ## FIXME:
648 ## If info/dir is missing, but we have install-info, we should let
649 ## that handle it. If info/dir is present and we do not have install-info,
650 ## we should check for missing entries and add them by hand.
652 ## FIXME:
653 ## If HAVE_MAKEINFO = no and there are no info files, do not install info/dir.
654 install-info: info
655 umask 022; ${MKDIR_P} "$(DESTDIR)${infodir}"
656 -unset CDPATH; \
657 thisdir=`/bin/pwd`; \
658 exp_infodir=`cd "$(DESTDIR)${infodir}" && /bin/pwd`; \
659 if [ "`cd ${srcdir}/info && /bin/pwd`" = "$$exp_infodir" ]; then \
660 true; \
661 else \
662 [ -f "$(DESTDIR)${infodir}/dir" ] || \
663 [ ! -f ${srcdir}/info/dir ] || \
664 ${INSTALL_DATA} ${srcdir}/info/dir "$(DESTDIR)${infodir}/dir"; \
665 info_misc=`cd doc/misc && $(QUIET_SUBMAKE) $(MAKE) -s echo-info`; \
666 cd ${srcdir}/info ; \
667 for elt in ${INFO_NONMISC} $${info_misc}; do \
668 test "$(HAVE_MAKEINFO)" = "no" && test ! -f $$elt && continue; \
669 for f in `ls $$elt $$elt-[1-9] $$elt-[1-9][0-9] 2>/dev/null`; do \
670 (cd "$${thisdir}"; \
671 ${INSTALL_DATA} ${srcdir}/info/$$f "$(DESTDIR)${infodir}/$$f"); \
672 [ -n "${GZIP_PROG}" ] || continue ; \
673 rm -f "$(DESTDIR)${infodir}/$$f.gz"; \
674 ${GZIP_PROG} -9n "$(DESTDIR)${infodir}/$$f"; \
675 done; \
676 (cd "$${thisdir}"; \
677 ${INSTALL_INFO} --info-dir="$(DESTDIR)${infodir}" "$(DESTDIR)${infodir}/$$elt"); \
678 done; \
681 ## "gzip || true" is because some gzips exit with non-zero status
682 ## if compression would not reduce the file size. Eg, the gzip in
683 ## OpenBSD 4.9 seems to do this (2013/03). In Emacs, this can
684 ## only happen with the tiny ctags.1 manpage. We don't really care if
685 ## ctags.1 is compressed or not. "gzip -f" is another option here,
686 ## but not sure if portable.
687 install-man:
688 umask 022; ${MKDIR_P} "$(DESTDIR)${man1dir}"
689 thisdir=`/bin/pwd`; \
690 cd ${mansrcdir}; \
691 for page in *.1; do \
692 dest=`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1; \
693 (cd "$${thisdir}"; \
694 ${INSTALL_DATA} ${mansrcdir}/$${page} "$(DESTDIR)${man1dir}/$${dest}"); \
695 [ -n "${GZIP_PROG}" ] || continue ; \
696 rm -f "$(DESTDIR)${man1dir}/$${dest}.gz"; \
697 ${GZIP_PROG} -9n "$(DESTDIR)${man1dir}/$${dest}" || true; \
698 done
700 ## Install those items from etc/ that need to end up elsewhere.
702 ## If you prefer, choose "emacs22" at installation time.
703 ## Note: emacs22 does not have all the resolutions.
704 EMACS_ICON=emacs
706 install-etc:
707 umask 022; ${MKDIR_P} "$(DESTDIR)${desktopdir}"
708 tmp=etc/emacs.tmpdesktop; rm -f $${tmp}; \
709 emacs_name=`echo emacs | sed '$(TRANSFORM)'`; \
710 sed -e "/^Exec=emacs/ s/emacs/$${emacs_name}/" \
711 -e "/^Icon=emacs/ s/emacs/$${emacs_name}/" \
712 ${srcdir}/etc/emacs.desktop > $${tmp}; \
713 ${INSTALL_DATA} $${tmp} "$(DESTDIR)${desktopdir}/${EMACS_NAME}.desktop"; \
714 rm -f $${tmp}
715 thisdir=`/bin/pwd`; \
716 cd ${iconsrcdir} || exit 1; umask 022 ; \
717 for dir in */*/apps */*/mimetypes; do \
718 [ -d $${dir} ] || continue ; \
719 ( cd "$${thisdir}"; ${MKDIR_P} "$(DESTDIR)${icondir}/$${dir}" ) ; \
720 for icon in $${dir}/${EMACS_ICON}[.-]*; do \
721 [ -r $${icon} ] || continue ; \
722 ext=`echo "$${icon}" | sed -e 's|.*\.||'`; \
723 dest=`echo "$${icon}" | sed -e 's|.*/||' -e "s|\.$${ext}$$||" -e 's/$(EMACS_ICON)/emacs/' -e '$(TRANSFORM)'`.$${ext} ; \
724 ( cd "$${thisdir}"; \
725 ${INSTALL_DATA} ${iconsrcdir}/$${icon} "$(DESTDIR)${icondir}/$${dir}/$${dest}" ) \
726 || exit 1; \
727 done ; \
728 done
730 ### Build Emacs and install it, stripping binaries while installing them.
731 install-strip:
732 $(MAKE) $(MFLAGS) INSTALL_STRIP=-s install
734 ### Delete all the installed files that the `install' target would
735 ### create (but not the noninstalled files such as `make all' would create).
737 ### Don't delete the lisp and etc directories if they're in the source tree.
738 uninstall: uninstall-$(NTDIR) uninstall-doc
739 cd lib-src && \
740 $(MAKE) $(MFLAGS) uninstall \
741 prefix="${prefix}" exec_prefix="${exec_prefix}" \
742 bindir="${bindir}" libexecdir="${libexecdir}" \
743 archlibdir="${archlibdir}"
745 -unset CDPATH; \
746 for dir in "$(DESTDIR)${lispdir}" "$(DESTDIR)${etcdir}" ; do \
747 if [ -d "$${dir}" ]; then \
748 case `cd "$${dir}" ; /bin/pwd` in \
749 "`cd ${srcdir} ; /bin/pwd`"* ) ;; \
750 * ) rm -rf "$${dir}" ;; \
751 esac ; \
752 case "$${dir}" in \
753 "$(DESTDIR)${datadir}/emacs/${version}"/* ) \
754 rm -rf "$(DESTDIR)${datadir}/emacs/${version}" \
755 ;; \
756 esac ; \
757 fi ; \
758 done
759 -rm -rf "$(DESTDIR)${libexecdir}/emacs/${version}"
760 thisdir=`/bin/pwd`; \
761 (info_misc=`cd doc/misc && $(QUIET_SUBMAKE) $(MAKE) -s echo-info`; \
762 if cd "$(DESTDIR)${infodir}"; then \
763 for elt in ${INFO_NONMISC} $${info_misc}; do \
764 (cd "$${thisdir}"; \
765 $(INSTALL_INFO) --remove --info-dir="$(DESTDIR)${infodir}" "$(DESTDIR)${infodir}/$$elt"); \
766 if [ -n "${GZIP_PROG}" ]; then \
767 ext=.gz; else ext=; fi; \
768 rm -f $$elt$$ext $$elt-[1-9]$$ext $$elt-[1-9][0-9]$$ext; \
769 done; \
771 (if [ -n "${GZIP_PROG}" ]; then \
772 ext=.gz; else ext=; fi; \
773 if cd ${mansrcdir}; then \
774 for page in *.1; do \
775 rm -f "$(DESTDIR)${man1dir}"/`echo "$${page}" | sed -e 's/\.1$$//' -e '$(TRANSFORM)'`.1$$ext; done; \
777 (cd "$(DESTDIR)${bindir}" && rm -f $(EMACSFULL) $(EMACS) || true)
778 (if cd "$(DESTDIR)${icondir}"; then \
779 rm -f hicolor/*x*/apps/${EMACS_NAME}.png \
780 hicolor/scalable/apps/${EMACS_NAME}.svg \
781 hicolor/scalable/mimetypes/`echo emacs-document | sed '$(TRANSFORM)'`.svg; \
783 -rm -f "$(DESTDIR)${desktopdir}/${EMACS_NAME}.desktop"
784 for file in snake-scores tetris-scores; do \
785 file="$(DESTDIR)${gamedir}/$${file}"; \
786 [ -s "$${file}" ] || rm -f "$$file"; \
787 done
789 ### Windows-specific uninstall target for removing programs produced
790 ### in nt/, and its Posix do-nothing shadow.
791 uninstall-:
792 uninstall-nt:
793 cd $(NTDIR) && \
794 $(MAKE) $(MFLAGS) uninstall \
795 prefix="${prefix}" exec_prefix="${exec_prefix}" \
796 bindir="${bindir}" libexecdir="${libexecdir}" \
797 archlibdir="${archlibdir}"
799 FRC:
801 # ==================== Cleaning up and miscellanea ====================
803 .PHONY: mostlyclean clean distclean bootstrap-clean maintainer-clean extraclean
805 ### `mostlyclean'
806 ### Like `clean', but may refrain from deleting a few files that people
807 ### normally don't want to recompile. For example, the `mostlyclean'
808 ### target for GCC does not delete `libgcc.a', because recompiling it
809 ### is rarely necessary and takes a lot of time.
810 mostlyclean: FRC
811 cd src && $(MAKE) $(MFLAGS) mostlyclean
812 cd oldXMenu && $(MAKE) $(MFLAGS) mostlyclean
813 cd lwlib && $(MAKE) $(MFLAGS) mostlyclean
814 cd lib && $(MAKE) $(MFLAGS) mostlyclean
815 cd lib-src && $(MAKE) $(MFLAGS) mostlyclean
816 cd nt && $(MAKE) $(MFLAGS) mostlyclean
817 -cd doc/emacs && $(MAKE) $(MFLAGS) mostlyclean
818 -cd doc/misc && $(MAKE) $(MFLAGS) mostlyclean
819 -cd doc/lispref && $(MAKE) $(MFLAGS) mostlyclean
820 -cd doc/lispintro && $(MAKE) $(MFLAGS) mostlyclean
822 ### `clean'
823 ### Delete all files from the current directory that are normally
824 ### created by building the program. Don't delete the files that
825 ### record the configuration. Also preserve files that could be made
826 ### by building, but normally aren't because the distribution comes
827 ### with them.
829 ### Delete `.dvi' files here if they are not part of the distribution.
830 clean: FRC
831 -rm -f etc/emacs.tmpdesktop
832 cd src && $(MAKE) $(MFLAGS) clean
833 cd oldXMenu && $(MAKE) $(MFLAGS) clean
834 cd lwlib && $(MAKE) $(MFLAGS) clean
835 cd lib && $(MAKE) $(MFLAGS) clean
836 cd lib-src && $(MAKE) $(MFLAGS) clean
837 cd nt && $(MAKE) $(MFLAGS) clean
838 -cd doc/emacs && $(MAKE) $(MFLAGS) clean
839 -cd doc/misc && $(MAKE) $(MFLAGS) clean
840 -cd doc/lispref && $(MAKE) $(MFLAGS) clean
841 -cd doc/lispintro && $(MAKE) $(MFLAGS) clean
842 cd nextstep && $(MAKE) $(MFLAGS) clean
844 ### `bootclean'
845 ### Delete all files that need to be remade for a clean bootstrap.
846 top_bootclean=\
847 rm -f config.cache config.log
848 ### `distclean'
849 ### Delete all files from the current directory that are created by
850 ### configuring or building the program. If you have unpacked the
851 ### source and built the program without creating any other files,
852 ### `make distclean' should leave only the files that were in the
853 ### distribution.
854 top_distclean=\
855 ${top_bootclean}; \
856 rm -f config.status config.log~ Makefile stamp-h1 ${SUBDIR_MAKEFILES}
857 distclean: FRC
858 cd src && $(MAKE) $(MFLAGS) distclean
859 cd oldXMenu && $(MAKE) $(MFLAGS) distclean
860 cd lwlib && $(MAKE) $(MFLAGS) distclean
861 cd lib && $(MAKE) $(MFLAGS) distclean
862 cd lib-src && $(MAKE) $(MFLAGS) distclean
863 cd nt && $(MAKE) $(MFLAGS) distclean
864 cd doc/emacs && $(MAKE) $(MFLAGS) distclean
865 cd doc/misc && $(MAKE) $(MFLAGS) distclean
866 cd doc/lispref && $(MAKE) $(MFLAGS) distclean
867 cd doc/lispintro && $(MAKE) $(MFLAGS) distclean
868 cd leim && $(MAKE) $(MFLAGS) distclean
869 cd lisp && $(MAKE) $(MFLAGS) distclean
870 cd nextstep && $(MAKE) $(MFLAGS) distclean
871 for dir in test/automated admin/grammars admin/unidata; do \
872 [ ! -d $$dir ] || (cd $$dir && $(MAKE) $(MFLAGS) distclean); \
873 done
874 ${top_distclean}
876 ### `bootstrap-clean'
877 ### Delete everything that can be reconstructed by `make' and that
878 ### needs to be deleted in order to force a bootstrap from a clean state.
879 bootstrap-clean: FRC
880 cd src && $(MAKE) $(MFLAGS) bootstrap-clean
881 cd oldXMenu && $(MAKE) $(MFLAGS) maintainer-clean
882 cd lwlib && $(MAKE) $(MFLAGS) maintainer-clean
883 cd lib && $(MAKE) $(MFLAGS) maintainer-clean
884 cd lib-src && $(MAKE) $(MFLAGS) maintainer-clean
885 cd nt && $(MAKE) $(MFLAGS) maintainer-clean
886 -cd doc/emacs && $(MAKE) $(MFLAGS) maintainer-clean
887 -cd doc/misc && $(MAKE) $(MFLAGS) maintainer-clean
888 -cd doc/lispref && $(MAKE) $(MFLAGS) maintainer-clean
889 -cd doc/lispintro && $(MAKE) $(MFLAGS) maintainer-clean
890 cd leim && $(MAKE) $(MFLAGS) bootstrap-clean
891 cd lisp && $(MAKE) $(MFLAGS) bootstrap-clean
892 cd nextstep && $(MAKE) $(MFLAGS) maintainer-clean
893 for dir in test/automated admin/grammars admin/unidata; do \
894 [ ! -d $$dir ] || (cd $$dir && $(MAKE) $(MFLAGS) bootstrap-clean); \
895 done
896 [ ! -f config.log ] || mv -f config.log config.log~
897 rm -rf ${srcdir}/info
898 ${top_bootclean}
900 ### `maintainer-clean'
901 ### Delete everything from the current directory that can be
902 ### reconstructed with this Makefile. This typically includes
903 ### everything deleted by distclean, plus more: C source files
904 ### produced by Bison, tags tables, info files, and so on.
906 ### One exception, however: `make maintainer-clean' should not delete
907 ### `configure' even if `configure' can be remade using a rule in the
908 ### Makefile. More generally, `make maintainer-clean' should not delete
909 ### anything that needs to exist in order to run `configure' and then
910 ### begin to build the program.
911 top_maintainer_clean=\
912 ${top_distclean}; \
913 rm -fr autom4te.cache
914 maintainer-clean: bootstrap-clean FRC
915 cd src && $(MAKE) $(MFLAGS) maintainer-clean
916 cd leim && $(MAKE) $(MFLAGS) maintainer-clean
917 cd lisp && $(MAKE) $(MFLAGS) maintainer-clean
918 for dir in test/automated admin/grammars admin/unidata; do \
919 [ ! -d $$dir ] || (cd $$dir && $(MAKE) $(MFLAGS) maintainer-clean); \
920 done
921 ${top_maintainer_clean}
923 ### This doesn't actually appear in the coding standards, but Karl
924 ### says GCC supports it, and that's where the configuration part of
925 ### the coding standards seem to come from. It's like distclean, but
926 ### it deletes backup and autosave files too.
927 extraclean:
928 for i in ${SUBDIR}; do (cd $$i; $(MAKE) $(MFLAGS) extraclean); done
929 ${top_maintainer_clean}
930 -rm -f config-tmp-*
931 -rm -f *~ \#*
933 # The src subdir knows how to do the right thing
934 # even when the build directory and source dir are different.
935 .PHONY: TAGS tags
936 TAGS tags: lib lib-src src
937 cd src; $(MAKE) $(MFLAGS) tags
939 check: all
940 @if test ! -d test/automated; then \
941 echo "You do not seem to have the test/ directory."; \
942 echo "Maybe you are using a release tarfile, rather than a repository checkout."; \
943 else \
944 cd test/automated && $(MAKE) $(MFLAGS) check; \
947 dist:
948 cd ${srcdir}; ./make-dist
950 DVIS = lispref-dvi lispintro-dvi emacs-dvi misc-dvi
951 HTMLS = lispref-html lispintro-html emacs-html misc-html
952 INFOS = lispref-info lispintro-info emacs-info misc-info
953 PDFS = lispref-pdf lispintro-pdf emacs-pdf misc-pdf
954 PSS = lispref-ps lispintro-ps emacs-ps misc-ps
956 DOCS = $(DVIS) $(HTMLS) $(INFOS) $(PDFS) $(PSS)
957 $(DOCS):
958 t=$@; IFS=-; set $$t; IFS=; cd doc/$$1 && $(MAKE) $(MFLAGS) $$2
960 .PHONY: $(DOCS) docs pdf ps
961 .PHONY: info dvi dist check html info-real info-dir force-info check-info
963 ## TODO add etc/refcards.
964 docs: $(DOCS)
965 dvi: $(DVIS)
966 html: $(HTMLS)
967 info-real: $(INFOS)
968 pdf: $(PDFS)
969 ps: $(PSS)
971 info-dir: ${srcdir}/info/dir
973 ## Not strictly necessary, but speeds things up a bit by stopping
974 ## the info-dir rule from running when not needed.
975 ## Hopefully doc/misc/*.texi is not too long for some systems?
976 info_dir_deps = ${srcdir}/build-aux/dir_top \
977 ${srcdir}/doc/emacs/emacs.texi \
978 ${srcdir}/doc/lispintro/emacs-lisp-intro.texi \
979 ${srcdir}/doc/lispref/elisp.texi ${srcdir}/doc/misc/*.texi
981 ## It would be much simpler if info/dir was only created in the
982 ## installation location by the install-info rule, but we also
983 ## need one in the source directory for people running uninstalled.
984 ## FIXME it would be faster to use the install-info program if we have it,
985 ## but then we would need to depend on info-real, which would
986 ## slow down parallelization.
987 ${srcdir}/info/dir: ${info_dir_deps}
988 tempfile=info-dir.$$$$; \
989 rm -f $${tempfile}; \
990 thisdir=`pwd`; \
991 (cd ${srcdir} && ./build-aux/make-info-dir $${thisdir}/$${tempfile}); \
992 ${srcdir}/build-aux/move-if-change $${tempfile} ${srcdir}/info/dir
994 INSTALL_DVI = install-emacs-dvi install-lispref-dvi \
995 install-lispintro-dvi install-misc-dvi
996 INSTALL_HTML = install-emacs-html install-lispref-html \
997 install-lispintro-html install-misc-html
998 INSTALL_PDF = install-emacs-pdf install-lispref-pdf \
999 install-lispintro-pdf install-misc-pdf
1000 INSTALL_PS = install-emacs-ps install-lispref-ps \
1001 install-lispintro-ps install-misc-ps
1002 INSTALL_DOC = $(INSTALL_DVI) $(INSTALL_HTML) $(INSTALL_PDF) $(INSTALL_PS)
1004 ## Install non .info forms of the documentation.
1005 ## TODO add etc/refcards.
1006 $(INSTALL_DOC):
1007 t=$@; IFS=-; set $$t; IFS=; cd doc/$$2 && $(MAKE) $(MFLAGS) $$1-$$3
1009 .PHONY: $(INSTALL_DOC) install-doc
1010 .PHONY: install-dvi install-html install-pdf install-ps
1012 install-doc: $(INSTALL_DOC)
1013 install-dvi: $(INSTALL_DVI)
1014 install-html: $(INSTALL_HTML)
1015 install-pdf: $(INSTALL_PDF)
1016 install-ps: $(INSTALL_PS)
1019 UNINSTALL_DVI = uninstall-emacs-dvi uninstall-lispref-dvi \
1020 uninstall-lispintro-dvi uninstall-misc-dvi
1021 UNINSTALL_HTML = uninstall-emacs-html uninstall-lispref-html \
1022 uninstall-lispintro-html uninstall-misc-html
1023 UNINSTALL_PDF = uninstall-emacs-pdf uninstall-lispref-pdf \
1024 uninstall-lispintro-pdf uninstall-misc-pdf
1025 UNINSTALL_PS = uninstall-emacs-ps uninstall-lispref-ps \
1026 uninstall-lispintro-ps uninstall-misc-ps
1027 UNINSTALL_DOC = $(UNINSTALL_DVI) $(UNINSTALL_HTML) $(UNINSTALL_PDF) $(UNINSTALL_PS)
1029 $(UNINSTALL_DOC):
1030 t=$@; IFS=-; set $$t; IFS=; cd doc/$$2 && $(MAKE) $(MFLAGS) $$1-$$3
1032 .PHONY: $(UNINSTALL_DOC) uninstall-doc
1033 .PHONY: uninstall-dvi uninstall-html uninstall-pdf uninstall-ps
1035 uninstall-doc: $(UNINSTALL_DOC)
1036 uninstall-dvi: $(UNINSTALL_DVI)
1037 uninstall-html: $(UNINSTALL_HTML)
1038 uninstall-pdf: $(UNINSTALL_PDF)
1039 uninstall-ps: $(UNINSTALL_PS)
1042 force-info:
1043 # Note that man/Makefile knows how to put the info files in $(srcdir),
1044 # so we can do ok running make in the build dir.
1045 # This used to have a clause that exited with an error if MAKEINFO = no.
1046 # But it is inappropriate to do so without checking if makeinfo is
1047 # actually needed - it is not if the info files are up-to-date. (Bug#3982)
1048 # Only the doc/*/Makefiles can decide that, so we let those rules run
1049 # and give a standard error if makeinfo is needed but missing.
1050 # While it would be nice to give a more detailed error message, that
1051 # would require changing every rule in doc/ that builds an info file,
1052 # and it's not worth it. This case is only relevant if you download a
1053 # release, then change the .texi files.
1054 info: force-info
1055 @if test "$(HAVE_MAKEINFO)" = "no"; then \
1056 echo "Configured --without-makeinfo, not building manuals" ; \
1057 else \
1058 $(MAKE) $(MFLAGS) info-real info-dir; \
1061 ## build-aux/make-info-dir expects only certain dircategories.
1062 check-info: info
1063 cd info ; \
1064 bad= ; \
1065 for file in *; do \
1066 test -f "$${file}" || continue ; \
1067 case $${file} in \
1068 *-[0-9]*|COPYING|dir) continue ;; \
1069 esac ; \
1070 cat=`sed -n 's/^INFO-DIR-SECTION //p' $${file}`; \
1071 case $${cat} in \
1072 "Texinfo documentation system" | "Emacs"| "Emacs lisp" | \
1073 "Emacs editing modes" | "Emacs network features" | \
1074 "Emacs misc features" | "Emacs lisp libraries" ) : ;; \
1075 *) bad="$${bad} $${file}" ;; \
1076 esac; \
1077 done ; \
1078 if test -n "$${bad}"; then \
1079 echo "Unexpected dircategory in: $${bad}" ; \
1080 exit 1 ; \
1081 fi ; \
1082 echo "info files are OK"
1084 #### Bootstrapping.
1086 ### This first cleans the lisp subdirectory, removing all compiled
1087 ### Lisp files. Then re-run make to build all the files anew.
1089 .PHONY: bootstrap
1091 # Bootstrapping does the following:
1092 # * Remove files to start from a bootstrap-clean slate.
1093 # * Run autogen.sh.
1094 # * Rebuild Makefile, to update the build procedure itself.
1095 # * Do the actual build.
1096 bootstrap: bootstrap-clean FRC
1097 cd $(srcdir) && ./autogen.sh
1098 $(MAKE) $(MFLAGS) MAKEFILE_NAME=force-Makefile force-Makefile
1099 $(MAKE) $(MFLAGS) info all
1101 .PHONY: check-declare
1103 check-declare:
1104 @if [ ! -f $(srcdir)/src/emacs ]; then \
1105 echo "You must build Emacs to use this command"; \
1106 exit 1; \
1108 cd lisp && $(MAKE) $(MFLAGS) $@