(update-subdirs): New target.
[emacs.git] / Makefile.in
blob0ba5418083888b3a6aa3e29a14e7ea899a21e8a0
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 # make all to compile and build Emacs.
6 # make install to install it.
7 # make TAGS to update tags tables.
9 # make clean or make mostlyclean
10 # Delete all files from the current directory that are normally
11 # created by building the program. Don't delete the files that
12 # record the configuration. Also preserve files that could be made
13 # by building, but normally aren't because the distribution comes
14 # with them.
16 # Delete `.dvi' files here if they are not part of the distribution.
18 # make distclean
19 # Delete all files from the current directory that are created by
20 # configuring or building the program. If you have unpacked the
21 # source and built the program without creating any other files,
22 # `make distclean' should leave only the files that were in the
23 # distribution.
25 # make maintainer-clean
26 # Delete everything from the current directory that can be
27 # reconstructed with this Makefile. This typically includes
28 # everything deleted by distclean, plus more: C source files
29 # produced by Bison, tags tables, info files, and so on.
31 # make extraclean
32 # Still more severe - delete backup and autosave files, too.
34 SHELL = /bin/sh
36 # If Make doesn't predefine MAKE, set it here.
37 @SET_MAKE@
39 # ==================== Things `configure' Might Edit ====================
41 CC=@CC@
42 CPP=@CPP@
43 C_SWITCH_SYSTEM=@c_switch_system@
44 ALLOCA=@ALLOCA@
45 LN_S=@LN_S@
46 CFLAGS=@CFLAGS@
47 C_SWITCH_X_SITE=@C_SWITCH_X_SITE@
48 LD_SWITCH_X_SITE=@LD_SWITCH_X_SITE@
49 YACC=@YACC@
51 ### These help us choose version- and architecture-specific directories
52 ### to install files in.
54 ### This should be the number of the Emacs version we're building,
55 ### like `18.59' or `19.0'.
56 version=@version@
58 ### This should be the name of the configuration we're building Emacs
59 ### for, like `mips-dec-ultrix' or `sparc-sun-sunos'.
60 configuration=@configuration@
62 # ==================== Where To Install Things ====================
64 # The default location for installation. Everything is placed in
65 # subdirectories of this directory. The default values for many of
66 # the variables below are expressed in terms of this one, so you may
67 # not need to change them. This defaults to /usr/local.
68 prefix=@prefix@
70 # Like `prefix', but used for architecture-specific files.
71 exec_prefix=@exec_prefix@
73 # Where to install Emacs and other binaries that people will want to
74 # run directly (like etags).
75 bindir=@bindir@
77 # Where to install architecture-independent data files. ${lispdir}
78 # and ${etcdir} are subdirectories of this.
79 datadir=@datadir@
81 # Where to install and expect the files that Emacs modifies as it
82 # runs. These files are all architecture-independent. Right now, the
83 # only such data is the locking directory; ${lockdir} is a
84 # subdirectory of this.
85 sharedstatedir=@sharedstatedir@
87 # Where to install and expect executable files to be run by Emacs
88 # rather than directly by users, and other architecture-dependent
89 # data. ${archlibdir} is a subdirectory of this.
90 libexecdir=@libexecdir@
92 # Where to install Emacs's man pages, and what extension they should have.
93 mandir=@mandir@
94 manext=.1
95 man1dir=$(mandir)/man1
97 # Where to install and expect the info files describing Emacs. In the
98 # past, this defaulted to a subdirectory of ${prefix}/lib/emacs, but
99 # since there are now many packages documented with the texinfo
100 # system, it is inappropriate to imply that it is part of Emacs.
101 infodir=@infodir@
103 # Where to look for bitmap files.
104 bitmapdir=@bitmapdir@
106 # Where to find the source code. The source code for Emacs's C kernel is
107 # expected to be in ${srcdir}/src, and the source code for Emacs's
108 # utility programs is expected to be in ${srcdir}/lib-src. This is
109 # set by the configure script's `--srcdir' option.
110 srcdir=@srcdir@
112 # Tell make where to find source files; this is needed for the makefiles.
113 VPATH=@srcdir@
115 # ==================== Emacs-specific directories ====================
117 # These variables hold the values Emacs will actually use. They are
118 # based on the values of the standard Make variables above.
120 # Where to install the lisp files distributed with
121 # Emacs. This includes the Emacs version, so that the
122 # lisp files for different versions of Emacs will install
123 # themselves in separate directories.
124 lispdir=@lispdir@
126 # Directories Emacs should search for lisp files specific
127 # to this site (i.e. customizations), before consulting
128 # ${lispdir}. This should be a colon-separated list of
129 # directories.
130 locallisppath=@locallisppath@
132 # Where Emacs will search to find its lisp files. Before
133 # changing this, check to see if your purpose wouldn't
134 # better be served by changing locallisppath. This
135 # should be a colon-separated list of directories.
136 lisppath=@lisppath@
138 # Where Emacs will search for its lisp files while
139 # building. This is only used during the process of
140 # compiling Emacs, to help Emacs find its lisp files
141 # before they've been installed in their final location.
142 # It's usually identical to lisppath, except that
143 # it does not include locallisppath, and the
144 # entry for the directory containing the installed lisp
145 # files has been replaced with ../lisp. This should be a
146 # colon-separated list of directories.
147 buildlisppath=${srcdir}/lisp
149 # Where to install the other architecture-independent
150 # data files distributed with Emacs (like the tutorial,
151 # the cookie recipes and the Zippy database). This path
152 # usually contains the Emacs version number, so the data
153 # files for multiple versions of Emacs may be installed
154 # at once.
155 etcdir=@etcdir@
157 # Where to create and expect the locking directory, where
158 # the Emacs locking code keeps track of which files are
159 # currently being edited.
160 lockdir=@lockdir@
162 # Where to put executables to be run by Emacs rather than
163 # the user. This path usually includes the Emacs version
164 # and configuration name, so that multiple configurations
165 # for multiple versions of Emacs may be installed at
166 # once.
167 archlibdir=@archlibdir@
169 # Where to put the docstring file.
170 docdir=@docdir@
172 # ==================== Utility Programs for the Build ====================
174 # Allow the user to specify the install program.
175 INSTALL = @INSTALL@
176 INSTALL_PROGRAM = @INSTALL_PROGRAM@
177 INSTALL_DATA = @INSTALL_DATA@
178 # By default, we uphold the dignity of our programs.
179 INSTALL_STRIP =
181 # ============================= Targets ==============================
183 # What emacs should be called when installed.
184 EMACS = emacs
186 # Subdirectories to make recursively. `lisp' is not included
187 # because the compiled lisp files are part of the distribution
188 # and you cannot remake them without installing Emacs first.
189 SUBDIR = lib-src src
191 # The makefiles of the directories in $SUBDIR.
192 SUBDIR_MAKEFILES = lib-src/Makefile man/Makefile src/Makefile oldXMenu/Makefile lwlib/Makefile
194 # Subdirectories to install, and where they'll go.
195 # lib-src's makefile knows how to install it, so we don't do that here.
196 # When installing the info files, we need to do special things to
197 # avoid nuking an existing dir file, so we don't do that here;
198 # instead, we have written out explicit code in the `install' targets.
199 COPYDIR = ${srcdir}/etc ${srcdir}/lisp
200 COPYDESTS = ${etcdir} ${lispdir}
202 all: ${SUBDIR}
204 removenullpaths=sed -e 's/^://g' -e 's/:$$//g' -e 's/::/:/g'
206 # Generate paths.h from paths.in. This target is invoked by `configure'.
207 paths-force: FRC
208 @(lisppath=`echo ${lisppath} | ${removenullpaths}` ; \
209 buildlisppath=`echo ${buildlisppath} | ${removenullpaths}` ; \
210 sed < ${srcdir}/src/paths.in > paths.h.$$$$ \
211 -e 's;\(#.*PATH_LOADSEARCH\).*$$;\1 "'$${lisppath}'";' \
212 -e 's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "'$${buildlisppath}'";' \
213 -e 's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";' \
214 -e 's;\(#.*PATH_INFO\).*$$;\1 "${infodir}";' \
215 -e 's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";' \
216 -e 's;\(#.*PATH_BITMAPS\).*$$;\1 "${bitmapdir}";' \
217 -e 's;\(#.*PATH_DOC\).*$$;\1 "${docdir}";' \
218 -e 's;\(#.*PATH_LOCK\).*$$;\1 "${lockdir}/";') && \
219 ${srcdir}/move-if-change paths.h.$$$$ src/paths.h
221 src: lib-src FRC
223 lib-src: FRC
225 .RECURSIVE: ${SUBDIR}
227 ${SUBDIR}: ${SUBDIR_MAKEFILES} FRC
228 cd $@; $(MAKE) all $(MFLAGS) \
229 CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
230 LDFLAGS='${LDFLAGS}' MAKE='${MAKE}'
232 blessmail: ${SUBDIR_MAKEFILES} src FRC
233 cd lib-src; $(MAKE) maybe-blessmail $(MFLAGS) \
234 MAKE='${MAKE}' archlibdir='$(archlibdir)'
236 Makefile: Makefile.in config.status
237 ./config.status
239 src/Makefile: src/Makefile.in config.status
240 ./config.status
242 lib-src/Makefile: lib-src/Makefile.in config.status
243 ./config.status
245 oldXMenu/Makefile: oldXMenu/Makefile.in config.status
246 ./config.status
248 lwlib/Makefile: lwlib/Makefile.in config.status
249 ./config.status
251 # ==================== Installation ====================
253 ## If we let lib-src do its own installation, that means we
254 ## don't have to duplicate the list of utilities to install in
255 ## this Makefile as well.
257 ## On AIX, use tar xBf.
258 ## On Xenix, use tar xpf.
260 .PHONY: install mkdir
262 ## We delete each directory in ${COPYDESTS} before we copy into it;
263 ## that way, we can reinstall over directories that have been put in
264 ## place with their files read-only (perhaps because they are checked
265 ## into RCS). In order to make this safe, we make sure that the
266 ## source exists and is distinct from the destination.
267 ### We do install-arch-indep first because
268 ### the executable needs the Lisp files and DOC file to work properly.
269 install: all install-arch-indep install-arch-dep blessmail
270 @true
272 ### Install the executables that were compiled specifically for this machine.
273 ### It would be nice to do something for a parallel make
274 ### to ensure that install-arch-indep finishes before this starts.
275 install-arch-dep: mkdir
276 (cd lib-src; \
277 $(MAKE) install $(MFLAGS) prefix=${prefix} \
278 exec_prefix=${exec_prefix} bindir=${bindir} \
279 libexecdir=${libexecdir} archlibdir=${archlibdir} \
280 INSTALL_STRIP=${INSTALL_STRIP})
281 ${INSTALL_PROGRAM} $(INSTALL_STRIP) src/emacs ${bindir}/emacs-${version}
282 -chmod 1755 ${bindir}/emacs-${version}
283 rm -f ${bindir}/$(EMACS)
284 -ln ${bindir}/emacs-${version} ${bindir}/$(EMACS)
286 ### Install the files that are machine-independent.
287 ### Most of them come straight from the distribution;
288 ### the exception is the DOC-* files, which are copied
289 ### from the build directory.
291 ### Note that we copy DOC* and then delete DOC
292 ### as a workaround for a bug in tar on Ultrix 4.2.
293 install-arch-indep: mkdir
294 -set ${COPYDESTS} ; \
295 for dir in ${COPYDIR} ; do \
296 if [ `(cd $$1 && /bin/pwd)` != `(cd $${dir} && /bin/pwd)` ] ; then \
297 rm -rf $$1 ; \
298 fi ; \
299 shift ; \
300 done
301 -set ${COPYDESTS} ; \
302 mkdir ${COPYDESTS} ; \
303 chmod ugo+rx ${COPYDESTS} ; \
304 for dir in ${COPYDIR} ; do \
305 dest=$$1 ; shift ; \
306 [ -d $${dir} ] \
307 && [ `(cd $${dir} && /bin/pwd)` != `(cd $${dest} && /bin/pwd)` ] \
308 && (echo "Copying $${dir} to $${dest}..." ; \
309 (cd $${dir}; tar -cf - . )|(cd $${dest};umask 022; tar -xvf - ); \
310 for subdir in `find $${dest} -type d ! -name RCS -print` ; do \
311 rm -rf $${subdir}/RCS ; \
312 rm -rf $${subdir}/CVS ; \
313 rm -f $${subdir}/\#* ; \
314 rm -f $${subdir}/.\#* ; \
315 rm -f $${subdir}/*~ ; \
316 rm -f $${subdir}/*.orig ; \
317 rm -f $${subdir}/[mM]akefile* ; \
318 rm -f $${subdir}/ChangeLog* ; \
319 rm -f $${subdir}/dired.todo ; \
320 done) ; \
321 done
322 -rm -f ${lispdir}/subdirs.el
323 $(srcdir)/update-subdirs ${lispdir}
324 -chmod -R a+r ${COPYDESTS}
325 if [ `(cd ./etc; /bin/pwd)` != `(cd ${docdir}; /bin/pwd)` ]; \
326 then \
327 echo "Copying etc/DOC-* to ${docdir} ..." ; \
328 (cd ./etc; tar -cf - DOC*)|(cd ${docdir}; umask 0; tar -xvf - ); \
329 (cd $(docdir); chmod a+r DOC*; rm DOC) \
330 else true; fi
331 if [ -r ./lisp ] \
332 && [ x`(cd ./lisp; /bin/pwd)` != x`(cd ${lispdir}; /bin/pwd)` ] \
333 && [ x`(cd ${srcdir}/lisp; /bin/pwd)` != x`(cd ./lisp; /bin/pwd)` ]; \
334 then \
335 echo "Copying lisp/*.el and lisp/*.elc to ${lispdir} ..." ; \
336 (cd lisp; tar -cf - *.el *.elc)|(cd ${lispdir}; umask 0; tar -xvf - ); \
337 else true; fi
338 thisdir=`/bin/pwd`; \
339 if [ `(cd ${srcdir}/info && /bin/pwd)` != `(cd ${infodir} && /bin/pwd)` ]; \
340 then \
341 (cd ${infodir}; \
342 if [ -f dir ]; then \
343 if [ ! -f dir.old ]; then mv -f dir dir.old; \
344 else mv -f dir dir.bak; fi; \
345 fi; \
346 cd ${srcdir}/info ; \
347 (cd $${thisdir}; ${INSTALL_DATA} ${srcdir}/info/dir ${infodir}/dir); \
348 (cd $${thisdir}; chmod a+r ${infodir}/dir); \
349 for f in ccmode* cl* dired-x* ediff* emacs* forms* gnus* info* message* mh-e* sc* vip*; do \
350 (cd $${thisdir}; \
351 ${INSTALL_DATA} ${srcdir}/info/$$f ${infodir}/$$f; \
352 chmod a+r ${infodir}/$$f); \
353 done); \
354 else true; fi
355 thisdir=`/bin/pwd`; \
356 cd ${srcdir}/etc; \
357 for page in emacs etags ctags ; do \
358 (cd $${thisdir}; \
359 ${INSTALL_DATA} ${srcdir}/etc/$${page}.1 ${man1dir}/$${page}${manext}; \
360 chmod a+r ${man1dir}/$${page}${manext}); \
361 done
363 ### Build Emacs and install it, stripping binaries while installing them.
364 install-strip:
365 $(MAKE) INSTALL_STRIP=-s
367 ### Build all the directories we're going to install Emacs in. Since
368 ### we may be creating several layers of directories (for example,
369 ### /usr/local/lib/emacs/19.0/mips-dec-ultrix4.2), we use mkinstalldirs
370 ### instead of mkdir. Not all systems' mkdir programs have the `-p' flag.
371 mkdir: FRC
372 $(srcdir)/mkinstalldirs ${COPYDESTS} ${lockdir} ${infodir} ${man1dir} \
373 ${bindir} ${datadir} ${docdir} ${libexecdir} \
374 `echo ${locallisppath} | sed 's/:/ /g'`
375 -chmod a+rwx ${lockdir}
377 ### Delete all the installed files that the `install' target would
378 ### create (but not the noninstalled files such as `make all' would
379 ### create).
381 ### Don't delete the lisp and etc directories if they're in the source tree.
382 uninstall:
383 (cd lib-src; \
384 $(MAKE) $(MFLAGS) uninstall \
385 prefix=${prefix} exec_prefix=${exec_prefix} \
386 bindir=${bindir} libexecdir=${libexecdir} archlibdir=${archlibdir})
387 for dir in ${lispdir} ${etcdir} ; do \
388 if [ -d $${dir} ]; then \
389 case `(cd $${dir} ; /bin/pwd)` in \
390 `(cd ${srcdir} ; /bin/pwd)`* ) ;; \
391 * ) rm -rf $${dir} ;; \
392 esac ; \
393 case $${dir} in \
394 ${datadir}/emacs/${version}/* ) \
395 rm -rf ${datadir}/emacs/${version} \
396 ;; \
397 esac ; \
398 fi ; \
399 done
400 (cd ${infodir} && rm -f cl* dired-x* ediff* emacs* forms* gnus* info* mh-e* sc* vip*)
401 (cd ${man1dir} && rm -f emacs.1 etags.1 ctags.1)
402 (cd ${bindir} && rm -f emacs-${version} $(EMACS))
405 FRC:
407 # ==================== Cleaning up and miscellanea ====================
409 .PHONY: mostlyclean clean distclean maintainer-clean extraclean
411 ### `mostlyclean'
412 ### Like `clean', but may refrain from deleting a few files that people
413 ### normally don't want to recompile. For example, the `mostlyclean'
414 ### target for GCC does not delete `libgcc.a', because recompiling it
415 ### is rarely necessary and takes a lot of time.
416 mostlyclean: FRC
417 (cd src; $(MAKE) $(MFLAGS) mostlyclean)
418 (cd oldXMenu; $(MAKE) $(MFLAGS) mostlyclean)
419 (cd lwlib; $(MAKE) $(MFLAGS) mostlyclean)
420 (cd lib-src; $(MAKE) $(MFLAGS) mostlyclean)
421 -(cd man && $(MAKE) $(MFLAGS) mostlyclean)
423 ### `clean'
424 ### Delete all files from the current directory that are normally
425 ### created by building the program. Don't delete the files that
426 ### record the configuration. Also preserve files that could be made
427 ### by building, but normally aren't because the distribution comes
428 ### with them.
429 ###
430 ### Delete `.dvi' files here if they are not part of the distribution.
431 clean: FRC
432 (cd src; $(MAKE) $(MFLAGS) clean)
433 (cd oldXMenu; $(MAKE) $(MFLAGS) clean)
434 (cd lwlib; $(MAKE) $(MFLAGS) clean)
435 (cd lib-src; $(MAKE) $(MFLAGS) clean)
436 -(cd man && $(MAKE) $(MFLAGS) clean)
438 ### `distclean'
439 ### Delete all files from the current directory that are created by
440 ### configuring or building the program. If you have unpacked the
441 ### source and built the program without creating any other files,
442 ### `make distclean' should leave only the files that were in the
443 ### distribution.
444 top_distclean=\
445 rm -f config.status config.cache config.log ; \
446 rm -f Makefile ${SUBDIR_MAKEFILES} ; \
447 (cd lock && (rm * || true))
448 distclean: FRC
449 (cd src; $(MAKE) $(MFLAGS) distclean)
450 (cd oldXMenu; $(MAKE) $(MFLAGS) distclean)
451 (cd lwlib; $(MAKE) $(MFLAGS) distclean)
452 (cd lib-src; $(MAKE) $(MFLAGS) distclean)
453 (cd man && $(MAKE) $(MFLAGS) distclean)
454 ${top_distclean}
456 ### `maintainer-clean'
457 ### Delete everything from the current directory that can be
458 ### reconstructed with this Makefile. This typically includes
459 ### everything deleted by distclean, plus more: C source files
460 ### produced by Bison, tags tables, info files, and so on.
461 ###
462 ### One exception, however: `make maintainer-clean' should not delete
463 ### `configure' even if `configure' can be remade using a rule in the
464 ### Makefile. More generally, `make maintainer-clean' should not delete
465 ### anything that needs to exist in order to run `configure' and then
466 ### begin to build the program.
467 maintainer-clean: FRC
468 (cd src; $(MAKE) $(MFLAGS) maintainer-clean)
469 (cd oldXMenu; $(MAKE) $(MFLAGS) maintainer-clean)
470 (cd lwlib; $(MAKE) $(MFLAGS) maintainer-clean)
471 (cd lib-src; $(MAKE) $(MFLAGS) maintainer-clean)
472 -(cd man && $(MAKE) $(MFLAGS) maintainer-clean)
473 ${top_distclean}
475 ### This doesn't actually appear in the coding standards, but Karl
476 ### says GCC supports it, and that's where the configuration part of
477 ### the coding standards seem to come from. It's like distclean, but
478 ### it deletes backup and autosave files too.
479 extraclean:
480 for i in ${SUBDIR}; do (cd $$i; $(MAKE) $(MFLAGS) extraclean); done
481 ${top_distclean}
482 -rm config-tmp-*
483 -rm -f *~ \#*
485 ### Unlocking and relocking. The idea of these productions is to reduce
486 ### hassles when installing an incremental tar of Emacs. Do `make unlock'
487 ### before unlocking the file to take the write locks off all sources so
488 ### that tar xvof will overwrite them without fuss. Then do `make relock'
489 ### afterward so that VC mode will know which files should be checked in
490 ### if you want to mung them.
492 ### Note: it's no disaster if these productions miss a file or two; tar
493 ### and VC will swiftly let you know if this happens, and it is easily
494 ### corrected.
495 SOURCES = ChangeLog GETTING.GNU.SOFTWARE INSTALL Makefile.in PROBLEMS \
496 README configure make-dist move-if-change
498 .PHONY: unlock relock
500 unlock:
501 chmod u+w $(SOURCES) cpp/*
502 -(cd elisp; chmod u+w Makefile README *.texi)
503 (cd etc; $(MAKE) $(MFLAGS) unlock)
504 (cd lib-src; $(MAKE) $(MFLAGS) unlock)
505 (cd lisp; $(MAKE) $(MFLAGS) unlock)
506 (cd lisp/term; chmod u+w README *.el)
507 (cd man; chmod u+w *texi* ChangeLog split-man)
508 (cd oldXMenu; chmod u+w *.[ch] Makefile README)
509 (cd lwlib; chmod u+w *.[ch] Makefile README)
510 (cd src; $(MAKE) $(MFLAGS) unlock)
512 relock:
513 chmod u-w $(SOURCES) cpp/*
514 -(cd elisp; chmod u-w Makefile README *.texi)
515 (cd etc; $(MAKE) $(MFLAGS) relock)
516 (cd lib-src; $(MAKE) $(MFLAGS) relock)
517 (cd lisp; $(MAKE) $(MFLAGS) relock)
518 (cd lisp/term; chmod u+w README *.el)
519 (cd man; chmod u+w *texi* ChangeLog split-man)
520 (cd oldXMenu; chmod u+w *.[ch] Makefile README)
521 (cd lwlib; chmod u+w *.[ch] Makefile README)
522 (cd src; $(MAKE) $(MFLAGS) relock)
524 TAGS tags: lib-src
525 cd ${srcdir}/src; $(MAKE) tags
527 check:
528 @echo "We don't have any tests for GNU Emacs yet."
530 dist:
531 $(srcdir)/update-subdirs ${srcdir}/lisp
532 cd ${srcdir}; make-dist
534 .PHONY: info dvi dist check
535 force-info:
536 info: force-info
537 (cd ${srcdir}/man; $(MAKE) $(MFLAGS) info)
538 dvi:
539 (cd man; $(MAKE) $(MFLAGS) dvi)