Makefile revision 13036
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# Makefile for generateing man page tarballs that are used in each of the
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# SUNW*.spec files
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# e.g. sun-manpage-tarballs/*.tar.gz
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# "make" : Rebuilds all man page tarballs
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# "make check-used" : Outputs list of man pages not being used.
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# "make check-version" : Prints current man page tarball version
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# will only generate SUNWgnome-panel's man page tarball
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# For each package that contains man pages.
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# - Ensure all relevant man pages for your package are located under the
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# correct man page section dir i.e.
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# - Add Package name to PACKAGES Variable
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# e.g. PACKAGES = \
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# SUNWgnome-panel \
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# SUNWyour-package
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# - Add two package specific variables
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# PACKAGE_PAGES - Full path of all manpages for this package
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# To Add new man pages to existing packages
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# -----------------------------------------
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# Put very simply, all that is required from engineers is to make some changes
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# and commit in SVN.
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# - Ensure the man page exists in SVN under the relevant man page section sub
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# - Add man page to the SUNW<package>_PAGES Makefile variable
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# e.g. For a new gnome-panel man page it would be added to
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# SUNWgnome-panel_PAGES
a0ed50307cf80490d23a92f5eac0bfcd26343dd6Jason King# - Remake tarballs
PACKAGES = \
SUNWTiff \
SUNWdbus \
SUNWgnome-cd \
SUNWgnome-print \
SUNWjpg \
SUNWpng \
SUNWTiff_PAGES = \
SUNWdbus_PAGES = \
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)