aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc/gty.texi
diff options
context:
space:
mode:
authorJanis Johnson <janis187@us.ibm.com>2002-09-04 17:35:59 +0000
committerJanis Johnson <janis@gcc.gnu.org>2002-09-04 17:35:59 +0000
commit478c9e72c61443a0fc32841d05c2251246de88c8 (patch)
treecda38963326438a28584b3d0f047c0ae365275fc /gcc/doc/gty.texi
parent7b98d4549b34d8fe57170ce9fb57f2c1508516dc (diff)
downloadgcc-478c9e72c61443a0fc32841d05c2251246de88c8.zip
gcc-478c9e72c61443a0fc32841d05c2251246de88c8.tar.gz
gcc-478c9e72c61443a0fc32841d05c2251246de88c8.tar.bz2
c-tree.texi: Fix overfull hboxes.
2002-09-04 Janis Johnson <janis187@us.ibm.com> * doc/c-tree.texi: Fix overfull hboxes. * doc/cppopts.texi: Ditto. * doc/extend.texi: Ditto. * doc/gty.texi: Ditto. * doc/invoke.texi: Ditto. * doc/makefile.texi: Ditto. * doc/rtl.texi: Ditto. * doc/standards.texi: Ditto. * doc/tm.texi: Ditto. From-SVN: r56802
Diffstat (limited to 'gcc/doc/gty.texi')
-rw-r--r--gcc/doc/gty.texi29
1 files changed, 16 insertions, 13 deletions
diff --git a/gcc/doc/gty.texi b/gcc/doc/gty.texi
index f854b80..cbd9caa 100644
--- a/gcc/doc/gty.texi
+++ b/gcc/doc/gty.texi
@@ -95,18 +95,21 @@ option is a fragment of C code that calculates the length.
The second case is when a structure or a global variable contains a
pointer to an array, like this:
-@verbatim
- tree * GTY ((length ("%h.regno_pointer_align_length"))) regno_decl;
-@end verbatim
+@smallexample
+tree *
+ GTY ((length ("%h.regno_pointer_align_length"))) regno_decl;
+@end smallexample
In this case, @code{regno_decl} has been allocated by writing something like
-@verbatim
- x->regno_decl = ggc_alloc (x->regno_pointer_align_length * sizeof (tree));
-@end verbatim
+@smallexample
+ x->regno_decl =
+ ggc_alloc (x->regno_pointer_align_length * sizeof (tree));
+@end smallexample
and the @code{length} provides the length of the field.
This second use of @code{length} also works on global variables, like:
@verbatim
-static GTY((length ("reg_base_value_size"))) rtx *reg_base_value;
+ static GTY((length ("reg_base_value_size")))
+ rtx *reg_base_value;
@end verbatim
@findex skip
@@ -126,17 +129,17 @@ field really isn't ever used.
The type machinery needs to be told which field of a @code{union} is
currently active. This is done by giving each field a constant @code{tag}
value, and then specifying a discriminator using @code{desc}. For example,
-@verbatim
+@smallexample
struct tree_binding GTY(())
-{
+@{
struct tree_common common;
- union tree_binding_u {
+ union tree_binding_u @{
tree GTY ((tag ("0"))) scope;
struct cp_binding_level * GTY ((tag ("1"))) level;
- } GTY ((desc ("BINDING_HAS_LEVEL_P ((tree)&%0)"))) scope;
+ @} GTY ((desc ("BINDING_HAS_LEVEL_P ((tree)&%0)"))) scope;
tree value;
-};
-@end verbatim
+@};
+@end smallexample
In the @code{desc} option, the ``current structure'' is the union that
it discriminates. Use @code{%1} to mean the structure containing it.