From 9d12a82009f5cf8df99a2d6fbc32a5b4dc5fd84f Mon Sep 17 00:00:00 2001 From: Roger Leigh Date: Fri, 14 Jul 2006 10:06:46 +0000 Subject: * HACKING: Document how to build the printed documentation. * Makefile.am: Add ps and pdf phony targets. * doc/Makefile.am: Add rules to make PS and PDF manuals. --- ChangeLog | 8 ++++++++ HACKING | 5 +++-- Makefile.am | 8 ++++++++ doc/Makefile.am | 19 +++++++++++++++++-- 4 files changed, 36 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 745d3157..ef57006d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2006-07-14 Roger Leigh + + * HACKING: Document how to build the printed documentation. + + * Makefile.am: Add ps and pdf phony targets. + + * doc/Makefile.am: Add rules to make PS and PDF manuals. + 2006-07-14 Roger Leigh * Update all documentation to use the style guidelines. diff --git a/HACKING b/HACKING index 419d166f..fa27934e 100644 --- a/HACKING +++ b/HACKING @@ -10,7 +10,9 @@ Documentation All the documentation is in UNIX manual page format. GNU roff extensions are permitted, as is use of tbl. Make sure the printed -output is as good as terminal display. +output is as good as terminal display. Run "make ps" or "make pdf" to +build the printed documentation. + The following styles are used: @@ -28,4 +30,3 @@ The following styles are used: Cross references Italics in double quotes \[lq]\fI...\fP\[rq] Verbatim examples Courier \f[CR] Verbatim user input Courier bold \f[CB] - diff --git a/Makefile.am b/Makefile.am index 92d00b0e..b89e2e8a 100644 --- a/Makefile.am +++ b/Makefile.am @@ -36,3 +36,11 @@ EXTRA_DIST = \ scripts/schroot_release.m4.in \ m4 \ HACKING + +ps: + $(MAKE) -C doc schroot.ps + +pdf: + $(MAKE) -C doc schroot.pdf + +.PHONY: ps pdf \ No newline at end of file diff --git a/doc/Makefile.am b/doc/Makefile.am index 0394703d..10cc336a 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -37,8 +37,23 @@ schroot-stamp: schroot.dox $(top_srcdir)/configure $(DOXYGEN) schroot.dox touch $@ -CLEANFILES = \ - schroot.log +PS_DEPS = \ + $(top_builddir)/schroot/schroot.1 \ + $(top_builddir)/schroot/schroot.conf.5 \ + $(top_builddir)/schroot/schroot-setup.5 \ + $(top_builddir)/dchroot/dchroot.1 \ + $(top_builddir)/dchroot-dsa/dchroot-dsa.1 + +schroot.ps: $(PS_DEPS) + tbl $(PS_DEPS) | groff -T ps -man > $@ + +schroot.pdf: schroot.ps + ps2pdf $< $@ + +CLEANFILES = \ + schroot.log \ + schroot.ps \ + schroot.pdf maintainer-clean-local: $(RM) -r schroot -- cgit v1.2.3