gcov.texi: Add magic comments for texi2pod.pl.

gcc:
	* gcov.texi: Add magic comments for texi2pod.pl.
	* Makefile.in: Add rules to generate and install gcov.1.
	* gcov.1: New (generated) file.

contrib:
	* gcc_update: Add gcov.1 to the list of generated files.

From-SVN: r37649

contrib/ChangeLog

+2000-11-22  Joseph S. Myers  <jsm28@cam.ac.uk>
+
+	* gcc_update: Add gcov.1 to the list of generated files.
+
 2000-11-21  Mark Mitchell  <mark@codesourcery.com>
 
 	* gcc_build: Remove code to put information in a log file.

contrib/gcc_update

@@ -67,6 +67,7 @@ gcc/cstamp-h.in: gcc/configure.in gcc/acconfig.h
 gcc/config.in: gcc/cstamp-h.in
 gcc/fixinc/fixincl.x: gcc/fixinc/fixincl.tpl gcc/fixinc/inclhack.def
 gcc/tradcif.c: gcc/tradcif.y
+gcc/gcov.1: gcc/gcov.texi
 # And then, language-specific files
 gcc/java/parse.h: gcc/java/parse.y
 # And libraries, at last

gcc/ChangeLog

+2000-11-22  Joseph S. Myers  <jsm28@cam.ac.uk>
+
+	* gcov.texi: Add magic comments for texi2pod.pl.
+	* Makefile.in: Add rules to generate and install gcov.1.
+	* gcov.1: New (generated) file.
+
 2000-11-21  Richard Henderson  <rth@redhat.com>
 
 	* regrename.c (scan_rtx_reg): Terminate the chain rather than

gcc/Makefile.in

@@ -129,6 +129,8 @@ INSTALL_DATA = @INSTALL_DATA@
 MAKEINFO = @MAKEINFO@
 MAKEINFOFLAGS =
 TEXI2DVI = texi2dvi
+TEXI2POD = $(srcdir)/../contrib/texi2pod.pl
+POD2MAN = pod2man --center="GNU" --release="gcc-$(version)" --section=1
 # For GNUmake: let us decide what gets passed to recursive makes.
 MAKEOVERRIDES =
 @SET_MAKE@
@@ -2171,6 +2173,13 @@ cpp.dvi: $(srcdir)/cpp.texi
 	texindex cpp.??
 	TEXINPUTS=${texidir}:$(srcdir):$$TEXINPUTS tex cpp.texi
 
+$(srcdir)/gcov.1: $(srcdir)/gcov.texi
+	$(TEXI2POD) < $(srcdir)/gcov.texi > gcov.pod
+	($(POD2MAN) gcov.pod > $(srcdir)/gcov.1.T$$$$ && \
+		mv -f $(srcdir)/gcov.1.T$$$$ $(srcdir)/gcov.1) || \
+		(rm -f $(srcdir)/gcov.1.T$$$$ && exit 1)
+	rm -f gcov.pod
+
 #
 # Deletion of files made during compilation.
 # There are four levels of this:
@@ -2265,6 +2274,7 @@ distclean: clean $(INTL_DISTCLEAN) lang.distclean
 	-rm -f cxxmain.c splay-tree.c obstack.c
 	-rm -f mklibgcc libgcc.map gccbug .gdbinit configargs.h
 	-rm -f c-tree.info c-tree.info-1 c-tree.info-2 c-tree.info-3
+	-rm -f gcov.pod
 	-rm -f fixinc/Makefile
 	-rmdir cp f java objc fixinc intl po 2>/dev/null
 
@@ -2299,6 +2309,7 @@ maintainer-clean:
 	-rm -f c-parse.y c-parse.c c-parse.output TAGS
 	-rm -f cpp.info* cpp.??s cpp.*aux
 	-rm -f gcc.info* gcc.??s gcc.*aux
+	-rm -f $(srcdir)/gcov.1
 #
 # Entry points `install' and `uninstall'.
 # Also use `install-collect2' to install collect2 when the config files don't.
@@ -2482,7 +2493,7 @@ install-info: doc installdirs lang.install-info
 	-chmod a-x $(infodir)/cpp.info* $(infodir)/gcc.info*
 
 # Install the man pages.
-install-man: installdirs $(srcdir)/gcc.1 $(srcdir)/cpp.1 lang.install-man
+install-man: installdirs $(srcdir)/gcc.1 $(srcdir)/cpp.1 $(srcdir)/gcov.1 lang.install-man
 	-if [ -f gcc-cross$(exeext) ] ; then \
 	  rm -f $(man1dir)/$(GCC_CROSS_NAME)$(manext); \
 	  $(INSTALL_DATA) $(srcdir)/gcc.1 $(man1dir)/$(GCC_CROSS_NAME)$(manext); \
@@ -2494,6 +2505,8 @@ install-man: installdirs $(srcdir)/gcc.1 $(srcdir)/cpp.1 lang.install-man
 	fi
 	-rm -f $(man1dir)/cpp$(manext)
 	-$(INSTALL_DATA) $(srcdir)/cpp.1 $(man1dir)/cpp$(manext)
+	-rm -f $(man1dir)/gcov$(manext)
+	-$(INSTALL_DATA) $(srcdir)/gcov.1 $(man1dir)/gcov$(manext)
 	-chmod a-x $(man1dir)/cpp$(manext)
 
 # Install the library.

gcc/gcov.texi

@@ -2,6 +2,30 @@
 @c This is part of the GCC manual.
 @c For copying conditions, see the file gcc.texi.
 
+@ignore
+@c man begin COPYRIGHT
+Copyright @copyright{} 1996, 1997, 1999, 2000 Free Software Foundation, Inc.
+
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided also that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+
+Permission is granted to copy and distribute translations of this manual
+into another language, under the above conditions for modified versions,
+except that this permission notice may be included in translations
+approved by the Free Software Foundation instead of in the original
+English.
+@c man end
+@c Set file name and title for the man page.
+@setfilename gcov
+@settitle coverage testing tool
+@end ignore
+
 @node Gcov
 @chapter @code{gcov}: a Test Coverage Program
 
@@ -19,6 +43,7 @@ This chapter describes version 1.5 of @code{gcov}.
 
 @node Gcov Intro
 @section Introduction to @code{gcov}
+@c man begin DESCRIPTION
 
 @code{gcov} is a test coverage program.  Use it in concert with @sc{gnu}
 CC to analyze your programs to help create more efficient, faster
@@ -77,6 +102,8 @@ timing information you can use along with the information you get from
 @code{gcov} works only on code compiled with @sc{gnu} CC.  It is not
 compatible with any other profiling or test coverage mechanism.
 
+@c man end
+
 @node Invoking Gcov
 @section Invoking gcov
 
@@ -84,8 +111,18 @@ compatible with any other profiling or test coverage mechanism.
 gcov [-b] [-c] [-v] [-n] [-l] [-f] [-o directory] @var{sourcefile}
 @end smallexample
 
+@ignore
+@c man begin SYNOPSIS
+gcov [@samp{-b}] [@samp{-c}] [@samp{-v}] [@samp{-n}] [@samp{-l}] [@samp{-f}] [@samp{-o} @var{directory}] @var{sourcefile}
+@c man end
+@c man begin SEEALSO
+gcc(1) and the Info entry for @file{gcc}.
+@c man end
+@end ignore
+
+@c man begin OPTIONS
 @table @code
-@item -b 
+@item -b
 Write branch frequencies to the output file, and write branch summary
 info to the standard output.  This option allows you to see how often
 each branch in your program was taken.
@@ -273,6 +310,7 @@ executed 100 times.  In one sense this result is correct, because there
 was only one instruction representing all four of these lines.  However,
 the output does not indicate how many times the result was 0 and how
 many times the result was 1.
+@c man end
 
 @node Gcov Data Files
 @section Brief description of @code{gcov} data files