annotate man/Makefile.in @ 62947:2a5dbdf6d22a

(list-faces-display): Improve the formatting by computing the maximum length required for any face-name (reworked patch of 1999-01-11, accidentally deleted on 1999-07-21). (internal-find-face): Remove redundant info in docstring.

#### Makefile for the Emacs Manual and other documentation.

# Copyright (C) 1994, 1996, 1997, 1998, 1999, 2000, 2001, 2003, 2004
#  Free Software Foundation, Inc.

# This file is part of GNU Emacs.

# GNU Emacs is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2, or (at your option)
# any later version.

# GNU Emacs is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.

# You should have received a copy of the GNU General Public License
# along with GNU Emacs; see the file COPYING.  If not, write to
# the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
# Boston, MA 02111-1307, USA.

# Where to find the source code.  $(srcdir) will be the man
# subdirectory of the source tree.  This is
# set by the configure script's `--srcdir' option.
srcdir=@srcdir@
top_srcdir=@top_srcdir@

# Tell make where to find source files; this is needed for the makefiles.
VPATH=@srcdir@


# The makeinfo program is part of the Texinfo distribution.
# Use --force so that it generates output even if there are errors.
MAKEINFO = makeinfo --force
INFO_TARGETS = ../info/emacs ../info/emacs-xtra ../info/ccmode ../info/cl \
	        ../info/dired-x ../info/ediff ../info/forms ../info/gnus \
		../info/message ../info/sieve ../info/pgg ../info/emacs-mime \
		../info/info ../info/mh-e ../info/reftex \
		../info/sc ../info/vip ../info/viper ../info/widget \
		../info/efaq ../info/ada-mode ../info/autotype ../info/calc \
		../info/idlwave ../info/eudc ../info/ebrowse ../info/pcl-cvs \
		../info/woman ../info/eshell ../info/org ../info/url \
		../info/speedbar ../info/tramp ../info/ses ../info/smtpmail \
		../info/flymake
DVI_TARGETS = 	emacs.dvi calc.dvi cc-mode.dvi cl.dvi dired-x.dvi \
		 ediff.dvi forms.dvi gnus.dvi message.dvi emacs-mime.dvi \
                 gnus.dvi message.dvi sieve.dvi pgg.dvi mh-e.dvi \
		 reftex.dvi sc.dvi vip.dvi viper.dvi widget.dvi faq.dvi \
		 ada-mode.dvi autotype.dvi idlwave.dvi eudc.dvi ebrowse.dvi \
		 pcl-cvs.dvi woman.dvi eshell.dvi org.dvi url.dvi \
		 speedbar.dvi tramp.dvi ses.dvi smtpmail.dvi flymake.dvi \
                 emacs-xtra.dvi
INFOSOURCES = info.texi

# The following rule does not work with all versions of `make'.
.SUFFIXES: .texi .dvi
.texi.dvi:
	texi2dvi $<

TEXI2DVI = texi2dvi
ENVADD = TEXINPUTS="$(srcdir):$(TEXINPUTS)" MAKEINFO="$(MAKEINFO) -I$(srcdir)"

EMACSSOURCES= \
	${srcdir}/emacs.texi \
	${srcdir}/doclicense.texi \
	${srcdir}/screen.texi \
	${srcdir}/commands.texi \
	${srcdir}/entering.texi \
	${srcdir}/basic.texi \
	${srcdir}/mini.texi \
	${srcdir}/m-x.texi \
	${srcdir}/help.texi \
	${srcdir}/mark.texi \
	${srcdir}/killing.texi \
	${srcdir}/regs.texi \
	${srcdir}/display.texi \
	${srcdir}/search.texi \
	${srcdir}/fixit.texi \
	${srcdir}/files.texi \
	${srcdir}/buffers.texi \
	${srcdir}/windows.texi \
	${srcdir}/frames.texi \
	${srcdir}/mule.texi \
	${srcdir}/major.texi \
	${srcdir}/indent.texi \
	${srcdir}/text.texi \
	${srcdir}/programs.texi \
	${srcdir}/building.texi \
	${srcdir}/maintaining.texi \
	${srcdir}/abbrevs.texi \
	${srcdir}/picture.texi \
	${srcdir}/sending.texi \
	${srcdir}/rmail.texi \
	${srcdir}/dired.texi \
	${srcdir}/calendar.texi \
	${srcdir}/misc.texi \
	${srcdir}/custom.texi \
	${srcdir}/trouble.texi \
	${srcdir}/cmdargs.texi \
	${srcdir}/xresources.texi \
	${srcdir}/anti.texi \
	${srcdir}/macos.texi \
	${srcdir}/msdog.texi \
	${srcdir}/gnu.texi \
	${srcdir}/glossary.texi \
	${srcdir}/ack.texi \
	${srcdir}/kmacro.texi

info: $(top_srcdir)/info $(INFO_TARGETS)

$(top_srcdir)/info:
	mkdir $@

dvi: $(DVI_TARGETS)

# Note that all the Info targets build the Info files
# in srcdir.  There is no provision for Info files
# to exist in the build directory.
# In a distribution of Emacs, the Info files should be up to date.

# The following target uses an explicit -o switch to work around
# the @setfilename directive in info.texi, which is required for
# the Texinfo distribution.

../info/info: ${INFOSOURCES}
	cd $(srcdir); $(MAKEINFO) --no-split info.texi -o $@

info.dvi: ${INFOSOURCES}
	$(ENVADD) $(TEXI2DVI) ${srcdir}/info.texi

../info/emacs: ${EMACSSOURCES}
	cd $(srcdir); $(MAKEINFO) emacs.texi

emacs.dvi: ${EMACSSOURCES}
	$(ENVADD) $(TEXI2DVI) ${srcdir}/emacs.texi

# This target is here so you could easily get the list of the *.texi
# files which belong to the Emacs manual (as opposed to the separate
# manuals for CL, CC Mode, Ebrowse, etc.).  With this target, you can
# say things like "grep foo `make emacsman`".
emacsman:
	@echo $(EMACSSOURCES)

../info/ccmode: cc-mode.texi
	cd $(srcdir); $(MAKEINFO) cc-mode.texi
cc-mode.dvi: cc-mode.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/cc-mode.texi

../info/ada-mode: ada-mode.texi
	cd $(srcdir); $(MAKEINFO) ada-mode.texi
ada-mode.dvi: ada-mode.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/ada-mode.texi

../info/pcl-cvs: pcl-cvs.texi
	cd $(srcdir); $(MAKEINFO) pcl-cvs.texi
pcl-cvs.dvi: pcl-cvs.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/pcl-cvs.texi

../info/eshell: eshell.texi
	cd $(srcdir); $(MAKEINFO) eshell.texi
eshell.dvi: eshell.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/eshell.texi

../info/cl: cl.texi
	cd $(srcdir); $(MAKEINFO) cl.texi
cl.dvi: cl.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/cl.texi

../info/dired-x: dired-x.texi
	cd $(srcdir); $(MAKEINFO) dired-x.texi
dired-x.dvi: dired-x.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/dired-x.texi

../info/ediff: ediff.texi
	cd $(srcdir); $(MAKEINFO) ediff.texi
ediff.dvi: ediff.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/ediff.texi

../info/emacs-xtra: emacs-xtra.texi
	cd $(srcdir); $(MAKEINFO) emacs-xtra.texi
emacs-xtra.dvi: emacs-xtra.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-xtra.texi

../info/forms: forms.texi
	cd $(srcdir); $(MAKEINFO) forms.texi
forms.dvi: forms.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/forms.texi

# gnus/message/emacs-mime/sieve/pgg are part of Gnus:
../info/gnus: gnus.texi gnus-faq.texi
	cd $(srcdir); $(MAKEINFO) gnus.texi
gnus.dvi: gnus.texi gnus-faq.texi
	sed -e '/@iflatex/,/@end iflatex/d' ${srcdir}/gnus.texi > gnustmp.texi
	$(ENVADD) $(TEXI2DVI) gnustmp.texi
	cp gnustmp.dvi $*.dvi
	rm gnustmp.*

../info/message: message.texi
	cd $(srcdir); $(MAKEINFO) message.texi
message.dvi: message.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/message.texi

../info/sieve: sieve.texi
	cd $(srcdir); $(MAKEINFO) sieve.texi
sieve.dvi: sieve.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/sieve.texi

../info/emacs-mime: emacs-mime.texi
	cd $(srcdir); $(MAKEINFO) emacs-mime.texi
emacs-mime.dvi: emacs-mime.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi

../info/pgg: pgg.texi
	cd $(srcdir); $(MAKEINFO) pgg.texi
pgg.dvi: pgg.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/pgg.texi

../info/mh-e: mh-e.texi
	cd $(srcdir); $(MAKEINFO) mh-e.texi
mh-e.dvi: mh-e.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/mh-e.texi

../info/reftex: reftex.texi
	cd $(srcdir); $(MAKEINFO) reftex.texi
reftex.dvi: reftex.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/reftex.texi

../info/sc: sc.texi
	cd $(srcdir); $(MAKEINFO) sc.texi
sc.dvi: sc.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/sc.texi

../info/vip: vip.texi
	cd $(srcdir); $(MAKEINFO) vip.texi
vip.dvi: vip.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/vip.texi

../info/viper: viper.texi
	cd $(srcdir); $(MAKEINFO) viper.texi
viper.dvi: viper.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/viper.texi

../info/widget: widget.texi
	cd $(srcdir); $(MAKEINFO) widget.texi
widget.dvi: widget.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/widget.texi

../info/efaq: faq.texi
	cd $(srcdir); $(MAKEINFO) faq.texi
faq.dvi: faq.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/faq.texi

../etc/GNU: gnu1.texi gnu.texi
	cd $(srcdir) && makeinfo --no-headers -o ../etc/GNU gnu1.texi

../info/autotype: autotype.texi
	cd $(srcdir); $(MAKEINFO) autotype.texi
autotype.dvi: autotype.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/autotype.texi

../info/calc: calc.texi
	cd $(srcdir); $(MAKEINFO) calc.texi

calc.dvi: calc.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/calc.texi

# This is produced with --no-split to avoid making files whose
# names clash on DOS 8+3 filesystems
../info/idlwave: idlwave.texi
	cd $(srcdir); $(MAKEINFO) --no-split idlwave.texi
idlwave.dvi: idlwave.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/idlwave.texi

../info/eudc: eudc.texi
	cd $(srcdir); $(MAKEINFO) eudc.texi
eudc.dvi: eudc.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/eudc.texi

../info/ebrowse: ebrowse.texi
	cd $(srcdir); $(MAKEINFO) ebrowse.texi
ebrowse.dvi: ebrowse.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/ebrowse.texi

../info/woman: woman.texi
	cd $(srcdir); $(MAKEINFO) woman.texi
woman.dvi: woman.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/woman.texi

../info/org: org.texi
	cd $(srcdir); $(MAKEINFO) org.texi
org.dvi: org.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/org.texi

../info/url: url.texi
	cd $(srcdir); $(MAKEINFO) url.texi
url.dvi: url.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/url.texi

../info/speedbar: speedbar.texi
	cd $(srcdir); $(MAKEINFO) speedbar.texi
speedbar.dvi: speedbar.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/speedbar.texi

../info/tramp: tramp.texi trampver.texi
	cd $(srcdir); $(MAKEINFO) -D emacs tramp.texi
tramp.dvi: tramp.texi trampver.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi

../info/ses: ses.texi
	cd $(srcdir); $(MAKEINFO) ses.texi
ses.dvi: ses.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/ses.texi

../info/smtpmail: smtpmail.texi
	cd $(srcdir); $(MAKEINFO) smtpmail.texi
smtpmail.dvi: smtpmail.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/smtpmail.texi

../info/flymake: flymake.texi
	cd $(srcdir); $(MAKEINFO) flymake.texi
flymake.dvi: flymake.texi
	$(ENVADD) $(TEXI2DVI) ${srcdir}/flymake.texi

mostlyclean:
	rm -f *.log *.cp *.fn *.ky *.pg *.vr core *.tp *.core gnustmp.*

clean: mostlyclean
	rm -f *.dvi

distclean: clean

maintainer-clean: distclean
	rm -f *.aux *.cps *.fns *.kys *.pgs *.vrs *.toc
	for file in $(INFO_TARGETS); do rm -f $${file}*; done


# Formerly this directory had texindex.c and getopt.c in it
# and this makefile built them to make texindex.
# That caused trouble because this is run entirely in the source directory.
# Since we expect to get texi2dvi from elsewhere,
# it is ok to expect texindex from elsewhere also.