Makefile revision 15999
e9458b1a7a19a63aa4c179f9ab20f4d50681c168Jens Elkner# Makefile for generateing man page tarballs that are used in each of the
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# SUNW*.spec files
98890889ffb2e8f6f722b00e265a211f13b5a861Corneliu-Claudiu Prodescu# Generates : $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# e.g. sun-manpage-tarballs/*.tar.gz
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# "make" : Rebuilds all man page tarballs
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# "make check-used" : Outputs list of man pages not being used.
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# "make check-version" : Prints current man page tarball version
4f4af799873e53cd4cef76775afa22fdf94b6780Christian Maeder# "make $(PACKAGE)-manpages-$(MANPAGE_VERSION).tar.gz
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# e.g. "make SUNWgnome-panel-manpages-0.1.tar.gz"
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# will only generate SUNWgnome-panel's man page tarball
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# For each package that contains man pages.
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# - Ensure all relevant man pages for your package are located under the
142fd5dd7fcfa170f08b2a0ab232859428f6e3c2Christian Maeder# correct man page section dir i.e.
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# entities/man1/man1m/man3/man3tiff/man4/man5
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# - Add Package name to PACKAGES Variable
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# e.g. PACKAGES = \
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# SUNWgnome-panel \
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# SUNWyour-package
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# - Add two package specific variables
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# PACKAGE_PAGES - Full path of all manpages for this package
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# e.g. SUNWgnome-panel_PAGES = man1/gnome-panel.1 etc...
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# PACKAGE.PAGES - Assigned to $(PACKAGE_PAGES).
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# e.g. SUNWgnome-panel.PAGES: $(SUNWgnome-panel_PAGES)
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# To Add new man pages to existing packages
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# -----------------------------------------
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# Put very simply, all that is required from engineers is to make some changes
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# and commit in SVN.
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# - Ensure the man page exists in SVN under the relevant man page section sub
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# - Add man page to the SUNW<package>_PAGES Makefile variable
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# e.g. For a new gnome-panel man page it would be added to
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# SUNWgnome-panel_PAGES
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# - Remake tarballs
602537decb7c714fbf6da6caa024ab3f10805276Christian Maeder# This will re-generate all man page tarballs.
602537decb7c714fbf6da6caa024ab3f10805276Christian Maeder# - Copy newly generated tarball from sun-manpage-tarballs to package build
91e80ba1d3d89546a6cc48153eef4a30d816c246Christian Maeder# sources e.g. /jds/packages/SOURCES, and ensure package builds and manpages
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# install correctly.
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# - New man page tarball will be generated by RE for each nightly, and for each
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# milestone build.
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# - Commit change back to subverison, e.g. new/amended man pagees,
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# Solaris/manpages/Makefile, Solaris/S*.spec files if affected.
7ab2df3001654dd1b7a2cfc3da1ccef11c39a503Christian Maeder# MANPAGE_VERSION is maintained by RE and only gets bumped when spec-files gets
09847a0124ff1662f6da56cd0ee08c3d539a025cDominik Luecke# branched. PLEASE do not change this.
SUNWgnome-print \
SUNWjpg \
SUNWpng \
SUNWw3m \
SUNWflac \
SUNWTiff_PAGES = \
SUNWcheese_PAGES = \
SUNWdbus_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)