Makefile revision 11850
bec154197d3d640b0d5b416cd5218ea58dca5d3aTinderbox User# Makefile for generateing man page tarballs that are used in each of the
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# SUNW*.spec files
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# e.g. sun-manpage-tarballs/*.tar.gz
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# "make" : Rebuilds all man page tarballs
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# "make check-used" : Outputs list of man pages not being used.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# "make check-version" : Prints current man page tarball version
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# e.g. "make SUNWgnome-panel-manpages-0.1.tar.gz"
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User# will only generate SUNWgnome-panel's man page tarball
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# For each package that contains man pages.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Ensure all relevant man pages for your package are located under the
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# correct man page section dir i.e.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Add Package name to PACKAGES Variable
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# e.g. PACKAGES = \
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater# SUNWgnome-panel \
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox User# SUNWyour-package
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Add two package specific variables
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# PACKAGE_PAGES - Full path of all manpages for this package
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# To Add new man pages to existing packages
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox User# -----------------------------------------
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# Put very simply, all that is required from engineers is to make some changes
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# and commit in SVN.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Ensure the man page exists in SVN under the relevant man page section sub
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Add man page to the SUNW<package>_PAGES Makefile variable
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# e.g. For a new gnome-panel man page it would be added to
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# SUNWgnome-panel_PAGES
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Remake tarballs
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# This will re-generate all man page tarballs.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - Copy newly generated tarball from sun-manpage-tarballs to package build
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
97e74139b19368e385a3564746d42db70879195eAutomatic Updater# install correctly.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# - New man page tarball will be generated by RE for each nightly, and for each
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# milestone build.
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox User# - Commit change back to subverison, e.g. new/amended man pagees,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews# branched. PLEASE do not change this.
52ece689e0265f9a3e518de5b2539e749f6d35acMark AndrewsSUNWevolution-exchange.PAGES: $(SUNWevolution-exchange_PAGES)
52ece689e0265f9a3e518de5b2539e749f6d35acMark AndrewsSUNWevolution-data-server.PAGES: $(SUNWevolution-data-server_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-a11y-gok.PAGES: $(SUNWgnome-a11y-gok_PAGES)
dba3c818ae00b10388d31703e86a28415db398acTinderbox UserSUNWgnome-a11y-libs.PAGES: $(SUNWgnome-a11y-libs_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-a11y-reader.PAGES: $(SUNWgnome-a11y-reader_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-a11y-poke.PAGES: $(SUNWgnome-a11y-poke_PAGES)
6283056805887de88040698685b8e1936a1f7a2dAutomatic UpdaterSUNWgnome-archive-mgr.PAGES: $(SUNWgnome-archive-mgr_PAGES)
7717ec7a6a898cdd3c35cbfba66010b7304ffd9bAutomatic UpdaterSUNWgnome-audio.PAGES: $(SUNWgnome-audio_PAGES)
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic UpdaterSUNWgnome-base-libs.PAGES: $(SUNWgnome-base-libs_PAGES)
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic UpdaterSUNWgnome-base-libs-java.PAGES: $(SUNWgnome-base-libs-java_PAGES)
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic UpdaterSUNWgnome-calculator.PAGES: $(SUNWgnome-calculator_PAGES)
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic UpdaterSUNWgnome-cd-burner.PAGES: $(SUNWgnome-cd-burner_PAGES)
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic UpdaterSUNWgnome-character-map.PAGES: $(SUNWgnome-character-map_PAGES)
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic UpdaterSUNWgnome-common-devel.PAGES: $(SUNWgnome-common-devel_PAGES)
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic UpdaterSUNWgnome-component.PAGES: $(SUNWgnome-component_PAGES)
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic UpdaterSUNWgnome-config-editor.PAGES: $(SUNWgnome-config-editor_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-config.PAGES: $(SUNWgnome-config_PAGES)
f3d1a0ba5228251d902a6acf3c8b05cb6842f992Automatic UpdaterSUNWgnome-crash-report.PAGES: $(SUNWgnome-crash-report_PAGES)
f3d1a0ba5228251d902a6acf3c8b05cb6842f992Automatic Updater man1/gnome-accessibility-keyboard-properties.1 \
8de0d8a6905e397ed0a26054815420685f9b435eAutomatic UpdaterSUNWgnome-desktop-prefs.PAGES: $(SUNWgnome-desktop-prefs_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-dialog.PAGES: $(SUNWgnome-dialog_PAGES)
66fec05962ae85e63c4aa568d44a962db5bbc902Automatic UpdaterSUNWgnome-display-mgr.PAGES: $(SUNWgnome-display-mgr_PAGES)
f3d1a0ba5228251d902a6acf3c8b05cb6842f992Automatic Updater man1/nautilus-file-management-properties.1
f3d1a0ba5228251d902a6acf3c8b05cb6842f992Automatic UpdaterSUNWgnome-file-mgr.PAGES: $(SUNWgnome-file-mgr_PAGES)
f3d1a0ba5228251d902a6acf3c8b05cb6842f992Automatic UpdaterSUNWgnome-gtksourceview.PAGES: $(SUNWgnome-gtksourceview_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-help-viewer.PAGES: $(SUNWgnome-help-viewer_PAGES)
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark AndrewsSUNWgnome-hex-editor.PAGES: $(SUNWgnome-hex-editor_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-im-client.PAGES: $(SUNWgnome-im-client_PAGES)
c986916269e0d9ca0a31efb62ff5ac06938815dbTinderbox UserSUNWgnome-meeting.PAGES: $(SUNWgnome-meeting_PAGES)
3b2c6af63e0367c6eabe0a21ca23841ca87cd22fAutomatic UpdaterSUNWgnome-img-viewer.PAGES: $(SUNWgnome-img-viewer_PAGES)
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews man1/scrollkeeper-get-extended-content-list.1 \
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-media-apps.PAGES: $(SUNWgnome-media-apps_PAGES)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsSUNWgnome-media-player.PAGES: $(SUNWgnome-media-player_PAGES)
c3dc968140ab7f04795acc7835e4e89ccb0c0a27Tinderbox UserSUNWgnome-menu-editor.PAGES: $(SUNWgnome-menu-editor_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)