2011-01-07 Michael Snyder <msnyder@vmware.com>
[deliverable/binutils-gdb.git] / gdb / gdbtypes.h
index 0353f962b200636bacdc24a4cd95e2ad04f27d1b..108206b7c81db6f6ec3e131fc798da71089732eb 100644 (file)
@@ -87,7 +87,7 @@ enum type_code
     TYPE_CODE_VOID,
 
     TYPE_CODE_SET,             /* Pascal sets */
-    TYPE_CODE_RANGE,           /* Range (integers within spec'd bounds) */
+    TYPE_CODE_RANGE,           /* Range (integers within spec'd bounds) */
 
     /* A string type which is like an array of character but prints
        differently (at least for (the deleted) CHILL).  It does not
@@ -190,13 +190,13 @@ enum type_instance_flag_value
 };
 
 /* Unsigned integer type.  If this is not set for a TYPE_CODE_INT, the
-   type is signed (unless TYPE_FLAG_NOSIGN (below) is set). */
+   type is signed (unless TYPE_FLAG_NOSIGN (below) is set).  */
 
 #define TYPE_UNSIGNED(t)       (TYPE_MAIN_TYPE (t)->flag_unsigned)
 
 /* No sign for this type.  In C++, "char", "signed char", and "unsigned
    char" are distinct types; so we need an extra flag to indicate the
-   absence of a sign! */
+   absence of a sign!  */
 
 #define TYPE_NOSIGN(t)         (TYPE_MAIN_TYPE (t)->flag_nosign)
 
@@ -210,21 +210,21 @@ enum type_instance_flag_value
    be updated if it gets un-stubbed in check_typedef.
    Used for arrays and ranges, in which TYPE_LENGTH of the array/range
    gets set based on the TYPE_LENGTH of the target type.
-   Also, set for TYPE_CODE_TYPEDEF. */
+   Also, set for TYPE_CODE_TYPEDEF.  */
 
 #define TYPE_TARGET_STUB(t)    (TYPE_MAIN_TYPE (t)->flag_target_stub)
 
 /* Static type.  If this is set, the corresponding type had 
- * a static modifier.
- * Note: This may be unnecessary, since static data members
- * are indicated by other means (bitpos == -1)
- */
+   a static modifier.
+   Note: This may be unnecessary, since static data members
+   are indicated by other means (bitpos == -1).  */
 
 #define TYPE_STATIC(t)         (TYPE_MAIN_TYPE (t)->flag_static)
 
-/* This is a function type which appears to have a prototype.  We need this
-   for function calls in order to tell us if it's necessary to coerce the args,
-   or to just do the standard conversions.  This is used with a short field. */
+/* This is a function type which appears to have a prototype.  We need
+   this for function calls in order to tell us if it's necessary to
+   coerce the args, or to just do the standard conversions.  This is
+   used with a short field.  */
 
 #define TYPE_PROTOTYPED(t)     (TYPE_MAIN_TYPE (t)->flag_prototyped)
 
@@ -234,7 +234,7 @@ enum type_instance_flag_value
    (Mostly intended for HP platforms, where class methods, for
    instance, can be encountered before their classes in the debug
    info; the incomplete type has to be marked so that the class and
-   the method can be assigned correct types.) */
+   the method can be assigned correct types.)  */
 
 #define TYPE_INCOMPLETE(t)     (TYPE_MAIN_TYPE (t)->flag_incomplete)
 
@@ -255,7 +255,7 @@ enum type_instance_flag_value
    connected by naming conventions.  This flag indicates that the 
    type is an ordinary (unencoded) GDB type that has been created from 
    the necessary run-time information, and does not need further 
-   interpretation. Optionally marks ordinary, fixed-size GDB type. */
+   interpretation.  Optionally marks ordinary, fixed-size GDB type.  */
 
 #define TYPE_FIXED_INSTANCE(t) (TYPE_MAIN_TYPE (t)->flag_fixed_instance)
 
@@ -286,14 +286,12 @@ enum type_instance_flag_value
 #define TYPE_DECLARED_CLASS(t) (TYPE_MAIN_TYPE (t)->flag_declared_class)
 
 /* Constant type.  If this is set, the corresponding type has a
- * const modifier.
- */
+   const modifier.  */
 
 #define TYPE_CONST(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CONST)
 
 /* Volatile type.  If this is set, the corresponding type has a
- * volatile modifier.
- */
+   volatile modifier.  */
 
 #define TYPE_VOLATILE(t) \
   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_VOLATILE)
@@ -371,7 +369,7 @@ enum type_specific_kind
 
 struct main_type
 {
-  /* Code for kind of type */
+  /* Code for kind of type */
 
   ENUM_BITFIELD(type_code) code : 8;
 
@@ -447,7 +445,7 @@ struct main_type
      existing type, but to do this we need a backpointer to the objfile
      from the existing type.  Yes this is somewhat ugly, but without
      major overhaul of the internal type system, it can't be avoided
-     for now. */
+     for now.  */
 
   union type_owner
     {
@@ -494,13 +492,13 @@ struct main_type
           targets, it is the bit offset to the MSB.  For
           gdbarch_bits_big_endian=0 targets, it is the bit offset to
           the LSB.  For a range bound or enum value, this is the
-          value itself. */
+          value itself.  */
 
        int bitpos;
 
        /* For a static field, if TYPE_FIELD_STATIC_HAS_ADDR then physaddr
           is the location (in the target) of the static field.
-          Otherwise, physname is the mangled label of the static field. */
+          Otherwise, physname is the mangled label of the static field.  */
 
        CORE_ADDR physaddr;
        char *physname;
@@ -537,15 +535,15 @@ struct main_type
       char *name;
     } *fields;
 
-    /* Union member used for range types. */
+    /* Union member used for range types.  */
 
     struct range_bounds
     {
-      /* Low bound of range. */
+      /* Low bound of range.  */
 
       LONGEST low;
 
-      /* High bound of range. */
+      /* High bound of range.  */
 
       LONGEST high;
 
@@ -580,7 +578,7 @@ struct main_type
   {
     /* CPLUS_STUFF is for TYPE_CODE_STRUCT.  It is initialized to point to
        cplus_struct_default, a default static instance of a struct
-       cplus_struct_type. */
+       cplus_struct_type.  */
 
     struct cplus_struct_type *cplus_stuff;
 
@@ -680,7 +678,7 @@ struct cplus_struct_type
     short n_baseclasses;
 
     /* Number of methods with unique names.  All overloaded methods with
-       the same name count only once. */
+       the same name count only once.  */
 
     short nfn_fields;
 
@@ -710,26 +708,26 @@ struct cplus_struct_type
        class C : public B, public virtual A {};
 
        B is a baseclass of C; A is a virtual baseclass for C.
-       This is a C++ 2.0 language feature. */
+       This is a C++ 2.0 language feature.  */
 
     B_TYPE *virtual_field_bits;
 
     /* For classes with private fields, the number of fields is given by
        nfields and private_field_bits is a bit vector containing one bit
        per field.
-       If the field is private, the corresponding bit will be set. */
+       If the field is private, the corresponding bit will be set.  */
 
     B_TYPE *private_field_bits;
 
     /* For classes with protected fields, the number of fields is given by
        nfields and protected_field_bits is a bit vector containing one bit
        per field.
-       If the field is private, the corresponding bit will be set. */
+       If the field is private, the corresponding bit will be set.  */
 
     B_TYPE *protected_field_bits;
 
-    /* for classes with fields to be ignored, either this is optimized out
-       or this field has length 0 */
+    /* For classes with fields to be ignored, either this is optimized out
+       or this field has length 0 */
 
     B_TYPE *ignore_field_bits;
 
@@ -738,7 +736,7 @@ struct cplus_struct_type
        arguments that the method expects, and then the name after it
        has been renamed to make it distinct.
 
-       fn_fieldlists points to an array of nfn_fields of these. */
+       fn_fieldlists points to an array of nfn_fields of these.  */
 
     struct fn_fieldlist
       {
@@ -771,18 +769,18 @@ struct cplus_struct_type
 
            /* The function type for the method.
               (This comment used to say "The return value of the method",
-              but that's wrong. The function type 
+              but that's wrong.  The function type 
               is expected here, i.e. something with TYPE_CODE_FUNC,
-              and *not* the return-value type). */
+              and *not* the return-value type).  */
 
            struct type *type;
 
            /* For virtual functions.
-              First baseclass that defines this virtual function.   */
+              First baseclass that defines this virtual function.  */
 
            struct type *fcontext;
 
-           /* Attributes. */
+           /* Attributes.  */
 
            unsigned int is_const:1;
            unsigned int is_volatile:1;
@@ -817,8 +815,7 @@ struct cplus_struct_type
      *fn_fieldlists;
 
     /* Pointer to information about enclosing scope, if this is a
-     * local type.  If it is not a local type, this is NULL
-     */
+       local type.  If it is not a local type, this is NULL. */
     struct local_type_info
       {
        char *file;
@@ -845,7 +842,7 @@ struct cplus_struct_type
     struct symbol **template_arguments;
   };
 
-/* Struct used in computing virtual base list */
+/* Struct used in computing virtual base list */
 struct vbase
   {
     struct type *vbasetype;    /* pointer to virtual base */
@@ -861,12 +858,12 @@ struct rank
        rank, subrank is used to differentiate the two.
        Eg: Two derived-class-pointer to base-class-pointer conversions would
        both have base pointer conversion rank, but the conversion with the
-       shorter distance to the ancestor is preferable. 'subrank' would be used
+       shorter distance to the ancestor is preferable.  'subrank' would be used
        to reflect that.  */
     short subrank;
   };
 
-/* Struct used for ranking a function for overload resolution */
+/* Struct used for ranking a function for overload resolution */
 struct badness_vector
   {
     int length;
@@ -883,7 +880,7 @@ struct gnat_aux_type
   };
 
 /* The default value of TYPE_CPLUS_SPECIFIC(T) points to the
-   this shared static structure. */
+   this shared static structure.  */
 
 extern const struct cplus_struct_type cplus_struct_default;
 
@@ -927,7 +924,7 @@ extern void allocate_gnat_aux_type (struct type *);
    calls check_typedef, TYPE_LENGTH (VALUE_TYPE (X)) is safe.  */
 #define TYPE_LENGTH(thistype) (thistype)->length
 /* Note that TYPE_CODE can be TYPE_CODE_TYPEDEF, so if you want the real
-   type, you need to do TYPE_CODE (check_type (this_type)). */
+   type, you need to do TYPE_CODE (check_type (this_type)).  */
 #define TYPE_CODE(thistype) TYPE_MAIN_TYPE(thistype)->code
 #define TYPE_NFIELDS(thistype) TYPE_MAIN_TYPE(thistype)->nfields
 #define TYPE_FIELDS(thistype) TYPE_MAIN_TYPE(thistype)->flds_bnds.fields
@@ -941,7 +938,7 @@ extern void allocate_gnat_aux_type (struct type *);
 #define TYPE_HIGH_BOUND_UNDEFINED(range_type) \
    TYPE_RANGE_DATA(range_type)->high_undefined
 
-/* Moto-specific stuff for FORTRAN arrays */
+/* Moto-specific stuff for FORTRAN arrays */
 
 #define TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED(arraytype) \
    TYPE_HIGH_BOUND_UNDEFINED(TYPE_INDEX_TYPE(arraytype))
@@ -1247,12 +1244,12 @@ extern const struct floatformat *floatformats_ibm_long_double[BFD_ENDIAN_UNKNOWN
 
 /* Allocate space for storing data associated with a particular type.
    We ensure that the space is allocated using the same mechanism that
-   was used to allocate the space for the type structure itself.  I.E.
+   was used to allocate the space for the type structure itself.  I.e.
    if the type is on an objfile's objfile_obstack, then the space for data
    associated with that type will also be allocated on the objfile_obstack.
    If the type is not associated with any particular objfile (such as
    builtin types), then the data space will be allocated with xmalloc,
-   the same as for the type structure. */
+   the same as for the type structure.  */
 
 #define TYPE_ALLOC(t,size)  \
    (TYPE_OBJFILE_OWNED (t) \
@@ -1417,41 +1414,41 @@ extern int is_unique_ancestor (struct type *, struct value *);
 
 #define LENGTH_MATCH(bv) ((bv)->rank[0])
 
-/* Badness if parameter list length doesn't match arg list length */
+/* Badness if parameter list length doesn't match arg list length */
 extern const struct rank LENGTH_MISMATCH_BADNESS;
 
-/* Dummy badness value for nonexistent parameter positions */
+/* Dummy badness value for nonexistent parameter positions */
 extern const struct rank TOO_FEW_PARAMS_BADNESS;
-/* Badness if no conversion among types */
+/* Badness if no conversion among types */
 extern const struct rank INCOMPATIBLE_TYPE_BADNESS;
 
 /* Badness of an exact match.  */
 extern const struct rank EXACT_MATCH_BADNESS;
 
-/* Badness of integral promotion */
+/* Badness of integral promotion */
 extern const struct rank INTEGER_PROMOTION_BADNESS;
-/* Badness of floating promotion */
+/* Badness of floating promotion */
 extern const struct rank FLOAT_PROMOTION_BADNESS;
 /* Badness of converting a derived class pointer
    to a base class pointer.  */
 extern const struct rank BASE_PTR_CONVERSION_BADNESS;
-/* Badness of integral conversion */
+/* Badness of integral conversion */
 extern const struct rank INTEGER_CONVERSION_BADNESS;
-/* Badness of floating conversion */
+/* Badness of floating conversion */
 extern const struct rank FLOAT_CONVERSION_BADNESS;
-/* Badness of integer<->floating conversions */
+/* Badness of integer<->floating conversions */
 extern const struct rank INT_FLOAT_CONVERSION_BADNESS;
-/* Badness of conversion of pointer to void pointer */
+/* Badness of conversion of pointer to void pointer */
 extern const struct rank VOID_PTR_CONVERSION_BADNESS;
 /* Badness of conversion of pointer to boolean.  */
 extern const struct rank BOOL_PTR_CONVERSION_BADNESS;
-/* Badness of converting derived to base class */
+/* Badness of converting derived to base class */
 extern const struct rank BASE_CONVERSION_BADNESS;
-/* Badness of converting from non-reference to reference */
+/* Badness of converting from non-reference to reference */
 extern const struct rank REFERENCE_CONVERSION_BADNESS;
 
 /* Non-standard conversions allowed by the debugger */
-/* Converting a pointer to an int is usually OK */
+/* Converting a pointer to an int is usually OK */
 extern const struct rank NS_POINTER_CONVERSION_BADNESS;
 
 
This page took 0.035542 seconds and 4 git commands to generate.