summaryrefslogtreecommitdiffstats
path: root/contrib/gcc/doc/cppinternals.texi
diff options
context:
space:
mode:
authorkan <kan@FreeBSD.org>2007-05-19 01:19:51 +0000
committerkan <kan@FreeBSD.org>2007-05-19 01:19:51 +0000
commit1f9ea4d0a40cca64d60cf4dab152349da7b9dddf (patch)
tree0cb530c9c38af219e6dda2994c078b6b2b9ad853 /contrib/gcc/doc/cppinternals.texi
parent4895159b2b4f648051c1f139faa7b6dc50c2bfcb (diff)
downloadFreeBSD-src-1f9ea4d0a40cca64d60cf4dab152349da7b9dddf.zip
FreeBSD-src-1f9ea4d0a40cca64d60cf4dab152349da7b9dddf.tar.gz
GCC 4.2.0 release.
Diffstat (limited to 'contrib/gcc/doc/cppinternals.texi')
-rw-r--r--contrib/gcc/doc/cppinternals.texi34
1 files changed, 17 insertions, 17 deletions
diff --git a/contrib/gcc/doc/cppinternals.texi b/contrib/gcc/doc/cppinternals.texi
index 9f5863c..ff6acc3 100644
--- a/contrib/gcc/doc/cppinternals.texi
+++ b/contrib/gcc/doc/cppinternals.texi
@@ -2,8 +2,10 @@
@setfilename cppinternals.info
@settitle The GNU C Preprocessor Internals
+@include gcc-common.texi
+
@ifinfo
-@dircategory Programming
+@dircategory Software development
@direntry
* Cpplib: (cppinternals). Cpplib internals.
@end direntry
@@ -16,7 +18,7 @@
@ifinfo
This file documents the internals of the GNU C Preprocessor.
-Copyright 2000, 2001, 2002, 2004 Free Software Foundation, Inc.
+Copyright 2000, 2001, 2002, 2004, 2005 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -39,15 +41,13 @@ into another language, under the above conditions for modified versions.
@end ifinfo
@titlepage
-@c @finalout
@title Cpplib Internals
-@subtitle Last revised January 2002
-@subtitle for GCC version 3.1
+@versionsubtitle
@author Neil Booth
@page
@vskip 0pt plus 1filll
@c man begin COPYRIGHT
-Copyright @copyright{} 2000, 2001, 2002, 2004
+Copyright @copyright{} 2000, 2001, 2002, 2004, 2005
Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
@@ -70,8 +70,8 @@ into another language, under the above conditions for modified versions.
@top
@chapter Cpplib---the GNU C Preprocessor
-The GNU C preprocessor in GCC 3.x has been completely rewritten. It is
-now implemented as a library, @dfn{cpplib}, so it can be easily shared between
+The GNU C preprocessor is
+implemented as a library, @dfn{cpplib}, so it can be easily shared between
a stand-alone preprocessor, and a preprocessor integrated with the C,
C++ and Objective-C front ends. It is also available for use by other
programs, though this is not recommended as its exposed interface has
@@ -98,7 +98,7 @@ the way they have.
* Line Numbering:: Tracking location within files.
* Guard Macros:: Optimizing header files with guard macros.
* Files:: File handling.
-* Index:: Index.
+* Concept Index:: Index.
@end menu
@node Conventions
@@ -111,7 +111,7 @@ other is for both internal and external use.
The convention is that functions and types that are exposed to multiple
files internally are prefixed with @samp{_cpp_}, and are to be found in
-the file @file{cpphash.h}. Functions and types exposed to external
+the file @file{internal.h}. Functions and types exposed to external
clients are in @file{cpplib.h}, and prefixed with @samp{cpp_}. For
historical reasons this is no longer quite true, but we should strive to
stick to it.
@@ -130,7 +130,7 @@ behavior.
@cindex escaped newlines
@section Overview
-The lexer is contained in the file @file{cpplex.c}. It is a hand-coded
+The lexer is contained in the file @file{lex.c}. It is a hand-coded
lexer, and not implemented as a state machine. It can understand C, C++
and Objective-C source code, and has been extended to allow reasonably
successful preprocessing of assembly language. The lexer does not make
@@ -788,8 +788,8 @@ lexed on if, for example, there are intervening escaped newlines or
C-style comments. For example:
@smallexample
-foo /* A long
-comment */ bar \
+foo /* @r{A long
+comment} */ bar \
baz
@result{}
foo bar baz
@@ -962,7 +962,7 @@ directives outside the main conditional block for the optimization to be
on.
Note that whilst we are inside the conditional block, @code{mi_valid} is
-likely to be reset to @code{false}, but this does not matter since the
+likely to be reset to @code{false}, but this does not matter since
the closing @code{#endif} restores it to @code{true} if appropriate.
Finally, since @code{_cpp_lex_direct} pops the file off the buffer stack
@@ -995,7 +995,7 @@ is turned off.
@cindex files
Fairly obviously, the file handling code of cpplib resides in the file
-@file{cppfiles.c}. It takes care of the details of file searching,
+@file{files.c}. It takes care of the details of file searching,
opening, reading and caching, for both the main source file and all the
headers it recursively includes.
@@ -1058,8 +1058,8 @@ command line (or system) include directories to which the mapping
applies. This may be higher up the directory tree than the full path to
the file minus the base name.
-@node Index
-@unnumbered Index
+@node Concept Index
+@unnumbered Concept Index
@printindex cp
@bye
OpenPOWER on IntegriCloud