This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Patch to update docs for C compiler source files
- To: <gcc-patches at gcc dot gnu dot org>
- Subject: Patch to update docs for C compiler source files
- From: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Date: Sat, 23 Jun 2001 00:17:05 +0100 (BST)
This patch updates the documentation of the source files of the C
compiler. It passes "make info" and "make dvi". Applied to mainline
and branch.
2001-06-22 Joseph S. Myers <jsm28@cam.ac.uk>
* doc/gcc.texi: Update documentation of source files of C
compiler.
--- gcc.texi.orig Thu Jun 21 18:23:08 2001
+++ gcc.texi Fri Jun 22 22:44:26 2001
@@ -3171,7 +3171,9 @@
@itemize @bullet
@item
Parsing. This pass reads the entire text of a function definition,
-constructing a high level tree representation.
+constructing a high level tree representation. (Because of the semantic
+analysis that takes place during this pass, it does more than is
+formally considered to be parsing.)
The tree representation does not entirely follow C syntax, because it is
intended to support other languages as well.
@@ -3192,15 +3194,17 @@
@c Avoiding overfull is tricky here.
The source files to parse C are
-@file{c-parse.in},
-@file{c-decl.c},
-@file{c-typeck.c},
@file{c-aux-info.c},
@file{c-convert.c},
-and @file{c-lang.c}
-along with header files
-@file{c-lex.h}, and
-@file{c-tree.h}.
+@file{c-decl.c},
+@file{c-errors.c},
+@file{c-lang.c},
+@file{c-parse.in},
+and
+@file{c-typeck.c},
+along with a header file
+@file{c-tree.h}
+and some files shared with Objective-C and C++.
The source files for parsing C++ are in @file{cp/}.
They are @file{parse.y},
@@ -3220,7 +3224,22 @@
@file{objc-act.h}. Certain C-specific files are used for this as
well.
-The file @file{c-common.c} is also used for all of the above languages.
+The files
+@file{c-common.c},
+@file{c-common.def},
+@file{c-dump.c},
+@file{c-format.c},
+@file{c-lex.c},
+@file{c-pragma.c},
+and
+@file{c-semantics.c},
+along with header files
+@file{c-common.h},
+@file{c-dump.h},
+@file{c-lex.h},
+and
+@file{c-pragma.h},
+are also used for all of the above languages.
@cindex Tree optimization
--
Joseph S. Myers
jsm28@cam.ac.uk