From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-lj1-x235.google.com (mail-lj1-x235.google.com [IPv6:2a00:1450:4864:20::235]) by sourceware.org (Postfix) with ESMTPS id 7DF913875424 for ; Fri, 15 Dec 2023 12:16:59 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 7DF913875424 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 7DF913875424 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2a00:1450:4864:20::235 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1702642621; cv=none; b=QLnlFMP8BEq8de6JQQNY6nqjM9J9/ybx2xyZgri5/hio8B8vGcD78RLBOQFlnaWgrCkTBLE04ktVmJd2x+o4OBu09jPOonCfUaKyjBh3PGtpZbVHIDIK/KldLAuaXdGXjbDeJeE/hlgIa9fmWpMSKSg/KcaHFhR0RACkxI7RUbE= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1702642621; c=relaxed/simple; bh=nynZp+pRoER5LGPlhOBnHXPO2t/CWQzqmFLpTT8/eUA=; h=DKIM-Signature:Message-ID:Date:MIME-Version:Subject:From:To; b=FETWHLE3zhC39o8PqDH58WHQVn8XpmdgHHCRbc14ur1Nl5fMkQJorTl8UUddRx2MaiBh0sMGhko35fQAsa6aEX1/m0TNAZ3he0yJpcjF1X8XS/VIJwi+8nRyFXwtxafTG7PG2jyuxOW5ggOEE7wLZtqqmKHvUxdDcORDBRWUZ0Q= ARC-Authentication-Results: i=1; server2.sourceware.org Received: by mail-lj1-x235.google.com with SMTP id 38308e7fff4ca-2cc47f1e829so6879911fa.1 for ; Fri, 15 Dec 2023 04:16:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1702642618; x=1703247418; darn=sourceware.org; h=content-transfer-encoding:in-reply-to:autocrypt:references:cc:to :from:content-language:subject:user-agent:mime-version:date :message-id:from:to:cc:subject:date:message-id:reply-to; bh=x/sjeHV338LEDdesI46QpKdxDNrP5UjQ4N2f8fqgEyY=; b=MYsDqpyBUndnMtjZJsHzChQS64dP+6QqFOGSKMbvLLrXwBxK5zEVjWjhrAoda+C0/x n98VuU5rArxHKwo8y1XWqRkvmKh02F01htf0IGIElNjPmyFx+jrVTD1qKYdOlrucGeYd Xz163i1Y9Qi/xONdu7LP2f/yEbFH1fbWq3WiSEN8cMa41B7hZPHWapPUz4tvITeznvlT A/jxE8iJ6Nibnbb0iovYmE94/l+BiaU50yITiSBCaa0vGdKCwSAMXtSPekMSZG8roWfw cV4HZBzqnNWPhiaFmpMBo+t6/pWpIlc9p3p61Bf7ql0QF53JlVipNlnlUdawI3JQS9lX KThA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702642618; x=1703247418; h=content-transfer-encoding:in-reply-to:autocrypt:references:cc:to :from:content-language:subject:user-agent:mime-version:date :message-id:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=x/sjeHV338LEDdesI46QpKdxDNrP5UjQ4N2f8fqgEyY=; b=Y7fma0gt2/aYQp8Mhp+BOpsdVwKH3MJIf4GcMbOXwDhHKnEMPnrH3LHLIcoyhibjZI QyVlAOO4rytaVSjND3GrR+i5VNsDX0x4U8XlX9dsQifhIYRsZjASGAbeOe/ux30Ye/Ju HRl0VnABNcjVwYr9PD6ENaOzGBAp9alFYkIqrp5MDG5b2ddKHGdT1QI3sazbvu18wW6B zZIQwB4QsOiFVsCiwlRbOPQew5hC/GB38BqO1pmaUKobYrpGOQm9tJz7xgehskMh8J3g 5xcatADzOARvImPqnc/4P9ZwmrSKIliNoRu7NXB91x5heV40Jb9z+fcUOx9MSHUzbX82 A5ZQ== X-Gm-Message-State: AOJu0YxFb2B0MID3A3WCsCBsuLP36gzuflf8Gg8tkU8cZ1x8SRfvqS6D fbV25dpSLduneAzJQtGUgRAVoYpNnGBR+Ktw8lQX X-Google-Smtp-Source: AGHT+IG7BhGZw0WOYgIo+qJEAdE/7gC+Kro5c7B9QMZoEaH2OJccxPbf6sBkjToie0DkyOwro1eu3A== X-Received: by 2002:a2e:a233:0:b0:2cc:4041:588e with SMTP id i19-20020a2ea233000000b002cc4041588emr1656214ljm.86.1702642618070; Fri, 15 Dec 2023 04:16:58 -0800 (PST) Received: from [10.156.60.236] (ip-037-024-206-209.um08.pools.vodafone-ip.de. [37.24.206.209]) by smtp.gmail.com with ESMTPSA id k9-20020a056e02156900b0035da74cd896sm4764564ilu.77.2023.12.15.04.16.56 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 15 Dec 2023 04:16:57 -0800 (PST) Message-ID: <941ec65d-0c3b-43b3-89a5-3de6b70a4ad0@suse.com> Date: Fri, 15 Dec 2023 13:16:56 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: [PATCH 16/22] gas: correct .bss documentation for non-ELF Content-Language: en-US From: Jan Beulich To: Binutils Cc: Nick Clifton , Alan Modra References: <5e1fe3bc-78ca-4c54-a19c-f8efa015f839@suse.com> Autocrypt: addr=jbeulich@suse.com; keydata= xsDiBFk3nEQRBADAEaSw6zC/EJkiwGPXbWtPxl2xCdSoeepS07jW8UgcHNurfHvUzogEq5xk hu507c3BarVjyWCJOylMNR98Yd8VqD9UfmX0Hb8/BrA+Hl6/DB/eqGptrf4BSRwcZQM32aZK 7Pj2XbGWIUrZrd70x1eAP9QE3P79Y2oLrsCgbZJfEwCgvz9JjGmQqQkRiTVzlZVCJYcyGGsD /0tbFCzD2h20ahe8rC1gbb3K3qk+LpBtvjBu1RY9drYk0NymiGbJWZgab6t1jM7sk2vuf0Py O9Hf9XBmK0uE9IgMaiCpc32XV9oASz6UJebwkX+zF2jG5I1BfnO9g7KlotcA/v5ClMjgo6Gl MDY4HxoSRu3i1cqqSDtVlt+AOVBJBACrZcnHAUSuCXBPy0jOlBhxPqRWv6ND4c9PH1xjQ3NP nxJuMBS8rnNg22uyfAgmBKNLpLgAGVRMZGaGoJObGf72s6TeIqKJo/LtggAS9qAUiuKVnygo 3wjfkS9A3DRO+SpU7JqWdsveeIQyeyEJ/8PTowmSQLakF+3fote9ybzd880fSmFuIEJldWxp Y2ggPGpiZXVsaWNoQHN1c2UuY29tPsJgBBMRAgAgBQJZN5xEAhsDBgsJCAcDAgQVAggDBBYC AwECHgECF4AACgkQoDSui/t3IH4J+wCfQ5jHdEjCRHj23O/5ttg9r9OIruwAn3103WUITZee e7Sbg12UgcQ5lv7SzsFNBFk3nEQQCACCuTjCjFOUdi5Nm244F+78kLghRcin/awv+IrTcIWF hUpSs1Y91iQQ7KItirz5uwCPlwejSJDQJLIS+QtJHaXDXeV6NI0Uef1hP20+y8qydDiVkv6l IreXjTb7DvksRgJNvCkWtYnlS3mYvQ9NzS9PhyALWbXnH6sIJd2O9lKS1Mrfq+y0IXCP10eS FFGg+Av3IQeFatkJAyju0PPthyTqxSI4lZYuJVPknzgaeuJv/2NccrPvmeDg6Coe7ZIeQ8Yj t0ARxu2xytAkkLCel1Lz1WLmwLstV30g80nkgZf/wr+/BXJW/oIvRlonUkxv+IbBM3dX2OV8 AmRv1ySWPTP7AAMFB/9PQK/VtlNUJvg8GXj9ootzrteGfVZVVT4XBJkfwBcpC/XcPzldjv+3 HYudvpdNK3lLujXeA5fLOH+Z/G9WBc5pFVSMocI71I8bT8lIAzreg0WvkWg5V2WZsUMlnDL9 mpwIGFhlbM3gfDMs7MPMu8YQRFVdUvtSpaAs8OFfGQ0ia3LGZcjA6Ik2+xcqscEJzNH+qh8V m5jjp28yZgaqTaRbg3M/+MTbMpicpZuqF4rnB0AQD12/3BNWDR6bmh+EkYSMcEIpQmBM51qM EKYTQGybRCjpnKHGOxG0rfFY1085mBDZCH5Kx0cl0HVJuQKC+dV2ZY5AqjcKwAxpE75MLFkr wkkEGBECAAkFAlk3nEQCGwwACgkQoDSui/t3IH7nnwCfcJWUDUFKdCsBH/E5d+0ZnMQi+G0A nAuWpQkjM1ASeQwSHEeAWPgskBQL In-Reply-To: <5e1fe3bc-78ca-4c54-a19c-f8efa015f839@suse.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-3026.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS,TXREP,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Only ELF permits the specification of a subsection, and even there not consistently: csky, mcore, and spu handle .bss similar to .lcomm. --- 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. --- v1: Mention exceptions. --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -4456,7 +4456,12 @@ Some machine configurations provide addi * Asciz:: @code{.asciz "@var{string}"}@dots{} * Attach_to_group:: @code{.attach_to_group @var{name}} * Balign:: @code{.balign [@var{abs-expr}[, @var{abs-expr}]]} +@ifset ELF * Bss:: @code{.bss @var{subsection}} +@end ifset +@ifclear ELF +* Bss:: @code{.bss} +@end ifclear * Bundle directives:: @code{.bundle_align_mode @var{abs-expr}}, etc * Byte:: @code{.byte @var{expressions}} * CFI directives:: @code{.cfi_startproc [simple]}, @code{.cfi_endproc}, etc. @@ -4801,14 +4806,20 @@ filled in with the value 0x368d (the exa the endianness of the processor). If it skips 1 or 3 bytes, the fill value is undefined. +@ifset ELF @node Bss @section @code{.bss @var{subsection}} +@end ifset +@ifclear ELF +@node Bss +@section @code{.bss} +@end ifclear @cindex @code{bss} directive @code{.bss} tells @command{@value{AS}} to assemble the following statements onto the end of the bss section. @ifset ELF -For ELF based targets an optional @var{subsection} expression (which must +For most ELF based targets an optional @var{subsection} expression (which must evaluate to a positive integer) can be provided. In this case the statements are appended to the end of the indicated bss subsection. @end ifset