Makefile revision 10915
33d0a7767d53cb366039fd0ac4f63cf8a9c351b0Tinderbox User# Makefile for generateing man page tarballs that are used in each of the
9210d8796eaf4125ac58c034f9b5ca167857a55aAutomatic Updater# SUNW*.spec files
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# e.g. sun-manpage-tarballs/*.tar.gz
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# "make" : Rebuilds all man page tarballs
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# "make check-used" : Outputs list of man pages not being used.
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# "make check-version" : Prints current man page tarball version
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# will only generate SUNWgnome-panel's man page tarball
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# For each package that contains man pages.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# - Ensure all relevant man pages for your package are located under the
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# correct man page section dir i.e.
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# - Add Package name to PACKAGES Variable
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# e.g. PACKAGES = \
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# SUNWgnome-panel \
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# SUNWyour-package
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# - Add two package specific variables
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# PACKAGE_PAGES - Full path of all manpages for this package
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# To Add new man pages to existing packages
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# -----------------------------------------
f5ae3cca1d2832239cc821bdef77e90c1739e66dTinderbox User# Put very simply, all that is required from engineers is to make some changes
ec899c963c91c16c393e067996400ae244921110Tinderbox User# and commit in SVN.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# - Ensure the man page exists in SVN under the relevant man page section sub
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# - Add man page to the SUNW<package>_PAGES Makefile variable
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# e.g. For a new gnome-panel man page it would be added to
ec899c963c91c16c393e067996400ae244921110Tinderbox User# SUNWgnome-panel_PAGES
ec899c963c91c16c393e067996400ae244921110Tinderbox User# - Remake tarballs
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# This will re-generate all man page tarballs.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# - Copy newly generated tarball from sun-manpage-tarballs to package build
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
ec899c963c91c16c393e067996400ae244921110Tinderbox User# install correctly.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# - New man page tarball will be generated by RE for each nightly, and for each
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# milestone build.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User# - Commit change back to subverison, e.g. new/amended man pagees,
ec899c963c91c16c393e067996400ae244921110Tinderbox User# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User# branched. PLEASE do not change this.
SUNWjpg_PAGES = \
SUNWpng_PAGES = \
SUNWfsexam_PAGES = \
@if test -f $(TARBALL_DIR)/$@; then \
echo " $$base_manpage"; \
echo " install --mode=0644 \$$\$$mp $$(DESTDIR)$$(MAN"$$mantype"DIR); \\" >> $(MANPAGE_DIR)/Makefile; \
@if test -f unused-manpages.txt; then \
@echo $(MANPAGE_VERSION)