annotate lisp/Makefile @ 28771:383f9592d9dd

(help-xref-on-pp): Check for constant symbols.

#
# Maintenance productions for the Lisp directory
#

# You can specify a different executable on the make command line,
# e.g. "make EMACS=../src/emacs ...".

EMACS = ../src/emacs

# Command line flags for Emacs.  This must include --multibyte,
# otherwise some files will not compile.

EMACSOPT = --no-init-file --no-site-file --multibyte -batch

SOURCES = *.el COPYING Makefile
lisptagsfiles1 = [a-zA-Z]*.el
lisptagsfiles2 = [a-zA-Z]*/[a-zA-Z]*.el
ETAGS = ../lib-src/etags

# Files which should not be compiled.  All file names must be relative
# to the `lisp' directory.
# - emacs-lisp/cl-specs.el:  only contains `def-edebug-spec's so there's
#   no point compiling it, although it doesn't hurt.

DONTCOMPILE = bindings.el mail/blessmail.el play/bruce.el cus-load.el \
	cus-start.el forms-d2.el forms-pass.el \
	international/latin-1.el international/latin-2.el \
	international/latin-3.el international/latin-4.el \
	international/latin-5.el \
	loaddefs.el loadup.el international/mule-conf.el patcomp.el \
	paths.el mail/sc.el subdirs.el version.el \
	generic-x.el international/latin-8.el international/latin-9.el \
	emacs-lisp/cl-specs.el finder-inf.el term/internal.el

# Files to compile before others during a bootstrap.  This is done
# to speed up the bootstrap process.

COMPILE_FIRST = emacs-lisp/bytecomp.el emacs-lisp/byte-opt.el subr.el

# The actual Emacs command run in the targets below.

emacs = $(EMACS) $(EMACSOPT)

# Common command to find subdirectories

setwins=subdirs=`find $$wd -type d -print`; \
	for file in $$subdirs; do \
	   case $$file in */Old | */RCS | */CVS | */CVS/* | */=* ) ;; \
		*) wins="$$wins $$file" ;; \
	   esac; \
        done

doit:

cus-load.el:
	touch $@
custom-deps: cus-load.el doit
	wd=.; $(setwins); \
	echo Directories: $$wins; \
	$(emacs) -l cus-dep -f custom-make-dependencies $$wins

finder-inf.el:
	echo "(provide 'finder-inf)" >> $@
finder-data: finder-inf.el doit
	wd=.; $(setwins); \
	echo Directories: $$wins; \
	$(emacs) -l finder -f finder-compile-keywords-make-dist $$wins

loaddefs.el:
	echo ";;; loaddefs.el --- automatically extracted autoloads" >> $@
	echo ";;" >> $@; echo ";;; Code:" >> $@
	echo "" >> $@
	echo ";;; Local Variables:" >> $@
	echo ";;; version-control: never" >> $@
	echo ";;; no-byte-compile: t" >> $@
	echo ";;; no-update-autoloads: t" >> $@
	echo ";;; End:" >> $@
	echo ";;; loaddefs.el ends here" >> $@
autoloads: loaddefs.el doit
	wd=.; $(setwins); \
	echo Directories: $$wins; \
	$(emacs) --eval '(setq generated-autoload-file "'`pwd`'/loaddefs.el")' -f batch-update-autoloads $$wins

subdirs.el:
	$(MAKE) $(MFLAGS) update-subdirs
update-subdirs: doit
	wd=.; $(setwins); \
	for file in $$wins; do \
	   ../update-subdirs $$file; \
	done;

updates: update-subdirs autoloads finder-data custom-deps

TAGS: $(lisptagsfiles1) $(lisptagsfiles2)
	${ETAGS} $(lisptagsfiles1) $(lisptagsfiles2)

TAGS-LISP: $(lispsource)$(lisptagsfiles1) $(lispsource)$(lisptagsfiles2)
	${ETAGS} -o TAGS-LISP \
	  $(lispsource)$(lisptagsfiles1) $(lispsource)$(lisptagsfiles2)

.el.elc: subdirs.el
	-EMACSLOADPATH=`pwd` $(emacs) -f batch-byte-compile $<

$(DONTCOMPILE:.el=.elc):
	-rm -f $@

# Compile all Lisp files, except those from DONTCOMPILE.  This
# compiles files unconditionally.  All .elc files are made writable
# before compilation in case we checked out read-only (CVS option -r).
# Files MUST be compiled one by one.  If we compile several files in a
# row we can't make sure that the compilation environment is clean.
# We also set the load-path of the Emacs used for compilation to the
# current directory and its subdirectories, to make sure require's and
# load's in the files being compiled find the right files.

compile-files: subdirs.el doit
	find . -name "*.elc" -print | xargs chmod +w;		\
	wd=.; $(setwins);					\
	elpat=`echo $$wins | tr ' 	' '\012\012' | 	\
		sed -e 's|\(.\)$$|\1/|' -e 's|^\./||' -e 's|$$|*.el|'`;	\
	els=`echo $$elpat $(DONTCOMPILE) $(COMPILE_FIRST) | \
		tr '	 ' '\012\012' | sort | uniq -u`; \
	for el in $(COMPILE_FIRST) $$els; do \
	  echo Compiling $$el; \
	  EMACSLOADPATH=`pwd` $(emacs) -f batch-byte-compile $$el ;\
	done

# Backup compiled Lisp files in elc.tar.gz.  If that file already
# exists, make a backup of it.

backup-compiled-files:
	-mv elc.tar.gz elc.tar.gz~
	tar czf elc.tar.gz *.elc */*.elc

# Compile Lisp files, but save old compiled files first.

compile: backup-compiled-files compile-files

# Recompile all Lisp files which are newer than their .elc files.
# Note that this doesn't create .elc files.  It only recompiles if an
# .elc is present.

recompile: doit
	$(emacs) -f batch-byte-recompile-directory .

# Prepare a bootstrap in the lisp subdirectory.  Build loaddefs.el,
# because it's not sure it's up-to-date, and if it's not, that might
# lead to errors during the bootstrap because something fails to
# autoload as expected.  Remove compiled Lisp files so that
# bootstrap-emacs will be built from sources only.

bootstrap-clean:
	if test -f $(emacs); then $(MAKE) $(MFLAGS) autoloads; fi
	-rm -f *.elc */*.elc

# Generate/update files for the bootstrap process.

bootstrap: compile-files autoloads custom-deps

# Makefile ends here.