[bpt/emacs.git] / doc / lispref / two-volume.make

# Copyright (C) 2007-2012  Free Software Foundation, Inc.
# See end for copying conditions.

# although it would be nice to use tex rather than pdftex to avoid
# colors, spurious warnings about names being referenced but not
# existing, etc., dvips | ps2pdf doesn't preserve the page size.
# Instead of creating a special dvips config file, put up with the warnings.
texinfodir=../misc

tex = TEXINPUTS=".:$(texinfodir):${TEXINPUTS}" pdftex -interaction=nonstopmode

all: vol1.pdf vol2.pdf

# vol1.texi and vol2.texi specially define \tocreadfilename so we can
# use our premade .toc's.
# 
vol1.pdf: elisp1med-fns-ready elisp1med-aux-ready elisp1med-toc-ready
	@echo -e "\f Final TeX run for volume 1..."
	cp elisp1med-toc-ready elisp1-toc-ready.toc
	cp elisp1med-fns-ready vol1.fns
	cp elisp1med-aux-ready vol1.aux
	$(tex) vol1.texi
#
vol2.pdf: elisp2med-fns-ready elisp2med-aux-ready elisp2med-toc-ready
	@echo "Final TeX run for volume 2..."
	cp elisp2med-toc-ready elisp2-toc-ready.toc
	cp elisp2med-fns-ready vol2.fns
	cp elisp2med-aux-ready vol2.aux
	$(tex) vol2.texi

# \f intermediate toc files.
# 
# vol1 toc: volume 1, page break, volume 2 (with II: prepended).
elisp1med-toc-ready: elisp1med-init elisp2med-init
	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	cat elisp1med-toc >>$@
	echo '@page' >>$@
	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	sed 's/{\([^}]*\)}$$/{II:\1}/' elisp2med-toc >>$@	
#
# vol2 toc: volume 1 (with I: prepended), page break, volume 2.
elisp2med-toc-ready: elisp1med-init elisp2med-init
	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	sed 's/{\([^}]*\)}$$/{I:\1}/' elisp1med-toc >>$@	
	echo '@page' >>$@
	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	cat elisp2med-toc >>$@


# \f intermediate aux files.
# 
# append vol2's fixed aux to normal vol1.  
elisp1med-aux-ready: elisp2med-aux-vol-added
	cat elisp1med-aux $< >$@
#
# prepend vol1's fixed aux to vol2.
elisp2med-aux-ready: elisp1med-aux-vol-added
	cat $< elisp2med-aux >$@

# on -pg entries, append volume number after page number.
elisp1med-aux-vol-added: elisp1med-init
	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie1}/' elisp1med-aux >$@
#
elisp2med-aux-vol-added: elisp2med-init
	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie2}/' elisp2med-aux >$@

# \f intermediate index (fns) file.
# 
elisp1med-fns-ready: elisp1med-fn-vol-added elisp2med-fn-vol-added
	cat elisp2med-fn-vol-added >>vol1.fn
	texindex vol1.fn
	cp vol1.fns $@
#
elisp2med-fns-ready: elisp1med-fn-vol-added elisp2med-fn-vol-added
	cat elisp1med-fn-vol-added >>vol2.fn
	texindex vol2.fn
	cp vol2.fns $@

# Insert volume number (I: or II:) into index file.
elisp1med-fn-vol-added: elisp1med-init
	cp vol1.fn elisp1med-fn
	sed 's/}{/}{I:/' elisp1med-fn >$@
#
elisp2med-fn-vol-added: elisp2med-init
	cp vol2.fn elisp2med-fn
	sed 's/}{/}{II:/' elisp2med-fn >$@

# -----------------------------------------------------------------------------
# everything above is essentially a duplicate of everything below. sorry.
# -----------------------------------------------------------------------------

# \f intermediate TeX runs.
# 
# this generates what would be the final versions -- except the page
# numbers aren't right.  The process of adding the I: and II: changes
# the page breaks, so a few index entries, at least are wrong.  (In
# 2007, x-meta-keysym in vol.II ended up on page 374 when the index had
# it on page 375 from the initial run.)
# 
# So, we start all over again, from these fns/aux/toc files.
# 
elisp1med-init: elisp1-fns-ready elisp1-aux-ready elisp1init-toc-ready $(texinfodir)/texinfo.tex
	@echo -e "\f Intermediate TeX run for volume 1..."
	cp elisp1init-toc-ready elisp1-toc-ready.toc
	cp elisp1-fns-ready vol1.fns
	cp elisp1-aux-ready vol1.aux
	$(tex) vol1.texi
	texindex vol1.??
	mv vol1.aux elisp1med-aux
	mv vol1.toc elisp1med-toc
#
elisp2med-init: elisp2-fns-ready elisp2-aux-ready elisp2init-toc-ready $(texinfodir)/texinfo.tex
	@echo "Final TeX run for volume 2..."
	cp elisp2init-toc-ready elisp2-toc-ready.toc
	cp elisp2-fns-ready vol2.fns
	cp elisp2-aux-ready vol2.aux
	$(tex) vol2.texi
	texindex vol2.??
	mv vol2.aux elisp2med-aux
	mv vol2.toc elisp2med-toc


# \f initial toc files.
# 
# vol1 toc: volume 1, page break, volume 2 (with II: prepended).
elisp1init-toc-ready: elisp1-init elisp2-init
	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	cat elisp1-toc >>$@
	echo '@page' >>$@
	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	sed 's/{\([^}]*\)}$$/{II:\1}/' elisp2-toc >>$@	
#
# vol2 toc: volume 1 (with I: prepended), page break, volume 2.
elisp2init-toc-ready: elisp1-init elisp2-init
	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	sed 's/{\([^}]*\)}$$/{I:\1}/' elisp1-toc >>$@	
	echo '@page' >>$@
	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	cat elisp2-toc >>$@


# \f initial aux files.
# 
# append vol2's fixed aux to normal vol1.  The initial runs saved
# elisp1-aux and elisp2-aux.
elisp1-aux-ready: elisp2-aux-vol-added
	cat elisp1-aux $< >$@
#
# prepend vol1's fixed aux to vol2.
elisp2-aux-ready: elisp1-aux-vol-added
	cat $< elisp2-aux >$@

# on -pg entries, append volume number after page number.
elisp1-aux-vol-added: elisp1-init
	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie1}/' elisp1-aux >$@
#
elisp2-aux-vol-added: elisp2-init
	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie2}/' elisp2-aux >$@

# \f initial index (fns) file.
# 
# Append other volume's index entries to this one's.
# Index entries in this volume will then take precedence.
elisp1-fns-ready: elisp1-fn-vol-added elisp2-fn-vol-added
	cat elisp2-fn-vol-added >>vol1.fn
	texindex vol1.fn
	cp vol1.fns $@
#
elisp2-fns-ready: elisp1-fn-vol-added elisp2-fn-vol-added
	cat elisp1-fn-vol-added >>vol2.fn
	texindex vol2.fn
	cp vol2.fns $@

# Insert volume number (I: or II:) into index file.
elisp1-fn-vol-added: elisp1-init
	cp vol1.fn elisp1-fn
	sed 's/}{/}{I:/' elisp1-fn >$@
#
elisp2-fn-vol-added: elisp2-init
	cp vol2.fn elisp2-fn
	sed 's/}{/}{II:/' elisp2-fn >$@


# \f initial TeX runs.
# 
# We use the .fn, .aux, and .toc files created here in subsequent
# processing.  The page numbers generated here will not be correct yet,
# but we run texindex and TeX a second time just to get them closer.
# Otherwise it might take even longer for them to converge.
# 
elisp1-init: vol1.texi
	@echo -e "\f Initial TeX run for volume 1..."
	rm -f vol1.aux vol1.toc
	$(tex) $<
	texindex vol1.??
	mv vol1.aux elisp1-aux
	mv vol1.toc elisp1-toc
	touch $@
#
elisp2-init: vol2.texi
	@echo "Initial TeX run for volume 2..."
	rm -f vol2.aux vol2.toc
	$(tex) $<
	texindex vol2.??
	mv vol2.aux elisp2-aux
	mv vol2.toc elisp2-toc
	touch $@

# COPYING CONDITIONS
# 
# This file 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 3 of the License, or
# (at your option) any later version.
# 
# This file 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 this file.  If not, see <http://www.gnu.org/licenses/>.
Commit	Line	Data
acaf905b	1	# Copyright (C) 2007-2012 Free Software Foundation, Inc.
c85c5553 KB	2	# See end for copying conditions.
	3
	4	# although it would be nice to use tex rather than pdftex to avoid
	5	# colors, spurious warnings about names being referenced but not
	6	# existing, etc., dvips \| ps2pdf doesn't preserve the page size.
	7	# Instead of creating a special dvips config file, put up with the warnings.
b5776ecf GM	8	texinfodir=../misc
	9
	10	tex = TEXINPUTS=".:$(texinfodir):${TEXINPUTS}" pdftex -interaction=nonstopmode
c85c5553 KB	11
	12	all: vol1.pdf vol2.pdf
	13
	14	# vol1.texi and vol2.texi specially define \tocreadfilename so we can
	15	# use our premade .toc's.
	16	#
	17	vol1.pdf: elisp1med-fns-ready elisp1med-aux-ready elisp1med-toc-ready
	18	@echo -e "\f Final TeX run for volume 1..."
	19	cp elisp1med-toc-ready elisp1-toc-ready.toc
	20	cp elisp1med-fns-ready vol1.fns
	21	cp elisp1med-aux-ready vol1.aux
	22	$(tex) vol1.texi
	23	#
	24	vol2.pdf: elisp2med-fns-ready elisp2med-aux-ready elisp2med-toc-ready
	25	@echo "Final TeX run for volume 2..."
	26	cp elisp2med-toc-ready elisp2-toc-ready.toc
	27	cp elisp2med-fns-ready vol2.fns
	28	cp elisp2med-aux-ready vol2.aux
	29	$(tex) vol2.texi
	30
	31	# \f intermediate toc files.
	32	#
	33	# vol1 toc: volume 1, page break, volume 2 (with II: prepended).
	34	elisp1med-toc-ready: elisp1med-init elisp2med-init
	35	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	36	cat elisp1med-toc >>$@
	37	echo '@page' >>$@
	38	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	39	sed 's/{\([^}]*\)}$$/{II:\1}/' elisp2med-toc >>$@
	40	#
	41	# vol2 toc: volume 1 (with I: prepended), page break, volume 2.
	42	elisp2med-toc-ready: elisp1med-init elisp2med-init
	43	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	44	sed 's/{\([^}]*\)}$$/{I:\1}/' elisp1med-toc >>$@
	45	echo '@page' >>$@
	46	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	47	cat elisp2med-toc >>$@
	48
	49
	50	# \f intermediate aux files.
	51	#
	52	# append vol2's fixed aux to normal vol1.
	53	elisp1med-aux-ready: elisp2med-aux-vol-added
	54	cat elisp1med-aux $< >$@
	55	#
	56	# prepend vol1's fixed aux to vol2.
	57	elisp2med-aux-ready: elisp1med-aux-vol-added
	58	cat $< elisp2med-aux >$@
	59
	60	# on -pg entries, append volume number after page number.
	61	elisp1med-aux-vol-added: elisp1med-init
	62	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie1}/' elisp1med-aux >$@
	63	#
	64	elisp2med-aux-vol-added: elisp2med-init
	65	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie2}/' elisp2med-aux >$@
c85c5553 KB	66
	67	# \f intermediate index (fns) file.
	68	#
	69	elisp1med-fns-ready: elisp1med-fn-vol-added elisp2med-fn-vol-added
	70	cat elisp2med-fn-vol-added >>vol1.fn
	71	texindex vol1.fn
	72	cp vol1.fns $@
	73	#
	74	elisp2med-fns-ready: elisp1med-fn-vol-added elisp2med-fn-vol-added
	75	cat elisp1med-fn-vol-added >>vol2.fn
	76	texindex vol2.fn
	77	cp vol2.fns $@
	78
	79	# Insert volume number (I: or II:) into index file.
	80	elisp1med-fn-vol-added: elisp1med-init
	81	cp vol1.fn elisp1med-fn
	82	sed 's/}{/}{I:/' elisp1med-fn >$@
	83	#
	84	elisp2med-fn-vol-added: elisp2med-init
	85	cp vol2.fn elisp2med-fn
	86	sed 's/}{/}{II:/' elisp2med-fn >$@
	87
	88	# -----------------------------------------------------------------------------
	89	# everything above is essentially a duplicate of everything below. sorry.
	90	# -----------------------------------------------------------------------------
	91
	92	# \f intermediate TeX runs.
	93	#
	94	# this generates what would be the final versions -- except the page
	95	# numbers aren't right. The process of adding the I: and II: changes
	96	# the page breaks, so a few index entries, at least are wrong. (In
	97	# 2007, x-meta-keysym in vol.II ended up on page 374 when the index had
	98	# it on page 375 from the initial run.)
	99	#
	100	# So, we start all over again, from these fns/aux/toc files.
	101	#
b5776ecf	102	elisp1med-init: elisp1-fns-ready elisp1-aux-ready elisp1init-toc-ready $(texinfodir)/texinfo.tex
c85c5553 KB	103	@echo -e "\f Intermediate TeX run for volume 1..."
	104	cp elisp1init-toc-ready elisp1-toc-ready.toc
	105	cp elisp1-fns-ready vol1.fns
	106	cp elisp1-aux-ready vol1.aux
	107	$(tex) vol1.texi
	108	texindex vol1.??
	109	mv vol1.aux elisp1med-aux
	110	mv vol1.toc elisp1med-toc
	111	#
b5776ecf	112	elisp2med-init: elisp2-fns-ready elisp2-aux-ready elisp2init-toc-ready $(texinfodir)/texinfo.tex
c85c5553 KB	113	@echo "Final TeX run for volume 2..."
	114	cp elisp2init-toc-ready elisp2-toc-ready.toc
	115	cp elisp2-fns-ready vol2.fns
	116	cp elisp2-aux-ready vol2.aux
	117	$(tex) vol2.texi
	118	texindex vol2.??
	119	mv vol2.aux elisp2med-aux
	120	mv vol2.toc elisp2med-toc
	121
	122
	123	# \f initial toc files.
	124	#
	125	# vol1 toc: volume 1, page break, volume 2 (with II: prepended).
	126	elisp1init-toc-ready: elisp1-init elisp2-init
	127	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	128	cat elisp1-toc >>$@
	129	echo '@page' >>$@
	130	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	131	sed 's/{\([^}]*\)}$$/{II:\1}/' elisp2-toc >>$@
	132	#
	133	# vol2 toc: volume 1 (with I: prepended), page break, volume 2.
	134	elisp2init-toc-ready: elisp1-init elisp2-init
	135	echo '@unnchapentry{@b{Volume 1}}{10001}{vol1}{}' >$@
	136	sed 's/{\([^}]*\)}$$/{I:\1}/' elisp1-toc >>$@
	137	echo '@page' >>$@
	138	echo '@unnchapentry{@b{Volume 2}}{10001}{vol2}{}' >>$@
	139	cat elisp2-toc >>$@
	140
	141
	142	# \f initial aux files.
	143	#
	144	# append vol2's fixed aux to normal vol1. The initial runs saved
	145	# elisp1-aux and elisp2-aux.
	146	elisp1-aux-ready: elisp2-aux-vol-added
	147	cat elisp1-aux $< >$@
	148	#
	149	# prepend vol1's fixed aux to vol2.
	150	elisp2-aux-ready: elisp1-aux-vol-added
	151	cat $< elisp2-aux >$@
	152
	153	# on -pg entries, append volume number after page number.
	154	elisp1-aux-vol-added: elisp1-init
	155	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie1}/' elisp1-aux >$@
	156	#
	157	elisp2-aux-vol-added: elisp2-init
	158	sed 's/-pg}{\(.*\)}$$/-pg}{\1, vol.@tie2}/' elisp2-aux >$@
c85c5553 KB	159
	160	# \f initial index (fns) file.
	161	#
	162	# Append other volume's index entries to this one's.
	163	# Index entries in this volume will then take precedence.
	164	elisp1-fns-ready: elisp1-fn-vol-added elisp2-fn-vol-added
	165	cat elisp2-fn-vol-added >>vol1.fn
	166	texindex vol1.fn
	167	cp vol1.fns $@
	168	#
	169	elisp2-fns-ready: elisp1-fn-vol-added elisp2-fn-vol-added
	170	cat elisp1-fn-vol-added >>vol2.fn
	171	texindex vol2.fn
	172	cp vol2.fns $@
	173
	174	# Insert volume number (I: or II:) into index file.
	175	elisp1-fn-vol-added: elisp1-init
	176	cp vol1.fn elisp1-fn
	177	sed 's/}{/}{I:/' elisp1-fn >$@
	178	#
	179	elisp2-fn-vol-added: elisp2-init
	180	cp vol2.fn elisp2-fn
	181	sed 's/}{/}{II:/' elisp2-fn >$@
	182
	183
	184	# \f initial TeX runs.
	185	#
	186	# We use the .fn, .aux, and .toc files created here in subsequent
	187	# processing. The page numbers generated here will not be correct yet,
	188	# but we run texindex and TeX a second time just to get them closer.
	189	# Otherwise it might take even longer for them to converge.
	190	#
	191	elisp1-init: vol1.texi
	192	@echo -e "\f Initial TeX run for volume 1..."
	193	rm -f vol1.aux vol1.toc
	194	$(tex) $<
	195	texindex vol1.??
	196	mv vol1.aux elisp1-aux
	197	mv vol1.toc elisp1-toc
	198	touch $@
	199	#
	200	elisp2-init: vol2.texi
	201	@echo "Initial TeX run for volume 2..."
	202	rm -f vol2.aux vol2.toc
	203	$(tex) $<
	204	texindex vol2.??
	205	mv vol2.aux elisp2-aux
	206	mv vol2.toc elisp2-toc
	207	touch $@
	208
	209	# COPYING CONDITIONS
	210	#
352c8b4a	211	# This file is free software: you can redistribute it and/or modify
c85c5553	212	# it under the terms of the GNU General Public License as published by
352c8b4a GM	213	# the Free Software Foundation, either version 3 of the License, or
352c8b4a GM	214	# (at your option) any later version.
c85c5553 KB	215	#
	216	# This file is distributed in the hope that it will be useful,
	217	# but WITHOUT ANY WARRANTY; without even the implied warranty of
	218	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	219	# GNU General Public License for more details.
	220	#
	221	# You should have received a copy of the GNU General Public License
352c8b4a	222	# along with this file. If not, see <http://www.gnu.org/licenses/>.
c85c5553	223