17400N/A##
17400N/A# Makefile for generateing man page tarballs that are used in each of the
17400N/A# SUNW*.spec files
17400N/A#
17400N/A# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
17400N/A# e.g. sun-manpage-tarballs/*.tar.gz
17400N/A#
17400N/A# Usage :
17400N/A# "make" : Rebuilds all man page tarballs
17400N/A#
17400N/A# "make check-used" : Outputs list of man pages not being used.
17400N/A#
17400N/A# "make check-version" : Prints current man page tarball version
17400N/A#
17400N/A# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
17400N/A# e.g. "make SUNWgnome-panel-manpages-0.1.tar.gz"
17400N/A# will only generate SUNWgnome-panel's man page tarball
17400N/A#
17400N/A# For each package that contains man pages.
17400N/A# - Ensure all relevant man pages for your package are located under the
17400N/A# correct man page section dir i.e.
17400N/A# entities/man1/man1m/man3/man3tiff/man4/man5
17400N/A# - Add Package name to PACKAGES Variable
17400N/A# e.g. PACKAGES = \
17400N/A# SUNWgnome-panel \
17400N/A# SUNWyour-package
17400N/A#
17400N/A# - Add two package specific variables
17400N/A# PACKAGE - Full path of all manpages for this package with section
17400N/A# suffix.
17400N/A# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
17400N/A#
17400N/A#
17400N/A# To Add new man pages to existing packages
17400N/A# -----------------------------------------
17400N/A# Put very simply, all that is required from engineers is to make some changes
17400N/A# and commit in SVN.
17400N/A#
17400N/A# - Ensure the man page exists in SVN under the relevant man page section sub
17400N/A# dir
17400N/A# - Add man page to the SUNW<package>_PAGES Makefile variable
17400N/A# e.g. For a new gnome-panel man page it would be added to
17400N/A# SUNWgnome-panel_PAGES
17400N/A# - Remake tarballs
17400N/A# $ make
17400N/A# This will re-generate all man page tarballs.
17400N/A# - Copy newly generated tarball from sun-manpage-tarballs to package build
17400N/A# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
17400N/A# install correctly.
17400N/A# - New man page tarball will be generated by RE for each nightly, and for each
17400N/A# milestone build.
17400N/A# - Commit change back to subverison, e.g. new/amended man pagees,
17400N/A# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
17400N/A#
17400N/A#
17400N/A# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
17400N/A# branched. PLEASE do not change this.
17400N/A#
17400N/ASHELL=/bin/ksh
17400N/AMANPAGE_VERSION=0.1
17400N/AMANPAGE_DIR=sun-manpages
17400N/ATARBALL_DIR=sun-manpage-tarballs
17400N/AGZIP=/usr/bin/gzip
17400N/ATAR=/usr/bin/tar
17400N/AAWK=/usr/bin/awk
17400N/AMAKE=/usr/sfw/bin/gmake
17400N/AGREP=/usr/bin/grep
17400N/A
17400N/APACKAGES = \
17400N/A SUNWclutter \
17400N/A SUNWclutter-gst \
17691N/A SUNWclutter-gtk \
17707N/A SUNWseahorse-plugins \
18050N/A SUNWgnome-cd-burner \
18352N/A SUNWnwam-manager \
18050N/A SUNWlibtasn1-bin
17400N/A
17400N/ASUNWclutter = \
17400N/A man3/libclutter-glx-1.0.3
17400N/A
17400N/ASUNWclutter-gst = \
17400N/A man3/libclutter-gst-0.10.3
17400N/A
17400N/ASUNWclutter-gtk = \
17400N/A man3/libclutter-gtk-0.10.3
17400N/A
17691N/ASUNWseahorse-plugins = \
17691N/A man1/seahorse-agent.1 \
17691N/A man1/seahorse-tool.1
17691N/A
17707N/ASUNWgnome-cd-burner = \
17707N/A man1/brasero.1
17707N/A
18352N/ASUNWnwam-manager = \
18352N/A man1m/nwam-manager.1m \
18352N/A man1m/nwam-manager-properties.1m
18352N/A
18050N/ASUNWlibtasn1-bin = \
18050N/A man1/asn1Parser.1 \
18050N/A man1/asn1Coding.1 \
18050N/A man1/asn1Decoding.1
17400N/A
17400N/Aall: TARBALLS
17400N/A.PHONY: all clean prep check-used $(PACKAGES)
17400N/A
17400N/ATARBALLS = $(TARBALL_DIR)/$(addsuffix -$(MANPAGE_VERSION).tar.bz2, $(PACKAGES))
17400N/A
17400N/Aprep:
17400N/A @test -d $(TARBALL_DIR) || mkdir -p "$(TARBALL_DIR)"
17400N/A @test -x $(GZIP) || echo "gzip utility not found"
17400N/A
17400N/ATARBALLS: prep
17400N/A rm -rf $(TARBALL_DIR)/*.tar.gz
17400N/A @for package in $(PACKAGES); do \
17400N/A $(MAKE) MAKE=\"$(MAKE)\" $$package-manpages-$(MANPAGE_VERSION).tar.gz; \
17400N/A done
17400N/A
17400N/A%-manpages-$(MANPAGE_VERSION).tar.gz: % prep
17400N/A @rm -rf $(TARBALL_DIR)/$@
17400N/A @rm -rf $(MANPAGE_DIR)/*
17400N/A @test -d $(MANPAGE_DIR) || mkdir -p "$(MANPAGE_DIR)"
17400N/A @cp Makefile.template $(MANPAGE_DIR)/Makefile
17400N/A @tarball=`basename "$@" .gz`; echo "Making tarball $$tarball"; \
17400N/A for manpage in $($<); do \
17400N/A suffix_name=`echo $$manpage | \
17400N/A sed -n "s/man[0-9]\w*\/.*\.\([0-9]\w*\)$$/\1/p"`; \
17400N/A section_name=`echo "$$manpage" | \
17400N/A sed -n "s/man\([0-9]\w*\)\/.*\.\([0-9]\w*\)$$/\1/p"`; \
17400N/A [ "$$section_name" == "$$suffix_name" ] || \
17400N/A { echo "Can't recognize the section name of $$manpage_name"; exit 1; }; \
17400N/A manpage_name=`basename $$manpage`; \
17400N/A manpage_name=$$manpage_name; \
17400N/A cp $$manpage $(MANPAGE_DIR)/$$manpage_name; \
17400N/A done; \
17400N/A $(TAR) -cf $(TARBALL_DIR)/$$tarball $(MANPAGE_DIR); \
17400N/A $(GZIP) $(TARBALL_DIR)/$$tarball
17400N/A @rm -rf $(MANPAGE_DIR)
17400N/A
17400N/Acheck-used:
17400N/A @test -d check-used-manpages || mkdir -p "check-used-manpages"
17400N/A @test -d check-all-manpages || mkdir -p "check-all-manpages"
17400N/A @rm -f unused-manpages.txt
17400N/A @cp man*/* check-all-manpages
17400N/A @for package in $(PACKAGES); do \
17400N/A $(MAKE) MAKE=\"$(MAKE)\" $$package.check-used; \
17400N/A done
17400N/A @all_manpages=`ls check-all-manpages/*`; \
17400N/A for manpage in $$all_manpages; do \
17400N/A base_manpage=`basename $$manpage`; \
17400N/A if test -f check-used-manpages/$$base_manpage; then \
17400N/A echo " "$$base_manpage >> /dev/null; \
17400N/A else \
17400N/A echo " "$$base_manpage >> unused-manpages.txt; \
17400N/A fi; \
17400N/A done
17400N/A @if test -f unused-manpages.txt; then \
17400N/A echo "Following Manpages are not being used in any SUNW package :"; \
17400N/A cat unused-manpages.txt; \
17400N/A rm -f unused-manpages.txt; \
17400N/A else \
17400N/A echo "All man pages are being used"; \
17400N/A fi
17400N/A @rm -rf check-all-manpages
17400N/A @rm -rf check-used-manpages
17400N/A
17400N/A%.check-used: %
17400N/A @for manpage in $($<); do \
17400N/A cp $$manpage check-used-manpages; \
17400N/A done
17400N/A
17400N/Acheck-version:
17400N/A @echo $(MANPAGE_VERSION)
17400N/A
17400N/Aclean:
17400N/A rm -rf $(MANPAGE_DIR)
17400N/A rm -rf $(TARBALL_DIR)/*.tar.gz
17400N/A