X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2FMakefile.am;h=b1dd55efde0cb28997beaa5170c9c3faa7fcbf0d;hb=fd48f3e498442f0cbff5f3606c7c403d0566150e;hp=539b21982e84a4413f394c9f98e406787fc9edb3;hpb=3ab887b9bc819a846c75dd7f2ee5d41fac22b19f;p=debian%2Famanda diff --git a/man/Makefile.am b/man/Makefile.am index 539b219..b1dd55e 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -1,58 +1,165 @@ # Makefile for amanda man-pages +.SECONDARY: + transform = s,x,x,; -if WANT_AMPLOT -AMPLOT_MAN_PAGES = amplot.8 -endif +AMPLOT_MAN_PAGES = amplot.8 -COMMON_MAN_PAGES = amanda.8 +COMMON_MAN_PAGES = amanda.8 \ + amanda.conf.5 \ + amanda-client.conf.5 \ + amanda-scripts.7 \ + amanda-archive-format.5 \ + amanda-auth.7 \ + amarchiver.8 \ + script-email.8 -if WANT_SERVER -SERVER_MAN_PAGES = amadmin.8 \ - amcheck.8 \ - amcheckdb.8 \ - amcleanup.8 \ - amdd.8 \ - amdump.8 \ - amflush.8 \ - amgetconf.8 \ - amlabel.8 \ - ammt.8 \ - amoverview.8 \ - amreport.8 \ - amrmtape.8 \ - amstatus.8 \ - amtape.8 \ - amtapetype.8 \ - amtoc.8 \ - amverify.8 \ - amverifyrun.8 -endif +CLIENT_MAN_PAGES = \ + amanda-applications.7 \ + amgtar.8 \ + ampgsql.8 \ + amraw.8 \ + amsamba.8 \ + amstar.8 \ + amsuntar.8 \ + amzfs-snapshot.8 \ + amzfs-sendrecv.8 -if WANT_RECOVER -RECOVER_MAN_PAGES = amrecover.8 -endif +SERVER_MAN_PAGES = \ + amanda-devices.7 \ + amanda-compatibility.7 \ + amanda-changers.7 \ + amanda-taperscan.7 \ + amaddclient.8 \ + amadmin.8 \ + amaespipe.8 \ + amcheck.8 \ + amcheckdb.8 \ + amcheckdump.8 \ + amcleanup.8 \ + amcrypt-ossl-asym.8 \ + amcrypt-ossl.8 \ + amcrypt.8 \ + amcryptsimple.8 \ + amdevcheck.8 \ + amdump.8 \ + amflush.8 \ + amgetconf.8 \ + amgpgcrypt.8 \ + amlabel.8 \ + amoverview.8 \ + amreport.8 \ + amrmtape.8 \ + amserverconfig.8 \ + amservice.8 \ + amstatus.8 \ + amtape.8 \ + amtapetype.8 \ + amtoc.8 \ + amvault.8 \ + disklist.5 \ + tapelist.5 -if WANT_RESTORE -RESTORE_MAN_PAGES = amrestore.8 -endif +RECOVER_MAN_PAGES = amrecover.8 -# not autoconf-generated: -EXTRA_DIST = amplot.8 amrestore.8 amtape.8 amdd.8 ammt.8 +RESTORE_MAN_PAGES = amrestore.8 \ + amfetchdump.8 -man_MANS = $(AMPLOT_MAN_PAGES) \ +ALL_MAN_PAGES = $(AMPLOT_MAN_PAGES) \ + $(CLIENT_MAN_PAGES) \ $(COMMON_MAN_PAGES) \ $(SERVER_MAN_PAGES) \ $(RECOVER_MAN_PAGES) \ $(RESTORE_MAN_PAGES) -install-data-hook: - @list="$(man_MANS)"; \ - for p in $$list; do \ - pa=$(DESTDIR)$(mandir)/man8/`echo $$p|sed '$(transform)'`; \ - echo chown $(BINARY_OWNER) $$pa; \ - chown $(BINARY_OWNER) $$pa; \ - echo chgrp $(SETUID_GROUP) $$pa; \ - chgrp $(SETUID_GROUP) $$pa; \ +WANTED_MAN_PAGES = $(COMMON_MAN_PAGES) +if WANT_AMPLOT + WANTED_MAN_PAGES += $(AMPLOT_MAN_PAGES) +endif +if WANT_CLIENT + WANTED_MAN_PAGES += $(CLIENT_MAN_PAGES) +endif +if WANT_SERVER + WANTED_MAN_PAGES += $(SERVER_MAN_PAGES) +endif +if WANT_RECOVER + WANTED_MAN_PAGES += $(RECOVER_MAN_PAGES) +endif +if WANT_RESTORE + WANTED_MAN_PAGES += $(RESTORE_MAN_PAGES) +endif + +SRCMANPAGEDIR = $(srcdir)/xml-source + +MAN_XML = $(ALL_MAN_PAGES:%=xml-source/%.xml) + +EXTRA_XML = xslt/expand-sambadoc.xsl \ + xslt/man.xsl.in \ + xslt/html.xsl.in \ + xslt/settings.xsl \ + entities/global.entities.in \ + entities/xinclude.dtd + +EXTRA_DIST = $(ALL_MAN_PAGES) $(MAN_XML) $(EXTRA_HTML) $(EXTRA_XML) + +GEN_XML = $(ALL_MAN_PAGES:%=xml-source/%.proc.xml) + +MOSTLYCLEANFILES = $(GEN_XML) +MAINTAINERCLEANFILES = $(ALL_MAN_PAGES) + +# some of the XSL needs to know what docbook-xsl version we've selected +%.xsl: %.xsl.in $(top_builddir)/config.status + $(top_builddir)/config.status --file=$@:$< + rm -f config.log + +entities/global.entities: entities/global.entities.in $(top_builddir)/config.status + $(top_builddir)/config.status --file=$@:$< + rm -f config.log + +if ENABLE_MANPAGE_BUILD +# phase one of the documentation build expands some macros. +xml-source/%.proc.xml: $(SRCMANPAGEDIR)/%.xml $(srcdir)/xslt/expand-sambadoc.xsl entities/global.entities + $(XSLTPROC) $(XSLTPROC_FLAGS) --path "$(srcdir)/xslt/:$(builddir)/entities/" --xinclude --stringparam latex.imagebasedir "$*/" --stringparam noreference 1 --output $@ $(srcdir)/xslt/expand-sambadoc.xsl $< + +# phase two generates a manpage from the resulting "expanded" docbook XML +%: xml-source/%.proc.xml $(srcdir)/xslt/man.xsl entities/global.entities + $(XSLTPROC) $(XSLTPROC_FLAGS) --path "$(srcdir)/xslt/:$(builddir)/entities/" --output $@ xslt/man.xsl $< + +%.html: xml-source/%.proc.xml $(srcdir)/xslt/html.xsl entities/global.entities + $(XSLTPROC) $(XSLTPROC_FLAGS) --path "$(srcdir)/xslt/:$(builddir)/entities/" --output $@ xslt/html.xsl $< + +else !ENABLE_MANPAGE_BUILD + +%: $(SRCMANPAGEDIR)/%.xml + @echo WARNING: Not building needed $@ because building manpages is disabled. + @echo 'DUMMY' > $@ + +# (no rule to build HTML without ENABLE_MANPAGE_BUILD) + +endif + +## +## HTML Generation +## + +EXTRA_DIST += \ + index.php \ + amanda.css + +ALL_MAN_HTMLS = $(ALL_MAN_PAGES:%=%.html) + +# toplevel rule to build HTML manpages and tar them up +html: amanda.css index.php $(ALL_MAN_HTMLS) + tar -zcf html.tar.gz $(ALL_MAN_HTMLS) amanda.css index.php + +# double-check that we don't ship dummy manpages +dist-hook: + for f in $(WANTED_MAN_PAGES); do \ + if sed -e 1q $(distdir)/$$f | $(GREP) '^DUMMY$$' >/dev/null 2>/dev/null; then \ + echo "$(distdir)/$$f is a dummy manpage; cannot create distribution"; \ + exit 1; \ + fi; \ done + +man_MANS = $(WANTED_MAN_PAGES)