Makefile revision 15999
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg# Makefile for generateing man page tarballs that are used in each of the
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem# SUNW*.spec files
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic# e.g. sun-manpage-tarballs/*.tar.gz
4da61833a1cbbca94094f9653fd970582b97a72etrawick# "make" : Rebuilds all man page tarballs
4da61833a1cbbca94094f9653fd970582b97a72etrawick# "make check-used" : Outputs list of man pages not being used.
4789804be088bcd86ae637a29cdb7fda25169521jailletc# "make check-version" : Prints current man page tarball version
4789804be088bcd86ae637a29cdb7fda25169521jailletc# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
e50c3026198fd496f183cda4c32a202925476778covener# will only generate SUNWgnome-panel's man page tarball
e50c3026198fd496f183cda4c32a202925476778covener# For each package that contains man pages.
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin# - Ensure all relevant man pages for your package are located under the
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin# correct man page section dir i.e.
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic# - Add Package name to PACKAGES Variable
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic# e.g. PACKAGES = \
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic# SUNWgnome-panel \
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic# SUNWyour-package
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic# - Add two package specific variables
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic# PACKAGE_PAGES - Full path of all manpages for this package
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
69301145375a889e7e37caf7cc7321ac0f91801erpluem# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
69301145375a889e7e37caf7cc7321ac0f91801erpluem# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
506bfe33206b2fece40ef25f695af39dd4130facjkaluza# To Add new man pages to existing packages
506bfe33206b2fece40ef25f695af39dd4130facjkaluza# -----------------------------------------
506bfe33206b2fece40ef25f695af39dd4130facjkaluza# Put very simply, all that is required from engineers is to make some changes
d58a848a016d401b965111e50ef829e1641f7834minfrin# and commit in SVN.
d58a848a016d401b965111e50ef829e1641f7834minfrin# - Ensure the man page exists in SVN under the relevant man page section sub
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf# - Add man page to the SUNW<package>_PAGES Makefile variable
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf# e.g. For a new gnome-panel man page it would be added to
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic# SUNWgnome-panel_PAGES
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic# - Remake tarballs
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic# This will re-generate all man page tarballs.
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic# - Copy newly generated tarball from sun-manpage-tarballs to package build
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic# install correctly.
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic# - New man page tarball will be generated by RE for each nightly, and for each
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic# milestone build.
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic# - Commit change back to subverison, e.g. new/amended man pagees,
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic# branched. PLEASE do not change this.
4576c1a9ef54cd1e5555ee07d016a7f559f80338sfSUNWevolution-exchange.PAGES: $(SUNWevolution-exchange_PAGES)
584a85dd4047e38d3ed3a29b6662fcc9d100ae4csfSUNWevolution-data-server.PAGES: $(SUNWevolution-data-server_PAGES)
85eacfc96a04547ef25aabbc06440039715084c2jortonSUNWgnome-a11y-dasher.PAGES: $(SUNWgnome-a11y-dasher_PAGES)
536d2e7cd1fdec1255b8c3bdf41fdc714c506a54trawickSUNWgnome-a11y-gok.PAGES: $(SUNWgnome-a11y-gok_PAGES)
79c5787b92ac5f0e1cc82393816c77a006399316trawickSUNWgnome-a11y-libs.PAGES: $(SUNWgnome-a11y-libs_PAGES)
536e48c08d674acac5d44929318f2ad928edc361jortonSUNWgnome-a11y-mousetweaks.PAGES: $(SUNWgnome-a11y-mousetweaks_PAGES)
53e9b27aba029b18be814df40bcf6f0428771d1efuankgSUNWgnome-a11y-reader.PAGES: $(SUNWgnome-a11y-reader_PAGES)
e6dd71992459d05a676b98b7963423dc5dc1e24aminfrinSUNWgnome-a11y-speech.PAGES: $(SUNWgnome-a11y-speech_PAGES)
23f1535d6a60817d2846bac0aea230ea475d7dccminfrinSUNWgnome-a11y-poke.PAGES: $(SUNWgnome-a11y-poke_PAGES)
ec7520b24cd80d34d82bbcaca153cbb23cc04bc0rjungSUNWgnome-archive-mgr.PAGES: $(SUNWgnome-archive-mgr_PAGES)
SUNWjpg_PAGES = \
SUNWpng_PAGES = \
SUNWfsexam_PAGES = \
SUNWgamin_PAGES = \
SUNWliboil_PAGES = \
SUNWglibmm_PAGES = \
SUNWsigcpp_PAGES = \
SUNWgnutls_PAGES = \
SUNWgtkmm_PAGES = \
SUNWespeak_PAGES = \
SUNWw3m_PAGES = \
SUNWlibgsf_PAGES = \
SUNWdia_PAGES = \
SUNWdrivel_PAGES = \
SUNWbabl_PAGES = \
SUNWgegl_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)