[RFC PATCH] gas: correct .bss documentation for non-ELF

Nick Clifton nickc@redhat.com
Mon Nov 27 11:27:58 GMT 2023


Hi Jan,

> Only ELF permits the specification of a subsection.

Patch approved - obviously.

> Except for H8 this doesn't look to have any effect, because all.texi
> blindly enables various object formats. Yet still the documentation ends
> up wrong for non-ELF targets.

Although the text in the node does mention that subsections are only
support for ELF based targets.

One question:

> +@ifset ELF
>   @node Bss
>   @section @code{.bss @var{subsection}}
> +@end ifset
> +@ifclear ELF
> +@node Bss
> +@section @code{.bss}
> +@end ifclear
>   @cindex @code{bss} directive

Does the texi format care that there are two instances of "@node Bss" ?
I assume not and that you have tested it.  It just seemed a little counter
intuitive to me.  I would have thought:

   @node Bss
   @ifset ELF
   @section @code{.bss @var{subsection}}
   @end ifset
   @ifclear ELF
   @section @code{.bss}
   @end ifclear

Would be a slightly simpler arrangement.  Not that it matters really.

Cheers
   Nick



More information about the Binutils mailing list