X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2FMakefile.am;h=58a27a353587ba1eb58453d1cc7c81e58804a492;hb=0dd814fac2287d1d88ae886d614bb3bb5dd2ea9d;hp=310ecfe49530abcb519dbe9f07287af47b86f768;hpb=89cf4ccc6f775e59c013f1913f227f8763f80048;p=chaz%2Ftar diff --git a/doc/Makefile.am b/doc/Makefile.am index 310ecfe..58a27a3 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,53 +1,87 @@ # Makefile for GNU tar documentation. -# Copyright (C) 1994, 1995, 1996, 1997 Free Software Foundation, Inc. -# 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 -# the Free Software Foundation; either version 2, or (at your option) -# any later version. +# Copyright (C) 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003, 2006 Free +# Software Foundation, Inc. -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. +## 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 +## the Free Software Foundation; either version 2, or (at your option) +## any later version. -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software Foundation, -# Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. -AUTOMAKE_OPTIONS = gnits -info_TEXINFOS = tar.texi - -EXTRA_DIST = convtexi.pl getdate.texi header.texi +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software Foundation, +## Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. -CLEANFILES = tmp-* +info_TEXINFOS = tar.texi +tar_TEXINFOS = \ + dumpdir.texi\ + tar-snapshot-edit.texi\ + fdl.texi\ + freemanuals.texi\ + genfile.texi\ + getdate.texi\ + header.texi\ + intern.texi\ + rendition.texi\ + snapshot.texi\ + sparse.texi\ + value.texi +EXTRA_DIST = gendocs_template mastermenu.el texify.sed +DISTCLEANFILES=*.info* # The rendering level is anyone of PUBLISH, DISTRIB or PROOF. -# Just call `make dvi RENDITION=PROOF' if you want PROOF rendition. +# Just call `make RENDITION=PROOF [target]' if you want PROOF rendition. RENDITION = DISTRIB -tar.info: tar.texi getdate.texi header.texi version.texi - @echo "WARNING: \`makeinfo' will not preprocess Texinfo input properly" - @echo " for expanding Texinfo macros, if it comes from a" - @echo " Texinfo distribution which is earlier than version 3.7." - cd $(srcdir) && $(MAKEINFO) -D$(RENDITION) tar.texi - -tar.dvi: tar.texi getdate.texi header.texi version.texi - @echo "WARNING: \`makeinfo' will not preprocess Texinfo input properly" - @echo " for expanding Texinfo macros, if it comes from a" - @echo " Texinfo distribution which is earlier than version 3.7." - $(MAKEINFO) -D$(RENDITION) -Etmp-tar.tmp -otmp-tar.info \ - -I$(srcdir) tar.texi - rm -f tmp-tar.sed tmp-tar.info* - test $(RENDITION) = DISTRIB \ - || echo >>tmp-tar.sed 's/^@set DISTRIB/@set $(RENDITION)/' - test $(RENDITION) = PUBLISH \ - || echo >>tmp-tar.sed '/^@smallbook/d' - sed -f tmp-tar.sed tmp-tar.tmp > tmp-tar.texi - rm -f tmp-tar.sed tmp-tar.tmp - TEXINPUTS=$(srcdir):$$TEXINPUTS $(TEXI2DVI) tmp-tar.texi - mv tmp-tar.dvi $@ +MAKEINFOFLAGS=-D$(RENDITION) header.texi: $(top_srcdir)/src/tar.h - sed -n '/Archive Format/,/End of Format/p' $(top_srcdir)/src/tar.h \ - | expand | sed 's/\([{}]\)/@\1/g' > $(srcdir)/header.texi + sed -f $(srcdir)/texify.sed $(top_srcdir)/src/tar.h \ + | expand >$@ + +master-menu: $(tar_TEXINFOS) + emacs -batch -l mastermenu.el -f make-master-menu $(info_TEXINFOS) + +check-options: + @ARGP_HELP_FMT='usage-indent=0,short-opt-col=0,long-opt-col=0,\ +doc-opt-col=0,opt-doc-col=0,header-col=0,rmargin=1' \ + $(top_builddir)/src/tar --usage | \ + sed -n 's/^\[--\([^]\=\[]*\).*/\1/p' | sort | uniq > opts.$$$$;\ + $(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) -E - \ + $(info_TEXINFOS) | \ + sed -n '/^@macro/,/^@end macro/d;s/@opindex *\([^@,]*\).*/\1/p' \ + | sort | uniq > docs.$$$$;\ + (echo 'Not documented options:';\ + join -v1 opts.$$$$ docs.$$$$;\ + echo 'Non-existing options:';\ + join -v2 opts.$$$$ docs.$$$$) > report.$$$$;\ + rm opts.$$$$ docs.$$$$;\ + if [ -n "`sed '1,2d' report.$$$$`" ]; then \ + cat report.$$$$;\ + rm report.$$$$;\ + exit 1;\ + fi;\ + rm report.$$$$ + + +clean-local: + rm -rf manual + +GENDOCS=gendocs.sh + +TEXI2DVI=texi2dvi -t '@set $(RENDITION)' -E + +# Make sure you set TEXINPUTS +# Usual value is: +# /usr/share/texmf/pdftex/plain/misc:/usr/share/texmf/pdftex/config +manual: + TEXINPUTS=$(srcdir):$(top_srcdir)/build-tex:$(TEXINPUTS) \ + MAKEINFO="$(MAKEINFO) $(MAKEINFOFLAGS)" \ + TEXI2DVI="$(TEXI2DVI) -t @finalout" \ + $(GENDOCS) tar 'GNU tar manual' +