Re: Documentation for .largecomm and friends

Re: Documentation for .largecomm and friends

[Nick Clifton]

Hi H.J., Hi Jan,

  Any objections to this patch for PR 22553 ?

Cheers
  Nick

diff --git a/gas/doc/c-i386.texi b/gas/doc/c-i386.texi
index 91f5c5a21a..e500e7c86d 100644
--- a/gas/doc/c-i386.texi
+++ b/gas/doc/c-i386.texi
@@ -431,8 +431,17 @@ specifies the desired alignment of the symbol in the bss section.
 
 This directive is only available for COFF based x86 targets.
 
+@cindex @code{largecomm} directive, ELF
+@item .largecomm @var{symbol} , @var{length}[, @var{alignment}]
+This directive behaves in the same way as the @code{comm} directive
+except that the data is placed into the @var{.lbss} section instead of
+the @var{.bss} section @ref{Comm}.
+
+The directive is intended to be used for data which requires a large
+amount of space, and it is only available for ELF based x86_64
+targets.
+
 @c FIXME: Document other x86 specific directives ?  Eg: .code16gcc,
-@c .largecomm
 
 @end table
 

Re: Documentation for .largecomm and friends

[Jan Beulich]

>>> On 04.01.18 at 16:28, <nickc@redhat.com> wrote:
> Hi H.J., Hi Jan,
> 
>   Any objections to this patch for PR 22553 ?

Sounds plausible, thanks for doing this. What about "and friends"
though?

Jan

> --- a/gas/doc/c-i386.texi
> +++ b/gas/doc/c-i386.texi
> @@ -431,8 +431,17 @@ specifies the desired alignment of the symbol in the 
> bss section.
>  
>  This directive is only available for COFF based x86 targets.
>  
> +@cindex @code{largecomm} directive, ELF
> +@item .largecomm @var{symbol} , @var{length}[, @var{alignment}]
> +This directive behaves in the same way as the @code{comm} directive
> +except that the data is placed into the @var{.lbss} section instead of
> +the @var{.bss} section @ref{Comm}.
> +
> +The directive is intended to be used for data which requires a large
> +amount of space, and it is only available for ELF based x86_64
> +targets.
> +
>  @c FIXME: Document other x86 specific directives ?  Eg: .code16gcc,
> -@c .largecomm
>  
>  @end table
>  

Re: Documentation for .largecomm and friends

[Nick Clifton]

Hi Jan,

>>   Any objections to this patch for PR 22553 ?
> 
> Sounds plausible, thanks for doing this. What about "and friends"
> though?

The PR also refers to .lbss, .ldata and .lrodata, but I think that
the reporter was mistaken about those.

There is a comment in gas/doc/c-i386.texi mentioning that .code16gcc
is not documented, and a scan of the code indicates that .secrel32,
.operand_check, .sse_check, .disallow_index_reg, and .allow_index_reg
are also missing documentation.

Cheers
  Nick