Commit cd1a8088 by James A. Morrison

cfg.texi: Use @smallexample.

2004-09-17  James Morrison  <phython@gcc.gnu.org>

        * doc/cfg.texi: Use @smallexample.
        * doc/md.texi: Likewise.
        * doc/tree-ssa.texi: Likewise.
        * doc/extend.texi: Likewise.  Use @r{} in comments.
        * doc/trouble.texi: Use @r{} in comments.

From-SVN: r87646
parent 57f0099a
2004-09-17 James Morrison <phython@gcc.gnu.org>
* doc/cfg.texi: Use @smallexample.
* doc/md.texi: Likewise.
* doc/tree-ssa.texi: Likewise.
* doc/extend.texi: Likewise. Use @r{} in comments.
* doc/trouble.texi: Use @r{} in comments.
2004-09-17 Hans-Peter Nilsson <hp@bitrange.com> 2004-09-17 Hans-Peter Nilsson <hp@bitrange.com>
* configure.ac (gcc_cv_gld_version): Handle whitespace before * configure.ac (gcc_cv_gld_version): Handle whitespace before
......
...@@ -120,7 +120,7 @@ in the various @file{tree-*} files. ...@@ -120,7 +120,7 @@ in the various @file{tree-*} files.
The following snippet will pretty-print all the statements of the The following snippet will pretty-print all the statements of the
program in the GIMPLE representation. program in the GIMPLE representation.
@example @smallexample
FOR_EACH_BB (bb) FOR_EACH_BB (bb)
@{ @{
block_stmt_iterator si; block_stmt_iterator si;
...@@ -131,7 +131,7 @@ FOR_EACH_BB (bb) ...@@ -131,7 +131,7 @@ FOR_EACH_BB (bb)
print_generic_stmt (stderr, stmt, 0); print_generic_stmt (stderr, stmt, 0);
@} @}
@} @}
@end example @end smallexample
@node Edges @node Edges
...@@ -231,7 +231,7 @@ stages of the compilation process, GCC tries to avoid such dense flow ...@@ -231,7 +231,7 @@ stages of the compilation process, GCC tries to avoid such dense flow
graphs by factoring computed jumps. For example, given the following graphs by factoring computed jumps. For example, given the following
series of jumps, series of jumps,
@example @smallexample
goto *x; goto *x;
[ ... ] [ ... ]
...@@ -240,13 +240,13 @@ series of jumps, ...@@ -240,13 +240,13 @@ series of jumps,
goto *x; goto *x;
[ ... ] [ ... ]
@end example @end smallexample
@noindent @noindent
factoring the computed jumps results in the following code sequence factoring the computed jumps results in the following code sequence
which has a much simpler flow graph: which has a much simpler flow graph:
@example @smallexample
goto y; goto y;
[ ... ] [ ... ]
...@@ -258,7 +258,7 @@ which has a much simpler flow graph: ...@@ -258,7 +258,7 @@ which has a much simpler flow graph:
y: y:
goto *x; goto *x;
@end example @end smallexample
However, the classic problem with this transformation is that it has a However, the classic problem with this transformation is that it has a
runtime cost in there resulting code: An extra jump. Therefore, the runtime cost in there resulting code: An extra jump. Therefore, the
......
...@@ -3610,13 +3610,13 @@ it as input or output but if this is not known, you should add ...@@ -3610,13 +3610,13 @@ it as input or output but if this is not known, you should add
@samp{memory}. As an example, if you access ten bytes of a string, you @samp{memory}. As an example, if you access ten bytes of a string, you
can use a memory input like: can use a memory input like:
@example @smallexample
@{"m"( (@{ struct @{ char x[10]; @} *p = (void *)ptr ; *p; @}) )@}. @{"m"( (@{ struct @{ char x[10]; @} *p = (void *)ptr ; *p; @}) )@}.
@end example @end smallexample
Note that in the following example the memory input is necessary, Note that in the following example the memory input is necessary,
otherwise GCC might optimize the store to @code{x} away: otherwise GCC might optimize the store to @code{x} away:
@example @smallexample
int foo () int foo ()
@{ @{
int x = 42; int x = 42;
...@@ -3626,7 +3626,7 @@ int foo () ...@@ -3626,7 +3626,7 @@ int foo ()
"=&d" (r) : "a" (y), "m" (*y)); "=&d" (r) : "a" (y), "m" (*y));
return result; return result;
@} @}
@end example @end smallexample
You can put multiple assembler instructions together in a single You can put multiple assembler instructions together in a single
@code{asm} template, separated by the characters normally used in assembly @code{asm} template, separated by the characters normally used in assembly
...@@ -9246,14 +9246,14 @@ namespace std @{ ...@@ -9246,14 +9246,14 @@ namespace std @{
template <class T> struct A @{ @}; template <class T> struct A @{ @};
@} @}
using namespace debug __attribute ((__strong__)); using namespace debug __attribute ((__strong__));
template <> struct A<int> @{ @}; // ok to specialize template <> struct A<int> @{ @}; // @r{ok to specialize}
template <class T> void f (A<T>); template <class T> void f (A<T>);
@} @}
int main() int main()
@{ @{
f (std::A<float>()); // lookup finds std::f f (std::A<float>()); // @r{lookup finds} std::f
f (std::A<int>()); f (std::A<int>());
@} @}
@end smallexample @end smallexample
...@@ -9270,7 +9270,7 @@ Sample problematic code is: ...@@ -9270,7 +9270,7 @@ Sample problematic code is:
@smallexample @smallexample
struct S @{ ~S(); @}; struct S @{ ~S(); @};
extern void bar(); // is written in Java, and may throw exceptions extern void bar(); // @r{is written in Java, and may throw exceptions}
void foo() void foo()
@{ @{
S s; S s;
......
...@@ -771,16 +771,16 @@ instruction operands on a RISC machine. ...@@ -771,16 +771,16 @@ instruction operands on a RISC machine.
This is a slight variant on @code{register_operand} which works around This is a slight variant on @code{register_operand} which works around
a limitation in the machine-description reader. a limitation in the machine-description reader.
@example @smallexample
(match_operand @var{n} "pmode_register_operand" @var{constraint}) (match_operand @var{n} "pmode_register_operand" @var{constraint})
@end example @end smallexample
@noindent @noindent
means exactly what means exactly what
@example @smallexample
(match_operand:P @var{n} "register_operand" @var{constraint}) (match_operand:P @var{n} "register_operand" @var{constraint})
@end example @end smallexample
@noindent @noindent
would mean, if the machine-description reader accepted @samp{:P} would mean, if the machine-description reader accepted @samp{:P}
......
...@@ -1193,7 +1193,7 @@ marked as an alias tag and added to the alias set of TMT@. ...@@ -1193,7 +1193,7 @@ marked as an alias tag and added to the alias set of TMT@.
For instance, consider the following function: For instance, consider the following function:
@example @smallexample
foo (int i) foo (int i)
@{ @{
int *p, *q, a, b; int *p, *q, a, b;
...@@ -1208,7 +1208,7 @@ foo (int i) ...@@ -1208,7 +1208,7 @@ foo (int i)
a = b + 2; a = b + 2;
return *p; return *p;
@} @}
@end example @end smallexample
After aliasing analysis has finished, the type memory tag for After aliasing analysis has finished, the type memory tag for
pointer @code{p} will have two aliases, namely variables @code{a} and pointer @code{p} will have two aliases, namely variables @code{a} and
...@@ -1216,7 +1216,7 @@ pointer @code{p} will have two aliases, namely variables @code{a} and ...@@ -1216,7 +1216,7 @@ pointer @code{p} will have two aliases, namely variables @code{a} and
Every time pointer @code{p} is dereferenced, we want to mark the Every time pointer @code{p} is dereferenced, we want to mark the
operation as a potential reference to @code{a} and @code{b}. operation as a potential reference to @code{a} and @code{b}.
@example @smallexample
foo (int i) foo (int i)
@{ @{
int *p, a, b; int *p, a, b;
...@@ -1239,7 +1239,7 @@ foo (int i) ...@@ -1239,7 +1239,7 @@ foo (int i)
# VUSE <b_8>; # VUSE <b_8>;
return *p_1; return *p_1;
@} @}
@end example @end smallexample
In certain cases, the list of may aliases for a pointer may grow In certain cases, the list of may aliases for a pointer may grow
too large. This may cause an explosion in the number of virtual too large. This may cause an explosion in the number of virtual
......
...@@ -910,11 +910,11 @@ of instantiation. For example, consider ...@@ -910,11 +910,11 @@ of instantiation. For example, consider
struct A @{ struct A @{
template <typename T> template <typename T>
void f () @{ void f () @{
foo (1); // 1 foo (1); // @r{1}
int i = N; // 2 int i = N; // @r{2}
T t; T t;
t.bar(); // 3 t.bar(); // @r{3}
foo (t); // 4 foo (t); // @r{4}
@} @}
static const int N; static const int N;
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment