Makefile revision 11933
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater# Makefile for generateing man page tarballs that are used in each of the
18920d790825d96ca3943aa2dcb6eb80dc611c5fTinderbox User# SUNW*.spec files
ab496cc3df1648e9ad992a87c35c2c0870fdc69dTinderbox User# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
7c1468ed500356839a4a222517364e6ce18cb1a2Tinderbox User# e.g. sun-manpage-tarballs/*.tar.gz
1f4c645185bd8fc70048e0a69eee46193a284e5cTinderbox User# "make" : Rebuilds all man page tarballs
8de3f14f1c300c3e1ed99084cc03485b42c92bf1Tinderbox User# "make check-used" : Outputs list of man pages not being used.
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User# "make check-version" : Prints current man page tarball version
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews# e.g. "make SUNWgnome-panel-manpages-0.1.tar.gz"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews# will only generate SUNWgnome-panel's man page tarball
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews# For each package that contains man pages.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews# - Ensure all relevant man pages for your package are located under the
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews# correct man page section dir i.e.
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews# - Add Package name to PACKAGES Variable
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews# e.g. PACKAGES = \
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User# SUNWgnome-panel \
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews# SUNWyour-package
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews# - Add two package specific variables
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User# PACKAGE_PAGES - Full path of all manpages for this package
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrews# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews# To Add new man pages to existing packages
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User# -----------------------------------------
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews# Put very simply, all that is required from engineers is to make some changes
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User# and commit in SVN.
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User# - Ensure the man page exists in SVN under the relevant man page section sub
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox User# - Add man page to the SUNW<package>_PAGES Makefile variable
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews# e.g. For a new gnome-panel man page it would be added to
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt# SUNWgnome-panel_PAGES
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User# - Remake tarballs
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt# This will re-generate all man page tarballs.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater# - Copy newly generated tarball from sun-manpage-tarballs to package build
16f6050f29b6b0422cee858e609f65e474e70ef2Tinderbox User# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater# install correctly.
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt# - New man page tarball will be generated by RE for each nightly, and for each
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User# milestone build.
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox User# - Commit change back to subverison, e.g. new/amended man pagees,
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater# branched. PLEASE do not change this.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterSUNWevolution-exchange.PAGES: $(SUNWevolution-exchange_PAGES)
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsSUNWevolution-data-server.PAGES: $(SUNWevolution-data-server_PAGES)
bf5e2127e92e52cbf661e77dd6a76e5aef43542fTinderbox UserSUNWgnome-a11y-dasher.PAGES: $(SUNWgnome-a11y-dasher_PAGES)
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserSUNWgnome-a11y-gok.PAGES: $(SUNWgnome-a11y-gok_PAGES)
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserSUNWgnome-a11y-libs.PAGES: $(SUNWgnome-a11y-libs_PAGES)
91216cff91b34c9ff6e846dc23f248219cafe660Andreas GustafssonSUNWgnome-a11y-reader.PAGES: $(SUNWgnome-a11y-reader_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-a11y-poke.PAGES: $(SUNWgnome-a11y-poke_PAGES)
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserSUNWgnome-archive-mgr.PAGES: $(SUNWgnome-archive-mgr_PAGES)
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserSUNWgnome-audio.PAGES: $(SUNWgnome-audio_PAGES)
e8fc8c884b44371784805e1e0d3100da403dd3f1Automatic UpdaterSUNWgnome-base-libs.PAGES: $(SUNWgnome-base-libs_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-base-libs-java.PAGES: $(SUNWgnome-base-libs-java_PAGES)
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsSUNWgnome-calculator.PAGES: $(SUNWgnome-calculator_PAGES)
c5a97a549c89d562e999d4f906b882c5a2a474e1Tinderbox UserSUNWgnome-cd-burner.PAGES: $(SUNWgnome-cd-burner_PAGES)
59528addd704f8d5757b54e540520f74e588a7c7Automatic UpdaterSUNWgnome-character-map.PAGES: $(SUNWgnome-character-map_PAGES)
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterSUNWgnome-common-devel.PAGES: $(SUNWgnome-common-devel_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-component.PAGES: $(SUNWgnome-component_PAGES)
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsSUNWgnome-config-editor.PAGES: $(SUNWgnome-config-editor_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-config.PAGES: $(SUNWgnome-config_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-crash-report.PAGES: $(SUNWgnome-crash-report_PAGES)
a5636b773fa05a272b6876afd99309c0b3090e2fMark Andrews man1/gnome-accessibility-keyboard-properties.1 \
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-desktop-prefs.PAGES: $(SUNWgnome-desktop-prefs_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-dialog.PAGES: $(SUNWgnome-dialog_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-display-mgr.PAGES: $(SUNWgnome-display-mgr_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-file-mgr.PAGES: $(SUNWgnome-file-mgr_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-gtksourceview.PAGES: $(SUNWgnome-gtksourceview_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-help-viewer.PAGES: $(SUNWgnome-help-viewer_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-hex-editor.PAGES: $(SUNWgnome-hex-editor_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-im-client.PAGES: $(SUNWgnome-im-client_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-meeting.PAGES: $(SUNWgnome-meeting_PAGES)
ae7e54b14c946e0984c191554db9abb4893f9349Automatic UpdaterSUNWgnome-img-viewer.PAGES: $(SUNWgnome-img-viewer_PAGES)
ae7e54b14c946e0984c191554db9abb4893f9349Automatic Updater man1/scrollkeeper-get-extended-content-list.1 \
ae7e54b14c946e0984c191554db9abb4893f9349Automatic Updater man1/scrollkeeper-get-index-from-docpath.1 \
ae7e54b14c946e0984c191554db9abb4893f9349Automatic Updater man1/scrollkeeper-get-toc-from-docpath.1 \
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsSUNWgnome-media-apps.PAGES: $(SUNWgnome-media-apps_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-media-player.PAGES: $(SUNWgnome-media-player_PAGES)
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserSUNWgnome-menu-editor.PAGES: $(SUNWgnome-menu-editor_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-pdf-viewer.PAGES: $(SUNWgnome-pdf-viewer_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-pilot.PAGES: $(SUNWgnome-pilot_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-print.PAGES: $(SUNWgnome-print_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-removable-media.PAGES: $(SUNWgnome-removable-media_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-remote-desktop.PAGES: $(SUNWgnome-remote-desktop_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-session.PAGES: $(SUNWgnome-session_PAGES)
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterSUNWgnome-sys-suspend.PAGES: $(SUNWgnome-sys-suspend_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-system-tools.PAGES: $(SUNWgnome-system-tools_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-system-monitor.PAGES: $(SUNWgnome-system-monitor_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-terminal.PAGES: $(SUNWgnome-terminal_PAGES)
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark AndrewsSUNWgnome-text-editor.PAGES: $(SUNWgnome-text-editor_PAGES)
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserSUNWgnome-ui-designer.PAGES: $(SUNWgnome-ui-designer_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWgnome-utils.PAGES: $(SUNWgnome-utils_PAGES)
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterSUNWgnome-vfs.PAGES: $(SUNWgnome-vfs_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWrealplayer.PAGES: $(SUNWrealplayer_PAGES)
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonSUNWthunderbird.PAGES: $(SUNWthunderbird_PAGES)
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsSUNWgnome-devhelp.PAGES: $(SUNWgnome-devhelp_PAGES)
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserSUNWprint-monitor.PAGES: $(SUNWprint-monitor_PAGES)
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews.SUFFIXES: -manpages-$(MANPAGE_VERSION).tar.gz .PAGES
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsTARBALLS = $(TARBALL_DIR)/$(addsuffix -$(MANPAGE_VERSION).tar.bz2, $(PACKAGES))
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews @test -d $(TARBALL_DIR) || mkdir -p "$(TARBALL_DIR)"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews @test -x $(SGML2ROFF) || echo "sgml2roff utility not found"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater @test -x $(GZIP) || echo "gzip utility not found"
da59e63e7af147a8bcef985b98b04443e04c3a0eTinderbox User $(MAKE) MAKE=\"$(MAKE)\" $$package-manpages-$(MANPAGE_VERSION).tar.gz; \
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews @test -d $(TARBALL_DIR) || mkdir -p "$(TARBALL_DIR)"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews @if test -f $(TARBALL_DIR)/$@; then \
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews @test -d $(MANPAGE_DIR) || mkdir -p "$(MANPAGE_DIR)"
1fdd58445074579ee3b65c871137a7a1740eb542Mark Andrews @echo "Converting manpages for $@"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User @for manpage in $($(subst .PAGES,_PAGES,$<)); do \
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User suffix=`expr "$$base_manpage" : '.*\.\([^./]*\)$'`; \
3040b455151b1e1173193933664b2891b6159f24Mark Andrews $(SGML2ROFF) $$manpage > $(MANPAGE_DIR)/$$base_manpage; \
f33f2b8afe60de897c53cdcb17911f10b552699fTinderbox User echo $$base_manpage >> $(MANPAGE_DIR)/$$suffix; \
532d27b39244fadfcf8d8b4593f4c65434c9c664Automatic Updater @cp Makefile.template $(MANPAGE_DIR)/Makefile
532d27b39244fadfcf8d8b4593f4c65434c9c664Automatic Updater mv $(MANPAGE_DIR)/ent $(MANPAGE_DIR)/entities; \
1a63fb1d1448ed3f8fd7227ae57be67c2e71279eMark Andrews @for mantype in entities 1 1m 3 3tiff 4 5; do \
9e898948ed76bf5f175bf178866c90c449843c3eTinderbox User echo "MAN"$$mantype"PAGES = \\" >> $(MANPAGE_DIR)/Makefile; \
10702d681eb650391bcaa0e2704aa3cf2dbf0e98Mark Andrews if (length(saved_page) > 0) \
10702d681eb650391bcaa0e2704aa3cf2dbf0e98Mark Andrews print " " saved_page " \\"; \
10702d681eb650391bcaa0e2704aa3cf2dbf0e98Mark Andrews saved_page=$$0; \
10702d681eb650391bcaa0e2704aa3cf2dbf0e98Mark Andrews print " " saved_page; \
10702d681eb650391bcaa0e2704aa3cf2dbf0e98Mark Andrews }' $(MANPAGE_DIR)/$$mantype >> $(MANPAGE_DIR)/Makefile; \
93089a352d6903b0d7845a039de4ec2df9a0e35aTinderbox User @for mantype in entities 1 1m 3 3tiff 4 5; do \
93089a352d6903b0d7845a039de4ec2df9a0e35aTinderbox User echo " install -d $$(DESTDIR)$$(MAN"$$mantype"DIR)" >> $(MANPAGE_DIR)/Makefile; \
861836e5f5df62bfaea9ad8923a05278d5ab2f3dTinderbox User echo " for mp in $$(MAN"$$mantype"PAGES); do \\" >> $(MANPAGE_DIR)/Makefile; \
e8c17c74535be290abaaa160a434ed80bf0ad2feMark Andrews echo " install --mode=0644 \$$\$$mp $$(DESTDIR)$$(MAN"$$mantype"DIR); \\" >> $(MANPAGE_DIR)/Makefile; \
665ba746c0585088d0c314dcfc4671aa2c7b2dc1Automatic Updater @tarball=`basename "$@" .gz`; echo "Making tarball $$tarball"; \
9e898948ed76bf5f175bf178866c90c449843c3eTinderbox User $(TAR) -cf $(TARBALL_DIR)/$$tarball $(MANPAGE_DIR); \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater @test -d check-used-manpages || mkdir -p "check-used-manpages"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater @test -d check-all-manpages || mkdir -p "check-all-manpages"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater $(MAKE) MAKE=\"$(MAKE)\" $$package.check-used; \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater @all_manpages=`ls check-all-manpages/*`; \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater if test -f check-used-manpages/$$base_manpage; then \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater echo " "$$base_manpage >> unused-manpages.txt; \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater @if test -f unused-manpages.txt; then \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater echo "Following Manpages are not being used in any SUNW package :"; \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater echo "All man pages are being used"; \
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater @for manpage in $($(subst .PAGES,_PAGES,$<)); do \