Makefile revision 20870
5cd4555ad444fd391002ae32450572054369fd42Rob Austein# Makefile for generateing man page tarballs that are used in each of the
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# SUNW*.spec files
a9f68291c8db8111b88442635a04dfd35221411bAutomatic Updater# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews# e.g. sun-manpage-tarballs/*.tar.gz
9c49c394b4218cc9c743a372a8fcfb787f5ea8caAndreas Gustafsson# "make" : Rebuilds all man page tarballs
9c49c394b4218cc9c743a372a8fcfb787f5ea8caAndreas Gustafsson# "make check-used" : Outputs list of man pages not being used.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews# "make check-version" : Prints current man page tarball version
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews# e.g. "make SUNWgnome-panel-manpages-0.1.tar.gz"
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews# will only generate SUNWgnome-panel's man page tarball
9c49c394b4218cc9c743a372a8fcfb787f5ea8caAndreas Gustafsson# For each package that contains man pages.
f5d30e2864e048a42c4dc1134993ae7efdb5d6c3Mark Andrews# - Ensure all relevant man pages for your package are located under the
a9f68291c8db8111b88442635a04dfd35221411bAutomatic Updater# correct man page section dir i.e.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# - Add Package name to PACKAGES Variable
de10c46b2a714b0fb74837da7867f55cccc6d261Jeremy Reed# e.g. PACKAGES = \
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# SUNWgnome-panel \
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# SUNWyour-package
a8f6b2aa46f882c7c680b7bdab1dfb78a76787eaMark Andrews# - Add two package specific variables
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# PACKAGE_PAGES - Full path of all manpages for this package
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
072440df4f65033eb058c06f2cc72be450606720Jeremy Reed# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# To Add new man pages to existing packages
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# -----------------------------------------
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Put very simply, all that is required from engineers is to make some changes
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# and commit in SVN.
26e2a07a0b6a3b1eccef82ba31270d0c54ad4f06Mark Andrews# - Ensure the man page exists in SVN under the relevant man page section sub
030aac3dbc57f99bad1d251b0783890ff0369952Automatic Updater# - Add man page to the SUNW<package>_PAGES Makefile variable
d60212e03fbef1d3dd7f7eb05c0545cc373cb9fcAutomatic Updater# e.g. For a new gnome-panel man page it would be added to
1b892cf691dd0907e0e75774df102dd4d92dd877Automatic Updater# SUNWgnome-panel_PAGES
a9f68291c8db8111b88442635a04dfd35221411bAutomatic Updater# - Remake tarballs
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# This will re-generate all man page tarballs.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# - Copy newly generated tarball from sun-manpage-tarballs to package build
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# install correctly.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# - New man page tarball will be generated by RE for each nightly, and for each
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# milestone build.
f5d30e2864e048a42c4dc1134993ae7efdb5d6c3Mark Andrews# - Commit change back to subverison, e.g. new/amended man pagees,
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# branched. PLEASE do not change this.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWevolution-libs.PAGES: $(SUNWevolution-libs_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWevolution-exchange.PAGES: $(SUNWevolution-exchange_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWevolution-data-server.PAGES: $(SUNWevolution-data-server_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWevolution-webcal.PAGES: $(SUNWevolution-webcal_PAGES)
21d493fc392d472086ad3c7c4563b7cadcb06788Mark AndrewsSUNWgnome-a11y-dasher.PAGES: $(SUNWgnome-a11y-dasher_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-a11y-libs.PAGES: $(SUNWgnome-a11y-libs_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-a11y-mousetweaks.PAGES: $(SUNWgnome-a11y-mousetweaks_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-a11y-reader.PAGES: $(SUNWgnome-a11y-reader_PAGES)
bf9b852c3eaf2c9847f926751b57a06f1ae3d72aEvan HuntSUNWgnome-a11y-speech.PAGES: $(SUNWgnome-a11y-speech_PAGES)
bf9b852c3eaf2c9847f926751b57a06f1ae3d72aEvan HuntSUNWgnome-a11y-poke.PAGES: $(SUNWgnome-a11y-poke_PAGES)
bf9b852c3eaf2c9847f926751b57a06f1ae3d72aEvan HuntSUNWgnome-archive-mgr.PAGES: $(SUNWgnome-archive-mgr_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWlibgnomecanvas.PAGES: $(SUNWlibgnomecanvas_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-base-libs-java.PAGES: $(SUNWgnome-base-libs-java_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-calculator.PAGES: $(SUNWgnome-calculator_PAGES)
8d709e3ee443222cd35e44eadc9a4c0a8d92fec2Rob AusteinSUNWgnome-character-map.PAGES: $(SUNWgnome-character-map_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-common-devel.PAGES: $(SUNWgnome-common-devel_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-component.PAGES: $(SUNWgnome-component_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-config-editor.PAGES: $(SUNWgnome-config-editor_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-config.PAGES: $(SUNWgnome-config_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-crash-report.PAGES: $(SUNWgnome-crash-report_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-desktop-prefs.PAGES: $(SUNWgnome-desktop-prefs_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-dialog.PAGES: $(SUNWgnome-dialog_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-display-mgr.PAGES: $(SUNWgnome-display-mgr_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-file-mgr.PAGES: $(SUNWgnome-file-mgr_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-gtksourceview.PAGES: $(SUNWgnome-gtksourceview_PAGES)
8d709e3ee443222cd35e44eadc9a4c0a8d92fec2Rob AusteinSUNWgnome-help-viewer.PAGES: $(SUNWgnome-help-viewer_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-im-client.PAGES: $(SUNWgnome-im-client_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-meeting.PAGES: $(SUNWgnome-meeting_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-img-viewer.PAGES: $(SUNWgnome-img-viewer_PAGES)
21d493fc392d472086ad3c7c4563b7cadcb06788Mark Andrews man1/scrollkeeper-get-extended-content-list.1 \
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-media-player.PAGES: $(SUNWgnome-media-player_PAGES)
9c49c394b4218cc9c743a372a8fcfb787f5ea8caAndreas GustafssonSUNWgnome-media.PAGES: $(SUNWgnome-media_PAGES)
9c49c394b4218cc9c743a372a8fcfb787f5ea8caAndreas GustafssonSUNWgnome-menu-editor.PAGES: $(SUNWgnome-menu-editor_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-pdf-viewer.PAGES: $(SUNWgnome-pdf-viewer_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-removable-media.PAGES: $(SUNWgnome-removable-media_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-remote-desktop.PAGES: $(SUNWgnome-remote-desktop_PAGES)
351b62535d4c4f89883bfdba025999dd32490266Evan HuntSUNWgnome-session.PAGES: $(SUNWgnome-session_PAGES)
351b62535d4c4f89883bfdba025999dd32490266Evan HuntSUNWgnome-system-tools.PAGES: $(SUNWgnome-system-tools_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-system-monitor.PAGES: $(SUNWgnome-system-monitor_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-terminal.PAGES: $(SUNWgnome-terminal_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-text-editor.PAGES: $(SUNWgnome-text-editor_PAGES)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinSUNWgnome-ui-designer.PAGES: $(SUNWgnome-ui-designer_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 = \
SUNWavant_PAGES = \
SUNWgftp_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)