other/951: Documentation of compiler passes and sources very out of date

[Joseph Myers]

>Number:         951
>Category:       other
>Synopsis:       Documentation of compiler passes and sources very out of date
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    unassigned
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Dec 01 06:06:00 PST 2000
>Closed-Date:
>Last-Modified:
>Originator:     Joseph S. Myers
>Release:        2.97 20001201 (experimental)
>Organization:
none
>Environment:
System: Linux decomino 2.2.17 #1 Mon Sep 4 20:22:16 UTC 2000 i686 unknown
Architecture: i686

	
host: i686-pc-linux-gnu
build: i686-pc-linux-gnu
target: i686-pc-linux-gnu
configured with: ../gcc-cvs/configure --prefix=/opt/gcc/snapshot --disable-shared --enable-threads=posix --with-system-zlib
>Description:

gcc.texi includes documentation of the passes of the compiler and of
the source files that implement them.  This documentation is very out
of date.

>How-To-Repeat:

Read the GCC manual.  Observe the failure to cover whole-function
trees, references to now non-existent source files such as sched.c,
out of date information on -d options, etc..

>Fix:

Update this part of the manual with careful reference to toplev.c,
including all passes in the correct order, documenting the source
files used and ensuring that each relevant source file is mentioned
and that no source files that are no longer in GCC are mentioned.
Once it is up to date, insist that patches adding optimization passes
or otherwise changing this area must include the documentation updates
as well.
>Release-Note:
>Audit-Trail:
>Unformatted: