[hellogcc] [patch 1 generic.texi] Update gccint-zh trunk to upstreams r179462
- From: Yao Qi <qiyaoltc@xxxxxxxxx>
- To: hellogcc@xxxxxxxxxxxxx
- Date: Fri, 7 Oct 2011 21:56:20 +0800
On Fri, Oct 07, 2011 at 09:47:15PM +0800, Yao Qi wrote:
> 这个patch是fsf gcc doc目录下边和gccint有关文件从 r170935到
> r179462的修改。我们gccint-zh trunk也是根据这个patch进行修改。
>
>
> Index: generic.texi
> ===================================================================
> --- generic.texi (revision 170935)
> +++ generic.texi (revision 179462)
> @@ -621,7 +621,7 @@
> @menu
> * Working with declarations:: Macros and functions that work on
> declarations.
> -* Internal structure:: How declaration nodes are represented.
> +* Internal structure:: How declaration nodes are represented.
> @end menu
>
> @node Working with declarations
> @@ -734,11 +734,11 @@
>
> @item FIELD_DECL
> These nodes represent non-static data members. The @code{DECL_SIZE} and
> -@code{DECL_ALIGN} behave as for @code{VAR_DECL} nodes.
> -The position of the field within the parent record is specified by a
> +@code{DECL_ALIGN} behave as for @code{VAR_DECL} nodes.
> +The position of the field within the parent record is specified by a
> combination of three attributes. @code{DECL_FIELD_OFFSET} is the position,
> counting in bytes, of the @code{DECL_OFFSET_ALIGN}-bit sized word containing
> -the bit of the field closest to the beginning of the structure.
> +the bit of the field closest to the beginning of the structure.
> @code{DECL_FIELD_BIT_OFFSET} is the bit offset of the first bit of the field
> within this word; this may be nonzero even for fields that are not
> bit-fields,
> since @code{DECL_OFFSET_ALIGN} may be greater than the natural alignment
> @@ -810,7 +810,7 @@
>
> @item struct tree_parm_decl
> This structure inherits from @code{struct tree_decl_with_rtl}. It is
> -used to represent @code{PARM_DECL}.
> +used to represent @code{PARM_DECL}.
>
> @item struct tree_decl_with_vis
> This structure inherits from @code{struct tree_decl_with_rtl}. It
> @@ -819,11 +819,11 @@
>
> @item struct tree_var_decl
> This structure inherits from @code{struct tree_decl_with_vis}. It is
> -used to represent @code{VAR_DECL}.
> +used to represent @code{VAR_DECL}.
>
> @item struct tree_function_decl
> This structure inherits from @code{struct tree_decl_with_vis}. It is
> -used to represent @code{FUNCTION_DECL}.
> +used to represent @code{FUNCTION_DECL}.
>
> @end table
> @node Adding new DECL node types
> @@ -1574,8 +1574,8 @@
> @code{POINTER_TYPE}.
>
> The number of arguments to the call is returned by @code{call_expr_nargs},
> -while the arguments themselves can be accessed with the @code{CALL_EXPR_ARG}
> -macro. The arguments are zero-indexed and numbered left-to-right.
> +while the arguments themselves can be accessed with the @code{CALL_EXPR_ARG}
> +macro. The arguments are zero-indexed and numbered left-to-right.
> You can iterate over the arguments using @code{FOR_EACH_CALL_EXPR_ARG}, as
> in:
>
> @smallexample
> @@ -1695,7 +1695,7 @@
> @tindex VEC_PACK_TRUNC_EXPR
> @tindex VEC_PACK_SAT_EXPR
> @tindex VEC_PACK_FIX_TRUNC_EXPR
> -@tindex VEC_EXTRACT_EVEN_EXPR
> +@tindex VEC_EXTRACT_EVEN_EXPR
> @tindex VEC_EXTRACT_ODD_EXPR
> @tindex VEC_INTERLEAVE_HIGH_EXPR
> @tindex VEC_INTERLEAVE_LOW_EXPR
> @@ -1703,8 +1703,8 @@
> @table @code
> @item VEC_LSHIFT_EXPR
> @itemx VEC_RSHIFT_EXPR
> -These nodes represent whole vector left and right shifts, respectively.
> -The first operand is the vector to shift; it will always be of vector type.
> +These nodes represent whole vector left and right shifts, respectively.
> +The first operand is the vector to shift; it will always be of vector type.
> The second operand is an expression for the number of bits by which to
> shift. Note that the result is undefined if the second operand is larger
> than or equal to the first operand's type size.
> @@ -1712,9 +1712,9 @@
> @item VEC_WIDEN_MULT_HI_EXPR
> @itemx VEC_WIDEN_MULT_LO_EXPR
> These nodes represent widening vector multiplication of the high and low
> -parts of the two input vectors, respectively. Their operands are vectors
> -that contain the same number of elements (@code{N}) of the same integral
> type.
> -The result is a vector that contains half as many elements, of an integral
> type
> +parts of the two input vectors, respectively. Their operands are vectors
> +that contain the same number of elements (@code{N}) of the same integral
> type.
> +The result is a vector that contains half as many elements, of an integral
> type
> whose size is twice as wide. In the case of @code{VEC_WIDEN_MULT_HI_EXPR}
> the
> high @code{N/2} elements of the two vector are multiplied to produce the
> vector of @code{N/2} products. In the case of @code{VEC_WIDEN_MULT_LO_EXPR}
> the
> @@ -1724,7 +1724,7 @@
> @item VEC_UNPACK_HI_EXPR
> @itemx VEC_UNPACK_LO_EXPR
> These nodes represent unpacking of the high and low parts of the input
> vector,
> -respectively. The single operand is a vector that contains @code{N}
> elements
> +respectively. The single operand is a vector that contains @code{N} elements
> of the same integral or floating point type. The result is a vector
> that contains half as many elements, of an integral or floating point type
> whose size is twice as wide. In the case of @code{VEC_UNPACK_HI_EXPR} the
> @@ -1770,19 +1770,19 @@
>
> @item VEC_EXTRACT_EVEN_EXPR
> @itemx VEC_EXTRACT_ODD_EXPR
> -These nodes represent extracting of the even/odd elements of the two input
> -vectors, respectively. Their operands and result are vectors that contain
> the
> +These nodes represent extracting of the even/odd elements of the two input
> +vectors, respectively. Their operands and result are vectors that contain the
> same number of elements of the same type.
>
> @item VEC_INTERLEAVE_HIGH_EXPR
> @itemx VEC_INTERLEAVE_LOW_EXPR
> These nodes represent merging and interleaving of the high/low elements of
> the
> -two input vectors, respectively. The operands and the result are vectors
> that
> +two input vectors, respectively. The operands and the result are vectors that
> contain the same number of elements (@code{N}) of the same type.
> -In the case of @code{VEC_INTERLEAVE_HIGH_EXPR}, the high @code{N/2} elements
> of
> +In the case of @code{VEC_INTERLEAVE_HIGH_EXPR}, the high @code{N/2} elements
> of
> the first input vector are interleaved with the high @code{N/2} elements of
> the
> second input vector. In the case of @code{VEC_INTERLEAVE_LOW_EXPR}, the low
> -@code{N/2} elements of the first input vector are interleaved with the low
> +@code{N/2} elements of the first input vector are interleaved with the low
> @code{N/2} elements of the second input vector.
>
> @end table
> @@ -2210,7 +2210,9 @@
> @code{OMP_CLAUSE_COPYPRIVATE}, @code{OMP_CLAUSE_IF},
> @code{OMP_CLAUSE_NUM_THREADS}, @code{OMP_CLAUSE_SCHEDULE},
> @code{OMP_CLAUSE_NOWAIT}, @code{OMP_CLAUSE_ORDERED},
> -@code{OMP_CLAUSE_DEFAULT}, and @code{OMP_CLAUSE_REDUCTION}. Each code
> +@code{OMP_CLAUSE_DEFAULT}, @code{OMP_CLAUSE_REDUCTION},
> +@code{OMP_CLAUSE_COLLAPSE}, @code{OMP_CLAUSE_UNTIED},
> +@code{OMP_CLAUSE_FINAL}, and @code{OMP_CLAUSE_MERGEABLE}. Each code
> represents the corresponding OpenMP clause.
>
> Clauses associated with the same directive are chained together
> @@ -2502,7 +2504,7 @@
> @tindex UNKNOWN_TYPE
> @tindex TYPENAME_TYPE
> @tindex TYPEOF_TYPE
> -@findex CP_TYPE_QUALS
> +@findex cp_type_quals
> @findex TYPE_UNQUALIFIED
> @findex TYPE_QUAL_CONST
> @findex TYPE_QUAL_VOLATILE
> @@ -2534,8 +2536,8 @@
>
> The following functions and macros deal with cv-qualification of types:
> @ftable @code
> -@item CP_TYPE_QUALS
> -This macro returns the set of type qualifiers applied to this type.
> +@item cp_type_quals
> +This function returns the set of type qualifiers applied to this type.
> This value is @code{TYPE_UNQUALIFIED} if no qualifiers have been
> applied. The @code{TYPE_QUAL_CONST} bit is set if the type is
> @code{const}-qualified. The @code{TYPE_QUAL_VOLATILE} bit is set if the
> @@ -2616,7 +2618,7 @@
>
> @item POINTER_TYPE
> Used to represent pointer types, and pointer to data member types. If
> -@code{TREE_TYPE}
> +@code{TREE_TYPE}
> is a pointer to data member type, then @code{TYPE_PTRMEM_P} will hold.
> For a pointer to data member type of the form @samp{T X::*},
> @code{TYPE_PTRMEM_CLASS_TYPE} will be the type @code{X}, while
这个都是generic.texi的修改。很多修改都是删除trail space，所以我这里的patch
都没有反应出来。
--
Yao Qi <qiyaoltc AT gmail DOT com>
You're working under a slight handicap. You happen to be human.
Index: generic.texi
===================================================================
--- generic.texi (revision 374)
+++ generic.texi (working copy)
@@ -2937,7 +2937,7 @@
@tindex UNKNOWN_TYPE
@tindex TYPENAME_TYPE
@tindex TYPEOF_TYPE
-@findex CP_TYPE_QUALS
+@findex cp_type_quals
@findex TYPE_UNQUALIFIED
@findex TYPE_QUAL_CONST
@findex TYPE_QUAL_VOLATILE
@@ -2971,14 +2971,14 @@
@en The following functions and macros deal with cv-qualification of types:
下列函数和宏处理cv-qualification的类型：
@ftable @code
-@item CP_TYPE_QUALS
-@en This macro returns the set of type qualifiers applied to this type.
+@item cp_type_quals
+@en This function returns the set of type qualifiers applied to this type.
@en This value is @code{TYPE_UNQUALIFIED} if no qualifiers have been
@en applied. The @code{TYPE_QUAL_CONST} bit is set if the type is
@en @code{const}-qualified. The @code{TYPE_QUAL_VOLATILE} bit is set if the
@en type is @code{volatile}-qualified. The @code{TYPE_QUAL_RESTRICT} bit is
@en set if the type is @code{restrict}-qualified.
-该宏返回应用到该类型的类型限定符集。如果没有应用限定符则该值为@code{TYPE_UNQUALIFIED}。如果类型是@code{const}的，则会设置@code{TYPE_QUAL_CONST}位。如果类型是@code{volatile}的，则会设置@code{TYPE_QUAL_VOLATILE}位。如果类型是@code{restrict}的，则会设置@code{TYPE_QUAL_RESTRICT}位。
+该函数返回应用到该类型的类型限定符集。如果没有应用限定符则该值为@code{TYPE_UNQUALIFIED}。如果类型是@code{const}的，则会设置@code{TYPE_QUAL_CONST}位。如果类型是@code{volatile}的，则会设置@code{TYPE_QUAL_VOLATILE}位。如果类型是@code{restrict}的，则会设置@code{TYPE_QUAL_RESTRICT}位。
@item CP_TYPE_CONST_P
@en This macro holds if the type is @code{const}-qualified.
Other related posts:
- » [hellogcc] [patch 1 generic.texi] Update gccint-zh trunk to upstreams r179462 - Yao Qi
