#########################################################################
# Makefile.common
#
# This file, to be included from every document's local Makefile, provides
# the basic targets used by the Fedora Docs Project:
# all			-- Default target, builds HTML document only
# ${DOCNAME}/index.html	-- Builds HTML version of document
# html			-- See "${DOCNAME}/index.html"
# html-nochunks		-- See "${DOCNAME}.html"; single HTML file
# ${DOCNAME}.tar.gz	-- Packages HTML document into a tar archive
# tarball		-- See "${DOCNAME}.tar.gz"
# clean			-- Deletes all generated files and directories
# distclean		-- See "clean"
# ${DOCNAME}.pdf	-- Builds PDF version of document
# pdf			-- See "${DOCNAME}.pdf"
#########################################################################

#########################################################################
# PDF generation is still fragile and probably won't work on your document.
# Yet.
#########################################################################

#########################################################################
# Note: all targets within this Makefile.common must be defined as 
# double-colon (::) targets so that additional steps can be added by
# providing additional rules, also marked with double-colons, in the
# document Makefile.
#########################################################################

#########################################################################
# N.B., if you want to use built-in variables such as "$@" in a template
# be sure to quote them as "$$@" since the template is evaluated once as
# it is expanded
#########################################################################

#########################################################################
# WARNING.  This feature is deprecated and will shortly disappear.
#########################################################################
# Allow client document to provide "Make.paths" file to locate our files
# This is a "silent include", so if it's missing there is no problem.
# This file, if present, must be in the DOCUMENT directory, not here in
# docs-common.  Even if this file is present, defining FTPDIR via the
# command line will take precedence.
sinclude Make.paths
#########################################################################

#########################################################################
# Supply default values for the boilerplate files _unless_ the user has
# provided their own values.
ifeq	"${FDPDIR}" ""
FDPDIR	         = $(PWD)/..
endif
ifeq	"${FDPBIN}" ""
FDPBIN	         = ${FDPDIR}/docs-common/bin
endif
ifeq	"${XSLPDF}" ""
XSLPDF		= ${FDPDIR}/docs-common/xsl/main-pdf.xsl
endif
ifeq	"${XSLHTML}" ""
XSLHTML        	= ${FDPDIR}/docs-common/xsl/main-html.xsl
endif
ifeq	"${XSLHTMLNOCHUNKS}" ""
XSLHTMLNOCHUNKS	= ${FDPDIR}/docs-common/xsl/main-html-nochunks.xsl
endif
ifeq	"${HTMLCSS}" ""
HTMLCSS		= ${FDPDIR}/docs-common/css/fedora-draft.css
endif
ifeq	"${DRAFT}" ""
DRAFT	= yes
endif
ifeq	"${PRI_LANG}" ""
PRI_LANG= en
endif
ifeq	"${RPMINFO}" ""
RPMINFO		= ${PWD}/rpm-info.xml
endif
ifeq	"${RPMPREP}" ""
RPMPREP=yes
endif
ifeq	"${RPMPOST}" ""
RPMPOST=yes
endif
#########################################################################

#########################################################################
# Strange though it may seem, some shells do not provide a ${PWD} 
# environment variable for us.
PWD	:=$(shell /bin/pwd)
#########################################################################

#########################################################################
# Use macros to locate our commonly-used programs
XMLTO	=xmlto
XSLTPROC=xsltproc
XMLFORMAT=xmlformat
XMLFOPTS=-f $(FDPDIR)/docs-common/bin/xmlformat-fdp.conf
XML2PO	=xml2po
PO2XML	=po2xml
MSGMERGE=msgmerge
#########################################################################

#########################################################################
# Rules to produce .po files from .xml files.  Get the tools to do this
# from the gnome-doc-utils RPM.
.SUFFIXES: .po .pot .xml
%.po:	%.xml
	${XML2PO} $< >$@
#########################################################################

#########################################################################
# Use our very own "docs-common/bin/fdpsh" as the command interpreter
# This automatically has ${FDPBIN} as first in the ${PATH}
SHELL	=${FDPBIN}/fdpsh
#########################################################################

#########################################################################
# Obtain the document version and release info for building RPM's
VERSION:=$(shell version doc)
RELEASE:=$(shell version rpm)
#########################################################################

#########################################################################
RPMFLAGS=--define "docbase $(DOCBASE)" 					\
	 --define "_topdir $(PWD)/rpm" 					\
	 --define "fdpdir $(FDPDIR)"

SPECFILE=fedora-doc-$(DOCBASE).spec

ifeq	"${RPMDEBUG}" "1"
RPMDFLAG	= -vv
endif
#########################################################################

#########################################################################
# Set a provisional ${LANG} value.  We'll dynamically change this as 
# needed.  The "${PRI_LANG}" value is used because that is the original 
# language the doc.
LANG	=${PRI_LANG}
LANGUAGES=${PRI_LANG} ${OTHERS}
#
#########################################################################

#########################################################################
# Expand the template the XMLFILES_template to produce XMLFILES-${LANG}
# macros that enumerate all of the input files for the document.

$(foreach L,${LANGUAGES},$(eval $(call XMLFILES_template,${L})))
#
#########################################################################

#########################################################################
# PUT NO TARGETS BEFORE THIS ONE, not even in your base Makefile
# In a properly-constructed Makefile, this will be the default target

TARGETS=all clean distclean fdp-info html html-nochunks pdf po showvars \
        tarball rpm rpm-common noarch srpm package-prep package-post	\
	src-tarball

# FIXME: add the .PHONY attribute where the actual target is defined

.PHONY:	${TARGETS}
.PHONY:	$(foreach LANG,${LANGUAGES},html-${LANG})
.PHONY:	$(foreach LANG,${LANGUAGES},html-nochunks-${LANG})
.PHONY:	$(foreach LANG,${LANGUAGES},pdf-${LANG})

all::	html html-nochunks tarball # pdf

${TARGETS}::

#########################################################################
# Ensure all 'clean' targets are invoked before 'distclean' targets
distclean:: clean
#
#########################################################################

#########################################################################
# For each LANG in LANGUAGES, generate a target and rule similar to:
# mydoc-en/index.html:: mydoc-en.xml ${XMLEXTRAFILES}-en
#  LANG=en.UTF-8 ${XMLTO} html -x $(XSLHTML) -o mydoc-en mydoc-en.xml
#  mkdir -p mydoc-en/stylesheet-images
#  cp ${FDPDIR}/docs-common/stylesheet-images/*.png mydoc-en/stylesheet-images/
#  cp ${HTMLCSS} mydoc-en/fedora.css
#  cp ${HTMLCSSEXTRA} mydoc-en/watermark.png
#  cp ${FDPDIR}/docs-common/images/watermark.png mydoc-en/
#  ${FDPDIR}/docs-common/bin/copy-figs -f '*.png' figs mydoc-en/
# but we do avoid copying EPS files since they are nonsense to the HTML world.
#
define	HTML_template
.PHONY:	html-${1}
html-$(1) ${DOCBASE}-$(1)/index.html:: ${XMLFILES-${1}} $(1)/fdp-info.xml
	LANG=$(1).UTF-8 ${XMLTO} html -x $(XSLHTML) -o $(DOCBASE)-$(1) $(1)/$(DOCBASE).xml
	mkdir -p $(DOCBASE)-$(1)/stylesheet-images/
	cp ${FDPDIR}/docs-common/stylesheet-images/*.png $(DOCBASE)-$(1)/stylesheet-images
	cp ${HTMLCSS} $(DOCBASE)-$(1)/fedora.css
ifeq	"${DRAFT}" "yes"
	cp ${FDPDIR}/docs-common/images/watermark-$(1).png 		\
		$(DOCBASE)-$(1)/watermark.png
endif
	[ ! -d figs ] || copy-figs -v -f '*.png' 			\
				-l $(1) figs $(DOCBASE)-$(1)

distclean::
	${RM} -r ${DOCBASE}-${1}
endef

$(foreach L,${LANGUAGES},$(eval $(call HTML_template,${L})))

.PHONY:	html

html::	$(foreach L,${LANGUAGES},html-${L})
#
#########################################################################

#########################################################################
# For each language in ${LANGUAGES}, generate a single HTML file
define	HTMLNOCHUNK_template
.PHONY:	html-nochunks-${1}

html-nochunks-$(1) ${DOCBASE}-$(1).html:: ${XMLFILES-${1}} $(1)/fdp-info.xml
	${XMLTO} html-nochunks -x $(XSLHTMLNOCHUNKS) $(1)/$(DOCBASE).xml
	mkdir -p stylesheet-images/
	cp ${FDPDIR}/docs-common/stylesheet-images/*.png stylesheet-images/
	cp ${HTMLCSS} fedora.css
ifeq	"${DRAFT}" "yes"
	cp ${FDPDIR}/docs-common/images/watermark-$(1).png watermark.png
endif

distclean::
	${RM} ${DOCBASE}-${1}.html
	${RM} -r stylesheet-images
	${RM} fedora.css
	${RM} watermark.png
endef

$(foreach L,${LANGUAGES},$(eval $(call HTMLNOCHUNK_template,${L})))

.PHONY:	html-nochunks

html-nochunks::	$(foreach L,${LANGUAGES},html-nochunks-$(L))
#
#########################################################################

#########################################################################
# For each language in ${LANGUAGES}, build a tarball of the HTML and
# image files.  Any ".eps" files are ignored.
#
define	HTMLTAR_template
${DOCBASE}-$(1).tar.gz:: ${DOCBASE}-$(1)/index.html
	tar -zc --exclude '*.eps' -f ${DOCBASE}-$(1).tar.gz ${DOCBASE}-$(1)

distclean::
	${RM} ${DOCBASE}-${1}.tar.gz
endef

$(foreach L,${LANGUAGES},$(eval $(call HTMLTAR_template,${L})))

.PHONY:	tarball

tarball::	$(foreach LANG,${LANGUAGES},$(DOCBASE)-$(LANG).tar.gz)
#
#########################################################################

#########################################################################
# For each language in ${LANGUAGES}, generate an Adobe Portable Document
# Format (PDF) file.
define	PDF_template
.PHONY:	pdf-${1}

pdf-$(1) ${DOCBASE}-$(1).pdf:: ${XMLFILES-${1}} ${1}/fdp-info.xml
	${XMLTO} pdf -x $(XSLPDF) $(1)/$(DOCBASE)-$(1).xml

distclean::
	${RM} ${DOCBASE}-${1}.pdf
endef

$(foreach L,${LANGUAGES},$(eval $(call PDF_template,${L})))

.PHONY:	pdf

pdf::	$(foreach LANG,${LANGUAGES},pdf-$(LANG))
#
#########################################################################

#########################################################################
clean:: 
	${RM} *.tmp
#########################################################################

#########################################################################
po/${DOCBASE}.pot:: ${XMLFILES-${PRI_LANG}}
	[ -d po ] || (echo ADD po/ TO CVS >&2; exit 1)
	${XML2PO} -o $@ $^

.PHONY:	pot

pot::	po/${DOCBASE}.pot
#########################################################################

#########################################################################
define	XML_template
$(patsubst ${PRI_LANG}/%,${1}/%,${2}):: ${2} po/${1}.po
	mkdir -p ${1}
	${PO2XML} ${2} po/${1}.po >$$@
endef

$(foreach L,${OTHERS},							\
	$(foreach F,${XMLFILES-${PRI_LANG}},				\
		$(eval $(call XML_template,${L},${F}))))

define	XMLTARGET_template
.PHONY:	xml-${1}

xml-${1}::	${XMLFILES-${1}}

distclean::
	${RM} -r ${1}
endef

.PHONY:	xml-${PRI_LANG}

xml-${PRI_LANG}:: ${XMLFILES-${PRI_LANG}}

$(foreach L,${OTHERS},$(eval $(call XMLTARGET_template,${L})))

.PHONY:	xml-all

xml-all:: $(foreach L,${LANGUAGES},xml-${L})

distclean::
	$(foreach L,${OTHERS},${RM} -r ${L})
#########################################################################

#########################################################################
define	PO_template
po/${1}.po:: ${XMLFILES-${PRI_LANG}} po/${DOCBASE}.pot
	[ -d po ] || (echo ADD po/ TO CVS >&2; exit 1)
	if [ ! -f $$@ ]; then						\
		cp po/${DOCBASE}.pot $$@;				\
	else								\
		cp $$@ $$@.bank;					\
		${MSGMERGE} -o $$@ $$@.bank po/${DOCBASE}.pot;		\
	fi

.PHONY:	po-${1}
po-${1}:: po/${1}.po
endef

$(foreach L,${OTHERS},$(eval $(call PO_template,${L})))

.PHONY:	po

po::	$(foreach L,${OTHERS},po-${L})
#########################################################################

#########################################################################
#
showvars::
	@echo "DOCBASE=\"$(DOCBASE)\""
	@echo "PRI_LANG=\"$(PRI_LANG)\""
	@echo "OTHERS=\"$(OTHERS)\""
#
#########################################################################

#########################################################################
# Show differences between two file revisions. To use this tool:
# 	$ make OLD=old.xml NEW=new.xml diff
# The ${DIFFS} macro can select a different output format:
# 	$ make DIFFS=-C OLD=old.xml NEW=new.xml diff

OLD	=define-me-old.xml
NEW	=define-me-new.xml
DIFFS	=-u

diff::
	xmldiff ${DIFFS} ${OLD} ${NEW}
#
#########################################################################

#########################################################################
# The "${LANG}/fdp-info.xml" file contains the <articleinfo> or 
# <bookinfo> stanza.  It is automatically generated from data in the
# "rpm-info.xml" file whenever that file changes.
#
define fdp-info_template
$(1)/fdp-info.xml::	$(RPMINFO)
	${XSLTPROC} --stringparam lang $(1)				\
		--stringparam fdpdir $(FDPDIR)				\
		--stringparam doctype $(shell				\
			doctype ${PRI_LANG}/$(DOCBASE).xml		\
		) ${FDPDIR}/docs-common/packaging/bookinfo.xsl 		\
		$(RPMINFO) 					| 	\
	$(XMLFORMAT) $(XMLFOPTS) >$$@

clean::
	${RM} ${1}/fdp-info.xml
endef

$(foreach L,${LANGUAGES},$(eval $(call fdp-info_template,${L})))

.PHONY:	fdp-info

fdp-info::  $(foreach LANG,${LANGUAGES},$(LANG)/fdp-info.xml)
#
#########################################################################

#########################################################################
# Stuff after here is for RPM packaging
#########################################################################

#########################################################################
# Make a new changelog entry for an existing rpm-info.xml file.

clog:: $(RPMINFO)
	insert-changelog $(RPMINFO).tmp && 	\
		move-if-change $(RPMINFO).tmp $(RPMINFO)

#
#########################################################################
# Make a new colophon entry for an existing rpm-info.xml file.

colophon:: $(RPMINFO)
	insert-colophon $(RPMINFO).tmp && 	\
		move-if-change $(RPMINFO).tmp $(RPMINFO)


#########################################################################
.PHONY:	${DOCBASE}-${1}-distclean

define	DISTCLEAN_template
${DOCBASE}-$(1)-distclean::
	${RM} *-$(1).omf
	${RM} *-$(1).desktop
endef

$(foreach L,${LANGUAGES},$(eval $(call DISTCLEAN_template,${L})))

distclean:: $(foreach L,${LANGUAGES},${DOCBASE}-${L}-distclean)
#########################################################################

clean::
	${RM} $(DOCBASE)-$(VERSION)*.src.tar.gz
	${RM} -r $(DOCBASE)-$(VERSION)/
	${RM} *.omf *.desktop $(SPECFILE)
	${RM} *~

distclean::
	${RM} -r rpm
	${RM} fedora-doc-$(DOCBASE)*.rpm
	${RM} fedora-doc-$(DOCBASE)*.omf
	${RM} fedora-doc-$(DOCBASE)*.desktop
	${RM} fedora-doc-$(DOCBASE)*.spec
	${RM} $(DOCBASE)*.src.tar.gz

spec::	${SPECFILE}

${SPECFILE}::	${RPMINFO}
	$(XSLTPROC) --stringparam docbase "${DOCBASE}"			\
		${FDPDIR}/docs-common/packaging/spec.xsl ${RPMINFO}	\
		>$@.tmp && move-if-change $@.tmp $@


gnome.desktop::	fedora-doc-${DOCBASE}-gnome.desktop

fedora-doc-${DOCBASE}-gnome.desktop:: ${RPMINFO}
	$(XSLTPROC) --stringparam docbase "${DOCBASE}"			\
		${FDPDIR}/docs-common/packaging/gnome-desktop.xsl	\
		${RPMINFO} >$@.tmp && move-if-change $@.tmp $@

kde.desktop::	fedora-doc-${DOCBASE}-kde.desktop

fedora-doc-${DOCBASE}-kde.desktop:: ${RPMINFO}
	$(XSLTPROC) --stringparam docbase "${DOCBASE}"			\
		${FDPDIR}/docs-common/packaging/kde-desktop.xsl 	\
		${RPMINFO} >$@.tmp && move-if-change $@.tmp $@

khelp.desktop::		fedora-doc-${DOCBASE}-khelp.desktop

fedora-doc-${DOCBASE}-khelp.desktop:: ${RPMINFO}
	$(XSLTPROC) --stringparam docbase "${DOCBASE}"			\
		${FDPDIR}/docs-common/packaging/khelpcenter-plugin.xsl 	\
		${RPMINFO} >$@.tmp && move-if-change $@.tmp $@


define omf_template
omf-$(1)::	fedora-doc-${DOCBASE}-$(1).omf

fedora-doc-${DOCBASE}-$(1).omf:: ${RPMINFO}
	${XSLTPROC} --stringparam docbase "${DOCBASE}" 			\
		--stringparam lang "$(1)"				\
		${FDPDIR}/docs-common/packaging/omf.xsl ${RPMINFO}    |	\
	$(XMLFORMAT) $(XMLFOPTS) >fedora-doc-${DOCBASE}-$(1).omf.tmp &&	\
	move-if-change fedora-doc-${DOCBASE}-$(1).omf.tmp fedora-doc-${DOCBASE}-$(1).omf
endef

fedora-doc-${DOCBASE}-C.omf::	fedora-doc-${DOCBASE}-en.omf
	cp fedora-doc-$(DOCBASE)-en.omf $@

$(foreach LANG,${LANGUAGES},$(eval $(call omf_template,${LANG})))

omf::  $(foreach LANG,${LANGUAGES},omf-$(LANG)) fedora-doc-${DOCBASE}-C.omf


src-tarball $(DOCBASE)-$(VERSION).src.tar.gz::
	${MAKE} fdp-info
	${MAKE} gnome.desktop
	${MAKE} kde.desktop
	${MAKE} khelp.desktop
	${MAKE} omf
	${RM} -r $(DOCBASE)-$(VERSION)
	mkdir -p $(DOCBASE)-$(VERSION)
	find . '('							\
		-name '*#*'						\
		-o -name 'CVS'						\
		-o -name 'rpm'						\
		-o -name '*.rpm'					\
		-o -name '*~'						\
		-o -name '*.tar.gz'					\
		-o -name '*.tmp'					\
		-o -name '${DOCBASE}-${VERSION}'			\
	')' -prune -o -print | cpio -pamdv $(DOCBASE)-$(VERSION)
	tar -zcvf $(DOCBASE)-$(VERSION).src.tar.gz $(DOCBASE)-$(VERSION)/
	${RM} -r $(DOCBASE)-$(VERSION)

package-prep::
	${MAKE} distclean
	${MAKE} ${DOCBASE}-${shell version doc}.src.tar.gz
	${MAKE} ${SPECFILE}
	${MAKE} omf
	${MAKE} kde.desktop
	${MAKE} khelp.desktop
	mkdir -p rpm/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
	mkdir -p rpm/RPMS/{i386,i486,i586,i686,noarch,ppc,x86_64}
	cp -f $(DOCBASE)-$(shell version doc).src.tar.gz rpm/SOURCES/
	cp -f ${SPECFILE} rpm/SPECS
	cp -f *.omf *.desktop rpm/SOURCES

rpm-common::
	if test $(shell get_latest_revision rpm) = 0 ; then		\
		echo "*** Creating revision log entry for rpm ***" ;	\
		ROLE=rpm $(MAKE) clog ;					\
	fi
	${RM} *.rpm
	if test $(RPMPREP) != "no" ; then ${MAKE} package-prep ; fi

noarch:: rpm-common
	rpmbuild -bb $(RPMDFLAG) $(RPMFLAGS) rpm/SPECS/$(SPECFILE)
	if test $(RPMPOST) != "no" ; then $(MAKE) package-post ; fi

srpm:: rpm-common
	rpmbuild -bs $(RPMDFLAG) $(RPMFLAGS) rpm/SPECS/$(SPECFILE)
	if test $(RPMPOST) != "no" ; then $(MAKE) package-post ; fi

rpm:: rpm-common
	rpmbuild -ba $(RPMDFLAG) $(RPMFLAGS) rpm/SPECS/$(SPECFILE)
	if test $(RPMPOST) != "no" ; then $(MAKE) package-post ; fi

package-post::
	$(MAKE) clean  # If needed, review materials in rpm/BUILD/
	find rpm/ -name '*.rpm' -exec ln '{}' . ';'
	ls *.rpm

showvars::
	@echo "VERSION=$(VERSION)"
	@echo "RELEASE=$(RELEASE)"
	@echo "PWD=$(PWD)"


#########################################################################
# End of Makefile.common
#########################################################################
# Local variables:
# mode: makefile
# End: