[Patch Doc] Update documentation for __fp16 type
Sandra Loosemore
sandra@codesourcery.com
Thu Dec 15 16:41:00 GMT 2016
On 12/15/2016 03:27 AM, Jakub Jelinek wrote:
> On Thu, Dec 15, 2016 at 11:23:14AM +0100, Andreas Schwab wrote:
>> On Dez 15 2016, Jakub Jelinek <jakub@redhat.com> wrote:
>>
>>> So, shall we change also the first 3?
>>
>> Yes, I'd think so.
>
> So here is it in patch form. Is this ok for trunk?
>
> 2016-12-15 Jakub Jelinek <jakub@redhat.com>
>
> * doc/extend.texi: Clean up @xref{...} uses.
> * doc/invoke.texi: Likewise.
>
> --- gcc/doc/extend.texi.jj 2016-12-14 20:28:12.000000000 +0100
> +++ gcc/doc/extend.texi 2016-12-15 11:26:07.867736292 +0100
> @@ -1057,7 +1057,7 @@ implements conversions between @code{__f
> calls.
>
> It is recommended that portable code use the @code{_Float16} type defined
> -by ISO/IEC TS 18661-3:2015 (@xref{Floating Types}).
> +by ISO/IEC TS 18661-3:2015. @xref{Floating Types}.
>
> @node Decimal Float
> @section Decimal Floating Types
> @@ -2089,7 +2089,7 @@ union foo f = @{ .d = 4 @};
> converts 4 to a @code{double} to store it in the union using
> the second element. By contrast, casting 4 to type @code{union foo}
> stores it into the union as the integer @code{i}, since it is
> -an integer. (@xref{Cast to Union}.)
> +an integer. @xref{Cast to Union}.
>
> You can combine this technique of naming elements with ordinary C
> initialization of successive elements. Each initializer element that
> @@ -2181,7 +2181,7 @@ specified is a union type. You can spec
> @code{union} keyword or with a @code{typedef} name that refers to
> a union. A cast to a union actually creates a compound literal and
> yields an lvalue, not an rvalue like true casts do.
> -(@xref{Compound Literals}.)
> +@xref{Compound Literals}.
>
> The types that may be cast to the union type are those of the members
> of the union. Thus, given the following union and variables:
> --- gcc/doc/invoke.texi.jj 2016-12-15 10:26:15.000000000 +0100
> +++ gcc/doc/invoke.texi 2016-12-15 11:25:19.226386092 +0100
> @@ -7262,8 +7262,8 @@ release to an another.
> @opindex fno-keep-inline-dllexport
> This is a more fine-grained version of @option{-fkeep-inline-functions},
> which applies only to functions that are declared using the @code{dllexport}
> -attribute or declspec (@xref{Function Attributes,,Declaring Attributes of
> -Functions}.)
> +attribute or declspec. @xref{Function Attributes,,Declaring Attributes of
> +Functions}.
>
> @item -fkeep-inline-functions
> @opindex fkeep-inline-functions
>
This is OK, but FYI it would have been simpler just to do
s/@xref/@pxref/
in the one instance that was causing an diagnostic. Sorry I missed that
in the original patch review. :-(
-Sandra
More information about the Gcc-patches
mailing list