annotate Makefile.in @ 1686:10650dfc82d0

* Makefile.in (install, install.sysv, install.xenix, install.aix): Install the info files in ${infodir}. Install the executable under both `emacs' and `emacs-VERSION'. * Makefile.in: Doc fix. * Makefile.in (exec_prefix): New variable, as per latest version of coding standards. (bindir, libdir): Use it, instead of `prefix'. (lib-src/Makefile): Edit value of exec_prefix into lib-src/Makefile. * Makefile.in (mandir): Make the default value for this depend on $(prefix). * Makefile.in (datadir, statedir, libdir): Make these all default to ${prefix}/lib. (lispdir, locallisppath, etcdir, lockdir, archlibdir): Adjusted to compensate. * Makefile.in (install, install.sysv, install.xenix, install.aix): Install the etags and ctags man pages too. * Makefile.in (distclean): Don't delete backup files; that's the job of extraclean. (extraclean): Like distclean, but deletes backup and autosave files. Make path specification conform to GNU coding standards. * configure (long_usage): Remove all traces of old arguments from usage messages, and document the options we do accept in more detail: -with-x... and --srcdir. (options, boolean_opts): Deleted; we don't have enough options to make this worthwhile. (prefix, bindir, lisppath, datadir, libdir, lockdir): Deleted, along with the code which supported them; these should be set as arguments to the top-level make. (config_h_opts): Since this no longer doubles as a list of option names, make them upper case; this simplifies the code which uses them to build the sed command to edit src/config.h. Change the code which sets them. (cc, g, O): Don't allow the user to set these using options; they should be specified using `CC=' and `CFLAGS=' arguments to the top-level make. Just choose reasonable default values for them, and edit them into Makefile.in's default CC and CONFIG_CFLAGS values. (gnu_malloc, rel_alloc): Don't allow the user to set these using options; use them whenever the configuration files say they're possible. Simplify the argument processing loop. Don't accept abbreviations for option names; these might conflict with other configuration options in the future. Add some support for the `--srcdir' option. Check for the sources in . and .. if `--srcdir' is omitted. If the directories we will compile in don't exist yet, create them under the current directory. Note that the rest of the build process doesn't really support this. Edit only the top Makefile. That should edit the others. Edit into the makefile: `version', from lisp/version.el, `configname' and `srcdir' from the configuration arguments, `CC' and `CONFIG_CFLAGS' as guessed from the presence or absence of GCC in the user's path, and LOADLIBES as gleaned from the system description files. Simplify the report generated; it doesn't need to include any description of paths now. Make `config.status' exec configure instead of just calling it, so there's no harm in overwriting `config.status'. * Makefile.in (version, configname): New variables, used to choose the default values for datadir and libdir. Path variables rearranged into two clearer groups: - In the first group are the variables specified by the GNU coding standards (prefix, bindir, datadir, statedir, libdir, mandir, manext, infodir, and srcdir). - In the second are the variables actually used for Emacs's paths (lispdir, locallisppath, lisppath, buildlisppath, etcdir, lockdir, archlibdir), which depend on the first category. datadir and libdir default to directories under ${prefix}/lib/emacs instead of ${prefix}/emacs, by popular demand. etcdir and lispdir default to subdirectories of datadir. archlibdir defaults to libdir. The new installation tree is a bit deeper than it used to be, so use the new make-path program in lib-src to build them all. Always build a new src/paths.h.tmp and then move-if-change it to src/paths.h, to avoid unnecessary rebuilds while responding to the right changes. Remove all mention of arch-lib. Run utility commands from lib-src, and let the executables be copied into archlibdir when Emacs is installed. Add targets for src/Makefile, lib-src/Makefile, and oldXMenu/Makefile, editing the values of the path variables into them. Let lib-src do its own installation. (datadir): Default to putting data files under ${prefix}/lib/emacs/${version}, not /usr/local/emacs. (emacsdir): Variable deleted; it would only be confusing to use. (lispdir, etcdir): Default to ${datadir}/lisp. (mkdir): Use make-path for this. (lockdir): Do this in mkdir. (Makefile): New target.

# DIST: This is the distribution Makefile for Emacs.  configure can
# DIST: make most of the changes to this file you might want, so try
# DIST: that first.

# make all	to compile and build Emacs.
# make install	to install it.
# make install.sysv to install on system V.  Note that on system V you
#		must change mandir to /usr/local/man/man1.
# make install.xenix  to install on Xenix.
# make install.aix    to install on AIX.
# make TAGS	to update tags tables.
#
# make clean  or  make mostlyclean
#      Delete all files from the current directory that are normally
#      created by building the program.  Don't delete the files that
#      record the configuration.  Also preserve files that could be made
#      by building, but normally aren't because the distribution comes
#      with them.
#
#      Delete `.dvi' files here if they are not part of the distribution.
# 
# make distclean
#      Delete all files from the current directory that are created by
#      configuring or building the program.  If you have unpacked the
#      source and built the program without creating any other files,
#      `make distclean' should leave only the files that were in the
#      distribution.
# 
# make realclean
#      Delete everything from the current directory that can be
#      reconstructed with this Makefile.  This typically includes
#      everything deleted by distclean, plus more: C source files
#      produced by Bison, tags tables, info files, and so on.
#
# make extraclean
#      Still more severe - delete backup and autosave files, too.

SHELL = /bin/sh

# ==================== Things `configure' Might Edit ====================

CC=cc
CONFIG_CFLAGS=-g

### These help us choose version- and architecture-specific directories
### to install files in.

### This should be the number of the Emacs version we're building,
### like `18.59' or `19.0'.
version=version-not-set

### This should be the name of the configuration we're building Emacs
### for, like `mips-dec-ultrix' or `sparc-sun-sunos'.
configname=configuration-name-not-set

# ==================== Where To Install Things ====================

# The default location for installation.  Everything is placed in
# subdirectories of this directory.  The default values for many of
# the variables below are expressed in terms of this one, so you may
# not need to change them.
prefix=/usr/local

# Like `prefix', but used for architecture-specific files.
exec_prefix=${prefix}

# Where to install Emacs and other binaries that people will want to
# run directly (like etags).
bindir=${exec_prefix}/bin

# Where to install architecture-independent data files.  ${lispdir}
# and ${etcdir} are subdirectories of this.
datadir=${prefix}/lib

# Where to install and expect the files that Emacs modifies as it
# runs.  These files are all architecture-independent. Right now, the
# only such data is the locking directory; ${lockdir} is a
# subdirectory of this.
statedir=${prefix}/lib

# Where to install and expect executable files to be run by Emacs
# rather than directly by users, and other architecture-dependent
# data.  ${archlibdir} is a subdirectory of this.
libdir=${exec_prefix}/lib

# Where to install Emacs's man pages, and what extension they should have.
mandir=${prefix}/man/man1
manext=.1

# Where to install and expect the info files describing Emacs.	In the
# past, this defaulted to a subdirectory of ${prefix}/lib/emacs, but
# since there are now many packages documented with the texinfo
# system, it is inappropriate to imply that it is part of Emacs.
infodir=${prefix}/info

# Where to find the source code - setting this to anything but
# . doesn't work yet.  The source code for Emacs's C kernel is
# expected to be in ${srcdir}/src, and the source code for Emacs's
# utility programs is expected to be in ${srcdir}/lib-src.  This is
# set by the configure script's `--srcdir' option.
srcdir=.

# ==================== Emacs-specific directories ====================

# These variables hold the values Emacs will actually use.  They are
# based on the values of the standard Make variables above.

# Where to install the elisp files distributed with Emacs.  This
# includes the Emacs version, so that the lisp files for different
# versions of Emacs will install themselves in separate directories.
lispdir=${datadir}/emacs/${version}/lisp

# Directories Emacs should search for elisp files specific to this
# site (i.e. customizations), before consulting ${lispdir}.  This
# should be a colon-separated list of directories.
locallisppath=${datadir}/emacs/local-lisp

# Where Emacs will search to find its elisp files.  Before changing
# this, check to see if your purpose wouldn't better be served by
# changing locallisppath.  This should be a colon-separated list of
# directories.
lisppath=${locallisppath}:${lispdir}

# Where Emacs will search for its elisp files while building.  This is
# only used during the process of compiling Emacs, to help Emacs find
# its lisp files before they've been installed in their final
# location.  It's usually identical to lisppath, except that the entry
# for the directory containing the installed lisp files has been
# replaced with ../lisp.  This should be a colon-separated list of
# directories.
buildlisppath=../lisp

# Where to install the other architecture-independent data files
# distributed with Emacs (like the tutorial, the cookie recipes and
# the Zippy database).  This path usually contains the Emacs version
# number, so the data files for multiple versions of Emacs may be
# installed at once.
etcdir=${datadir}/emacs/${version}/etc

# Where to create and expect the locking directory, where the Emacs
# locking code keeps track of which files are currently being edited.
lockdir=${statedir}/emacs/lock

# Where to put executables to be run by Emacs rather than the user.
# This path usually includes the Emacs version and configuration name,
# so that multiple configurations for multiple versions of Emacs may
# be installed at once.
archlibdir=${libdir}/emacs/${version}/${configname}

# ==================== Utility Programs for the Build ====================

# Allow the user to specify the install program.
INSTALL = install
INSTALLFLAGS = -c
INSTALL_PROGRAM = ${INSTALL}
INSTALL_DATA = ${INSTALL}

# ============================= Targets ==============================

# Flags passed down to subdirectory makefiles.
MFLAGS = 

CFLAGS=${CONFIG_CFLAGS}

# Subdirectories to make recursively.  `lisp' is not included
# because the compiled lisp files are part of the distribution
# and you cannot remake them without installing Emacs first.
SUBDIR = lib-src src

# The makefiles of the directories in $SUBDIR.
SUBDIR_MAKEFILES = lib-src/Makefile src/Makefile

# Subdirectories to install, and where they'll go.  lib-src's makefile
# knows how to install it, so we don't do that here.
COPYDIR = etc ${srcdir}/info ${srcdir}/lisp
COPYDESTS = ${etcdir} ${infodir} ${lispdir}

all:	src/paths.h ${SUBDIR}

removenullpaths=sed -e 's/^://' -e 's/:$$//' -e 's/::/:/'

# We force the rebuilding of src/paths.h because the user might give
# make different values for the various directories.  Since we use
# move-if-change, src/paths.h only actually changes if the user did
# something notable, so the only unnecessary work we do is in building
# src/paths.h.tmp, which isn't much.
# Note that sed is not in /bin on 386bsd.
src/paths.h: Makefile ${srcdir}/src/paths.h.in FRC
	lisppath=`echo ${lisppath} | ${removenullpaths}` ;		\
	buildlisppath=`echo ${buildlisppath} | ${removenullpaths}` ;	\
	sed < ${srcdir}/src/paths.h.in > src/paths.h.tmp		\
	-e 's;\(#.*PATH_LOADSEARCH\).*$$;\1 "'$${lisppath}'";'		\
	-e 's;\(#.*PATH_DUMPLOADSEARCH\).*$$;\1 "'$${buildlisppath}'";'	\
	-e 's;\(#.*PATH_EXEC\).*$$;\1 "${archlibdir}";'			\
	-e 's;\(#.*PATH_DATA\).*$$;\1 "${etcdir}";'			\
	-e 's;\(#.*PATH_LOCK\).*$$;\1 "${lockdir}/";'
	${srcdir}/move-if-change src/paths.h.tmp src/paths.h

src:	lib-src

.RECURSIVE: ${SUBDIR}

${SUBDIR}: ${SUBDIR_MAKEFILES} FRC
	cd $@; make all ${MFLAGS} \
		CC='${CC}' CFLAGS='${CFLAGS}' \
		srcdir='${srcdir}/$@' libdir='${libdir}'

## We build the makefiles for the subdirectories here so that we can
## edit the values for the path variables into them.  This means that
## when the user has built them from this makefile once, they will use
## the right default values for the path variables.
lib-src/Makefile: ${srcdir}/lib-src/Makefile.in Makefile
	echo "Producing \`lib-src/Makefile' from \`${srcdir}/lib-src/Makefile.in'."
	rm -f lib-src/Makefile.tmp
	(echo "# This file is generated from \`${srcdir}/lib-src/Makefile.in'." ; \
	 echo "# If you are thinking about editing it, you should seriously consider" ; \
	 echo "# running \`make lib-src/Makefile' at the top of the" ;	\
	 echo "# Emacs build tree instead, or editing" ;		\
	 echo "# \`${srcdir}/lib-src/Makefile.in' itself." ; 		\
	 /bin/sed < ${srcdir}/lib-src/Makefile.in			\
	 -e 's|^\(version *=\).*$$|\1'"${version}"'|' 			\
	 -e 's|^\(configname *=\).*$$|\1'"${configname}"'|' 		\
	 -e 's|^\(prefix *=\).*$$|\1'"${prefix}"'|'	 		\
	 -e 's|^\(exec_prefix *=\).*$$|\1'"${exec_prefix}"'|'		\
	 -e 's|^\(libdir *=\).*$$|\1'"${libdir}"'|' 			\
	 -e 's|^\(srcdir *=\).*$$|\1'"${srcdir}"'|' 			\
	 -e 's|^\(archlibdir *=\).*$$|\1'"${archlibdir}"'|' 		\
	 -e 's|^CC *=.*$$|CC='"${CC}"'|'				\
	 -e 's|^CONFIG_CFLAGS *=.*$$|CONFIG_CFLAGS='"${CONFIG_CFLAGS}"'|' \
	 -e 's|^LOADLIBES *=.*$$|LOADLIBES='"${libsrc_libs}"'|'		\
	 -e '/^# DIST: /d') > lib-src/Makefile.tmp
	${srcdir}/move-if-change lib-src/Makefile.tmp lib-src/Makefile
	# Remind people not to edit this.
	chmod -w lib-src/Makefile

src/Makefile: ${srcdir}/src/Makefile.in Makefile
	echo "Producing \`src/Makefile' from \`${srcdir}/src/Makefile.in'."
	rm -f src/Makefile.tmp
	(echo "# This file is generated from \`${srcdir}/src/Makefile.in'." ; \
	 echo "# If you are thinking about editing it, you should seriously consider" ; \
	 echo "# running \`make src/Makefile' at the top of the" ;	\
	 echo "# Emacs build tree instead, or editing" ;		\
	 echo "# \`${srcdir}/src/Makefile.in' itself." ; 		\
	 /bin/sed < ${srcdir}/src/Makefile.in				\
	 -e 's|^\(srcdir *=\).*$$|\1'"${srcdir}"'|' 			\
	 -e 's|^CC *=.*$$|CC='"${CC}"'|'				\
	 -e 's|^CONFIG_CFLAGS *=.*$$|CONFIG_CFLAGS='"${CONFIG_CFLAGS}"'|' \
	 -e '/^# DIST: /d') > src/Makefile.tmp
	${srcdir}/move-if-change src/Makefile.tmp src/Makefile
	# Remind people not to edit this.
	chmod -w src/Makefile

oldXMenu/Makefile: ${srcdir}/oldXMenu/Makefile Makefile
	echo "Producing \`src/Makefile' from \`${srcdir}/src/Makefile.in'."
	rm -f src/Makefile.tmp
	cp "${srcdir}"/oldXMenu/Makefile oldXMenu/Makefile


Makefile:
	./config.status

# ==================== Installation ====================

install: all mkdir
	## If we let lib-src do its own installation, that means we
	## don't have to duplicate the list of utilities to install in
	## this Makefile as well.
	(cd lib-src; make install ${MFLAGS} bindir=${bindir} libdir=${libdir})
	-set ${COPYDESTS} ; \
	 for dir in ${COPYDIR} ; do \
	   dest=$$1 ; shift ; \
	   if [ `(cd $${dir}; /bin/pwd)` != `(cd $${dest}; /bin/pwd)` ]; then \
	     (cd $${dir}; tar cf - . ) | (cd $${dest}; umask 0; tar xf - ) ; \
	     for subdir in `find $${dest} -type d ! -name RCS -print` ; do \
	       rm -rf $${subdir}/RCS ; \
	       rm -f  $${subdir}/\#* ; \
	       rm -f  $${subdir}/*~ ; \
	     done ; \
	   fi ; \
	 done
	(cd info ; \
	 if [ ! -f ${infodir}/dir ]; then \
	   ${INSTALL_DATA} ${INSTALLFLAGS} -m 444 ./dir ${infodir}/dir ; \
         fi ; \
	 for f in *.info* ; do \
	   ${INSTALL_DATA} ${INSTALLFLAGS} -m 444 $$f ${infodir}/$$f ; \
         done)
	for page in emacs etags ctags ; do \
	  ${INSTALL_DATA} ${INSTALLFLAGS} -m 444 etc/$${page}.1 \
	    ${mandir}/$${page}${manext} ; \
        done
	${INSTALL_PROGRAM} ${INSTALLFLAGS} -m 1755 src/xemacs \
	  ${bindir}/emacs-${version}
	-rm -f ${bindir}/emacs
	ln ${bindir}/emacs-${version} ${bindir}/emacs

install.sysv: all mkdir
	## If we let lib-src do its own installation, that means we
	## don't have to duplicate the list of utilities to install in
	## this Makefile as well.
	(cd lib-src; make install ${MFLAGS} bindir=${bindir} libdir=${libdir})
	-set ${COPYDESTS} ; \
	 for dir in ${COPYDIR} ; do \
	   dest=$$1 ; shift ; \
	   if [ `/bin/pwd`/$${dir} != `(cd $${dest}; /bin/pwd)` ] ; then \
	     (cd $${dir}; find . -print | cpio -pdum ${dest} ) ; \
	     for subdir in `find $${dest} -type d ! -name RCS -print` ; do \
	       rm -rf $${subdir}/RCS ; \
	       rm -f  $${subdir}/\#* ; \
	       rm -f  $${subdir}/*~ ; \
	     done ; \
	   fi ; \
	 done
	-(cd info ; \
	 if [ ! -f ${infodir}/dir ]; then \
	   cpset ./dir ${infodir} 444 bin bin ; \
         fi ; \
	 for f in *.info* ; do \
	    cpset $$f ${infodir} 444 bin bin ; \
         done)
	-for page in emacs etags ctags ; do \
	  cpset etc/$${page}.1 ${mandir}/$${page}${manext} 444 bin bin ; \
        done
	-/bin/rm -f ${bindir}/emacs
	-cpset src/xemacs ${bindir}/emacs-${version} 1755 bin bin
	-ln ${bindir}/emacs-${version} ${bindir}/emacs
  
install.xenix: all mkdir
	## If we let lib-src do its own installation, that means we
	## don't have to duplicate the list of utilities to install in
	## this Makefile as well.
	(cd lib-src; make install ${MFLAGS} bindir=${bindir} libdir=${libdir})
	-set ${COPYDESTS} ; \
	 for dir in ${COPYDIR} ; do \
	   dest=$$1 ; shift ; \
	   if [ `/bin/pwd`/$${dir} != `(cd $${dest}; /bin/pwd)` ] ; then \
	     (cd $${dir}; tar cf - . ) | (cd $${dest}; umask 0; tar xpf - ) ; \
	     for subdir in `find $${dest} -type d ! -name RCS -print` ; do \
	       rm -rf $${subdir}/RCS ; \
	       rm -f  $${subdir}/\#* ; \
	       rm -f  $${subdir}/*~ ; \
	     done ; \
	   fi ; \
	 done
	(cd info ; \
	 if [ ! -f ${infodir}/dir ]; then \
	   cp ./dir ${infodir} ; \
	   chmod 444 ${infodir}/dir ; \
         fi ; \
	 for f in *.info* ; do \
	    cp $$f ${infodir} ; \
	    chmod 444 ${infodir}/$$f ; \
         done)
	for page in emacs etags ctags ; do \
	  cp etc/$${page}.1 ${mandir}/$${page}${manext} ; \
	  chmod 444 ${mandir}/$${page}${manext} ; \
        done
	-mv -f ${bindir}/emacs ${bindir}/emacs.old
	cp src/xemacs ${bindir}/emacs-${version}
	ln ${bindir}/emacs-${version} ${bindir}/emacs
	chmod 1755 ${bindir}/emacs
	-rm -f ${bindir}/emacs.old

install.aix: all mkdir
	## If we let lib-src do its own installation, that means we
	## don't have to duplicate the list of utilities to install in
	## this Makefile as well.
	(cd lib-src; make install ${MFLAGS} bindir=${bindir} libdir=${libdir})
	-set ${COPYDESTS} ; \
	 for dir in ${COPYDIR} ; do \
	   dest=$$1 ; shift ; \
	   if [ `/bin/pwd`/$${dir} != `(cd $${dest}; /bin/pwd)` ] ; then \
	     (cd $${dir}; tar cf - . ) | (cd $${dest}; umask 0; tar xBf - ) ; \
	     for subdir in `find $${dest} -type d ! -name RCS -print` ; do \
	       rm -rf $${subdir}/RCS ; \
	       rm -f  $${subdir}/\#* ; \
	       rm -f  $${subdir}/*~ ; \
	     done ; \
	   fi ; \
	 done
	(cd info ; \
	 if [ ! -f ${infodir}/dir ]; then \
	   ${INSTALL_DATA} ${INSTALLFLAGS} -M 444 -f ${infodir} ./dir ; \
         fi ; \
	 for f in *.info* ; do \
	    ${INSTALL_DATA} ${INSTALLFLAGS} -M 444 -f ${infodir} $$f ; \
         done)
	${INSTALL_PROGRAM} ${INSTALLFLAGS} -M 1755 -f ${bindir} src/xemacs
	mv ${bindir}/xemacs ${bindir}/emacs-${version}
	for page in emacs etags ctags ; do \
	  ${INSTALL_DATA} ${INSTALLFLAGS} -M 444 -f ${mandir} etc/$${page}.1 ;\
        done
	-rm -f ${bindir}/emacs
	ln ${bindir}/emacs-${version} ${bindir}/emacs

### Build all the directories we're going to install Emacs in.  Since
### we may be creating several layers of directories (for example,
### /usr/local/lib/emacs/19.0/mips-dec-ultrix4.2), we use make-path
### instead of mkdir.  Not all systems' mkdirs have the `-p' flag.
mkdir: FRC
	./lib-src/make-path ${COPYDESTS} ${lockdir}
	chmod 777 ${COPYDESTS} ${lockdir}

FRC:


# ==================== Cleaning up and miscellanea ====================

### `clean'
###      Delete all files from the current directory that are normally
###      created by building the program.  Don't delete the files that
###      record the configuration.  Also preserve files that could be made
###      by building, but normally aren't because the distribution comes
###      with them.
### `mostlyclean'
###      Like `clean', but may refrain from deleting a few files that
###      people normally don't want to recompile.  For example, the
###      `mostlyclean' target for GCC does not delete `libgcc.a', because
###      recompiling it is rarely necessary and takes a lot of time.
### 
clean mostlyclean:
	cd src; make clean
	cd lib-src; make clean
	cd oldXMenu; make clean
	if [ `(cd ${etcdir} ; /bin/pwd` != `(cd etc; /bin/pwd)` ] ; then \
	  cd etc; make clean; \
	else true; \
	fi

### `distclean'
###      Delete all files from the current directory that are created by
###      configuring or building the program.  This should leave only the
###      files that would be in the distribution.
distclean:
	for i in ${SUBDIR}; do (cd $$i; make ${MFLAGS} distclean); done
	-(cd lock; rm *)
	-rm config.status config-tmp-*

### `realclean'
###      Delete everything from the current directory that can be
###      reconstructed with this makefile.  This typically includes
###      everything deleted by distclean, plus more: C source files
###      produced by Bison, tags tables, info files, and so on.
realclean:
	for i in ${SUBDIR}; do (cd $$i; make ${MFLAGS} realclean); done
	(cd lock; rm *)
	rm config.status

### This doesn't actually appear in the coding standards, but Karl
### says GCC supports it, and that's where the configuration part of
### the coding standards seem to come from.  It's like distclean, but
### it deletes backup and autosave files too.
extraclean:
	for i in ${SUBDIR}; do (cd $$i; make ${MFLAGS} extraclean); done
	-(cd lock; rm *)
	-rm config.status config-tmp-*
	-rm -f *~ \#*


TAGS tags:	lib-src
	(cd ${srcdir} ; lib-src/etags --output=./src/TAGS \
	 src/*.[ch] lisp/*.el lisp/term/*.el)

check:
	@echo "We don't have any tests for GNU Emacs yet."

dist:
	cd ${srcdir}; make-dist