Add remake --task documentation

This commit is contained in:
R. Bernstein
2011-10-20 06:39:18 -04:00
parent 34dc6a0973
commit 273ce72a98
3 changed files with 11 additions and 5 deletions

View File

@@ -1,6 +1,5 @@
# $Id: Makefile.am,v 1.50 2008/10/25 13:56:15 rocky Exp $ # Copyright (C) 2003, 2004, 2006, 2008, 2011
# # Rocky Bernstein <rocky@gnu.org>
# Copyright (C) 2003, 2004, 2006, 2008 Rocky Bernstein <rocky@gnu.org>
# #
# This program is free software: you can redistribute it and/or modify # This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by # it under the terms of the GNU General Public License as published by
@@ -72,8 +71,10 @@ REGRESSION_VERSION = 1.1
distdir_regression = ../$(PACKAGE)-$(REGRESSION_VERSION)-tests distdir_regression = ../$(PACKAGE)-$(REGRESSION_VERSION)-tests
#: run regression tests
test: check test: check
#: Make documentation via Doxygen http://www.stack.nl/~dimitri/doxygen/
doxygen: doxygen:
-( cd ${top_srcdir}/doc/doxygen && /bin/sh ${srcdir}/run_doxygen ) -( cd ${top_srcdir}/doc/doxygen && /bin/sh ${srcdir}/run_doxygen )
@@ -121,14 +122,13 @@ check_iso.sh: $(top_builddir)/config.status check_iso.sh.in
cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
chmod +x config_iso.sh chmod +x config_iso.sh
make-executable:
# cvs2cl # cvs2cl
MAINTAINERCLEANFILES = ChangeLog *.rej *.orig MAINTAINERCLEANFILES = ChangeLog *.rej *.orig
if MAINTAINER_MODE if MAINTAINER_MODE
.PHONY: ChangeLog .PHONY: ChangeLog
#: Create ChangeLog from version control
ChangeLog: ChangeLog:
git log --pretty --numstat --summary | $(GIT2CL) >$@ git log --pretty --numstat --summary | $(GIT2CL) >$@

View File

@@ -19,12 +19,16 @@ libcdio_TEXINFOS = fdl.texi glossary.texi
reference: reference:
-( cd ${top_srcdir} && $(MAKE) doxygen ) -( cd ${top_srcdir} && $(MAKE) doxygen )
#: Create documentation in PDF format
pdf: libcdio.pdf pdf: libcdio.pdf
#: Create documentation as a text file
txt: libcdio.txt txt: libcdio.txt
#: Create documentation in PostScript format
ps: libcdio.ps ps: libcdio.ps
#: Create documentation in HTML format
html: libcdio.html html: libcdio.html
%.ps.gz: %.ps %.ps.gz: %.ps
@@ -39,6 +43,7 @@ html: libcdio.html
.texi.txt: .texi.txt:
makeinfo --no-headers $< > $@ makeinfo --no-headers $< > $@
# Create documentation in all formats, e.g. PDF, DVI, plain text and HTML
all-formats: pdf dvi txt ps html all-formats: pdf dvi txt ps html
MOSTLYCLEANFILES = libcdio.html libcdio.pdf libcdio.ps.gz MOSTLYCLEANFILES = libcdio.html libcdio.pdf libcdio.ps.gz

View File

@@ -45,6 +45,7 @@ INCLUDES = -I$(top_srcdir) $(LIBCDIO_CFLAGS)
cd-paranoia.$(OBJEXT): usage.h cd-paranoia.$(OBJEXT): usage.h
#: create header file used in help text: the "usage" help.
if HAVE_PERL if HAVE_PERL
usage.h: usage.txt $(srcdir)/pod2c.pl usage.h: usage.txt $(srcdir)/pod2c.pl
$(PERL) $(srcdir)/pod2c.pl usage.txt >usage.h $(PERL) $(srcdir)/pod2c.pl usage.txt >usage.h