Make-lang.in: Add rules for building g77.1.

2001-11-08  Toon Moene  <toon@moene.indiv.nluug.nl>

	* Make-lang.in: Add rules for building g77.1.
	* invoke.texi: Add man page stuff.  Move indexing
	from g77.texi to here.
	* g77.texi: Remove indexing specific to invoke.texi.
	* news.texi: Document that g77.1 is now a generated
	file.

From-SVN: r46840

5 files changed, 144 insertions, 58 deletions

diff --git a/gcc/f/ChangeLog b/gcc/f/ChangeLog
index cc346bd..7a683ba 100644
--- a/gcc/f/ChangeLog
+++ b/gcc/f/ChangeLog
@@ -1,3 +1,12 @@
+2001-11-08  Toon Moene  <toon@moene.indiv.nluug.nl>
+
+	* Make-lang.in: Add rules for building g77.1.
+	* invoke.texi: Add man page stuff.  Move indexing
+	from g77.texi to here.
+	* g77.texi: Remove indexing specific to invoke.texi.
+	* news.texi: Document that g77.1 is now a generated
+	file.
+
 Tue Nov  6 21:17:47 2001  Neil Booth  <neil@cat.daikokuya.demon.co.uk>
 
 	* com.c: Include langhooks-def.h.
diff --git a/gcc/f/Make-lang.in b/gcc/f/Make-lang.in
index 464c75e..6ea4635 100644
--- a/gcc/f/Make-lang.in
+++ b/gcc/f/Make-lang.in
@@ -165,7 +165,9 @@ f77.all.cross: g77-cross$(exeext)
 f77.start.encap: g77$(exeext)
 f77.rest.encap:
 
-f77.info: $(srcdir)/f/g77.info
+# Note the kludge to get g77.1 to build.
+
+f77.info: $(srcdir)/f/g77.info f/g77.1
 f77.dvi: f/g77.dvi
 
 # g77 documentation.
@@ -199,6 +201,23 @@ f/g77.dvi: $(srcdir)/f/g77.texi $(srcdir)/f/bugs.texi \
 	  cd f && $(TEXI2DVI) -I $$s/doc/include $$s/f/g77.texi; \
 	else true; fi
 
+f/g77.1: $(srcdir)/f/g77.1 $(srcdir)/f/invoke.texi
+	case "$(LANGUAGES)" in \
+	  *[fF]77*) $(STAMP) lang-f77;; \
+	  *) rm -f lang-f77;; \
+	esac
+	if [ -f lang-f77 ]; then \
+	  if [ x$(GENERATED_MANPAGES) = xgenerated-manpages ]; then \
+            $(TEXI2POD) < $(srcdir)/f/invoke.texi > f/g77.pod; \
+            ($(POD2MAN) f/g77.pod > f/g77.1.T$$$$ && \
+                mv -f f/g77.1.T$$$$ f/g77.1) || \
+                (rm -f f/g77.1.T$$$$ && exit 1); \
+            rm -f f/g77.pod; \
+	  else \
+	    cp $(srcdir)/f/g77.1 f/g77.1; \
+	  fi; \
+	else true; fi
+
 # This dance is all about producing accurate documentation for g77's
 # intrinsics with minimum fuss.  f/ansify appends "\n\" to C strings
 # so ANSI C compilers can compile f/intdoc.h -- gcc can compile f/intdoc.in
@@ -321,7 +340,7 @@ f77.install-info: f77.info installdirs
 
 # Make sure `installdirs' target (from gcc Makefile) has been
 # run, since we use libsubdir to store our `flag' file, lang-f77.
-f77.install-man: $(srcdir)/f/g77.1 installdirs
+f77.install-man: f/g77.1 installdirs
 	case "$(LANGUAGES)" in \
 	  *[fF]77*) $(STAMP) $(libsubdir)/lang-f77.man;; \
 	  *) rm -f $(libsubdir)/lang-f77.man;; \
@@ -329,11 +348,11 @@ f77.install-man: $(srcdir)/f/g77.1 installdirs
 	-if [ -f $(libsubdir)/lang-f77.man -a -f f771$(exeext) ] ; then \
 	  if [ -f g77-cross$(exeext) ] ; then \
 	    rm -f $(man1dir)/$(G77_CROSS_NAME)$(manext); \
-	    $(INSTALL_DATA) $(srcdir)/f/g77.1 $(man1dir)/$(G77_CROSS_NAME)$(manext); \
+	    $(INSTALL_DATA) f/g77.1 $(man1dir)/$(G77_CROSS_NAME)$(manext); \
 	    chmod a-x $(man1dir)/$(G77_CROSS_NAME)$(manext); \
 	  else \
 	    rm -f $(man1dir)/$(G77_INSTALL_NAME)$(manext); \
-	    $(INSTALL_DATA) $(srcdir)/f/g77.1 $(man1dir)/$(G77_INSTALL_NAME)$(manext); \
+	    $(INSTALL_DATA) f/g77.1 $(man1dir)/$(G77_INSTALL_NAME)$(manext); \
 	    chmod a-x $(man1dir)/$(G77_INSTALL_NAME)$(manext); \
 	  fi; \
 	else true; fi
diff --git a/gcc/f/g77.texi b/gcc/f/g77.texi
index 49a1516..6988a7d 100644
--- a/gcc/f/g77.texi
+++ b/gcc/f/g77.texi
@@ -840,55 +840,6 @@ Use the @samp{-v} option with @code{g77}
 to see what is going on---the first line of output is the invocation
 of the @code{gcc} command.
 
-@node Invoking G77
-@chapter GNU Fortran Command Options
-@cindex GNU Fortran command options
-@cindex command options
-@cindex options, GNU Fortran command
-
-The @code{g77} command supports all the options supported by the
-@code{gcc} command.
-@xref{Invoking GCC,,GNU CC Command Options,gcc,Using and Porting GNU CC},
-for information
-on the non-Fortran-specific aspects of the @code{gcc} command (and,
-therefore, the @code{g77} command).
-
-@cindex options, negative forms
-@cindex negative forms of options
-All @code{gcc} and @code{g77} options
-are accepted both by @code{g77} and by @code{gcc}
-(as well as any other drivers built at the same time,
-such as @code{g++}),
-since adding @code{g77} to the @code{gcc} distribution
-enables acceptance of @code{g77}-specific options
-by all of the relevant drivers.
-
-In some cases, options have positive and negative forms;
-the negative form of @samp{-ffoo} would be @samp{-fno-foo}.
-This manual documents only one of these two forms, whichever
-one is not the default.
-
-@menu
-* Option Summary::      Brief list of all @code{g77} options,
-                        without explanations.
-* Overall Options::     Controlling the kind of output:
-                        an executable, object files, assembler files,
-                        or preprocessed source.
-* Shorthand Options::   Options that are shorthand for other options.
-* Fortran Dialect Options::  Controlling the variant of Fortran language
-                             compiled.
-* Warning Options::     How picky should the compiler be?
-* Debugging Options::   Symbol tables, measurements, and debugging dumps.
-* Optimize Options::    How much optimization?
-* Preprocessor Options:: Controlling header files and macro definitions.
-                         Also, getting dependency information for Make.
-* Directory Options::   Where to find header files and libraries.
-                        Where to find the compiler executable files.
-* Code Gen Options::    Specifying conventions for function calls, data layout
-                        and register usage.
-* Environment Variables:: Env vars that affect GNU Fortran.
-@end menu
-
 @include invoke.texi
 
 @include news.texi
diff --git a/gcc/f/invoke.texi b/gcc/f/invoke.texi
index 08febaa..caae931 100644
--- a/gcc/f/invoke.texi
+++ b/gcc/f/invoke.texi
@@ -1,3 +1,108 @@
+@c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
+@c 2000, 2001 Free Software Foundation, Inc.
+@c This is part of the G77 manual.   
+@c For copying conditions, see the file g77.texi.
+
+@ignore
+@c man begin COPYRIGHT
+Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997,
+1998, 1999, 2000, 2001 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 g77
+@settitle GNU project Fortran 77 compiler.
+@c man begin SYNOPSIS
+g77 [@option{-c}|@option{-S}|@option{-E}] [@option{-std=}@var{standard}]
+    [@option{-g}] [@option{-pg}] [@option{-O}@var{level}]
+    [@option{-W}@var{warn}@dots{}] [@option{-pedantic}]
+    [@option{-I}@var{dir}@dots{}] [@option{-L}@var{dir}@dots{}]
+    [@option{-D}@var{macro}[=@var{defn}]@dots{}] [@option{-U}@var{macro}]
+    [@option{-f}@var{option}@dots{}] [@option{-m}@var{machine-option}@dots{}]
+    [@option{-o} @var{outfile}] @var{infile}@dots{}
+
+Only the most useful options are listed here; see below for the
+remainder.
+@c man end
+@c man begin SEEALSO
+cpp(1), gcov(1), gcc(1), as(1), ld(1), gdb(1), adb(1), dbx(1), sdb(1)
+and the Info entries for @file{gcc}, @file{cpp}, @file{g77}, @file{as},
+@file{ld}, @file{binutils} and @file{gdb}.
+@c man end
+@c man begin BUGS
+For instructions on reporting bugs, see
+@w{@uref{http://gcc.gnu.org/bugs.html}}.  Use of the @command{gccbug}  
+script to report bugs is recommended.
+@c man end
+@c man begin AUTHOR
+See the Info entry for @file{g77}, or
+@w{@uref{http://gcc.gnu.org/thanks.html}}, for contributors to G77@.
+@c man end
+@end ignore
+
+@node Invoking G77
+@chapter GNU Fortran Command Options
+@cindex GNU Fortran command options
+@cindex command options
+@cindex options, GNU Fortran command
+
+The @code{g77} command supports all the options supported by the
+@code{gcc} command.
+@xref{Invoking GCC,,GNU CC Command Options,gcc,Using and Porting GNU CC},
+for information
+on the non-Fortran-specific aspects of the @code{gcc} command (and,
+therefore, the @code{g77} command).
+
+@cindex options, negative forms
+@cindex negative forms of options
+All @code{gcc} and @code{g77} options
+are accepted both by @code{g77} and by @code{gcc}
+(as well as any other drivers built at the same time,
+such as @code{g++}),
+since adding @code{g77} to the @code{gcc} distribution
+enables acceptance of @code{g77}-specific options
+by all of the relevant drivers.
+
+In some cases, options have positive and negative forms;
+the negative form of @samp{-ffoo} would be @samp{-fno-foo}.
+This manual documents only one of these two forms, whichever
+one is not the default.
+
+@menu
+* Option Summary::      Brief list of all @code{g77} options,
+                        without explanations.
+* Overall Options::     Controlling the kind of output:
+                        an executable, object files, assembler files,
+                        or preprocessed source.
+* Shorthand Options::   Options that are shorthand for other options.
+* Fortran Dialect Options::  Controlling the variant of Fortran language
+                             compiled.
+* Warning Options::     How picky should the compiler be?
+* Debugging Options::   Symbol tables, measurements, and debugging dumps.
+* Optimize Options::    How much optimization?
+* Preprocessor Options:: Controlling header files and macro definitions.
+                         Also, getting dependency information for Make.
+* Directory Options::   Where to find header files and libraries.
+                        Where to find the compiler executable files.
+* Code Gen Options::    Specifying conventions for function calls, data layout
+                        and register usage.
+* Environment Variables:: Env vars that affect GNU Fortran.
+@end menu
+
 @node Option Summary
 @section Option Summary
 
diff --git a/gcc/f/news.texi b/gcc/f/news.texi
index cd62b25..dca301e 100644
--- a/gcc/f/news.texi
+++ b/gcc/f/news.texi
@@ -1,4 +1,4 @@
-@c Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
+@c Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 @c This is part of the G77 manual.
 @c For copying conditions, see the file g77.texi.
 
@@ -9,7 +9,7 @@
 @c in the standalone derivations of this file (e.g. NEWS).
 @set copyrights-news 1995,1996,1997,1998,1999,2000,2001
 
-@set last-update-news 2001-10-29
+@set last-update-news 2001-11-08
 
 @include root.texi
 
@@ -154,7 +154,10 @@ The following information was last updated on @value{last-update-news}:
 
 @heading In development, 0.5.27, @code{GCC} 3.1 versus @code{GCC} 3.0:
 @itemize @bullet
-@ifclear USERVISONLY
+@item
+g77 now has its man page generated from the texinfo documentation,
+to guarantee that it remains up to date.
+
 @item
 g77 used to reject the following program on 32-bit targets:
 @smallexample
@@ -174,7 +177,7 @@ because 140 000 000 reals is larger than the largest bit-extent that can be
 expressed in 32 bits.  However, bit-sizes never play a role after offsets
 have been converted to byte addresses.  Therefore this check has been removed.
 Note: On GNU/Linux systems one has to compile programs that occupy more
-than 1 Gbyte statically, i.e.@: g77 -static ...
+than 1 Gbyte statically, i.e.@: @code{g77 -static ...}.
 
 @item
 Based on work done by Juergen Pfeifer (@email{juergen.pfeifer@@gmx.net})
@@ -203,7 +206,6 @@ that permits the use of zero length substrings of the form
 Based on code developed by Pedro Vazquez (@email{vazquez@@penelope.iqm.unicamp.br}),
 the @code{libf2c} library is now able to read and write files larger than
 2 Gbyte on 32-bit target machines, if the operating system supports this.
-@end ifclear
 @end itemize
 
 @heading In 0.5.26, @code{GCC} 3.0 versus @code{GCC} 2.95: