From patchwork Fri May 22 10:08:06 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Will Hawkins X-Patchwork-Id: 135451 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 3228748F6651 for ; Fri, 22 May 2026 10:08:47 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 3228748F6651 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=obs-cr.20251104.gappssmtp.com header.i=@obs-cr.20251104.gappssmtp.com header.a=rsa-sha256 header.s=20251104 header.b=VcKYLouq X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from mail-oa1-x2b.google.com (mail-oa1-x2b.google.com [IPv6:2001:4860:4864:20::2b]) by sourceware.org (Postfix) with ESMTPS id 352CF4BABF18 for ; Fri, 22 May 2026 10:08:13 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 352CF4BABF18 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=obs.cr Authentication-Results: sourceware.org; spf=none smtp.mailfrom=obs.cr ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 352CF4BABF18 Authentication-Results: sourceware.org; arc=none smtp.remote-ip=2001:4860:4864:20::2b ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1779444493; cv=none; b=VmO2XpxePo+gpS0DzBTL0OvDCkj/JRH8zR873u/NYV6ugpRV2MRs7XcnpoDqoznDNetZzzxdaSbiGS2zcw5jE8jr+IddoE3CW7u5j0qlIYziJBDDO1OKW7PbjexNL+z1ouLpdM2LtXGVhlI3IJi1jKsbFILtgMn9eoOFEOoUdao= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1779444493; c=relaxed/simple; bh=bhLaw/iqLI1ccj32XcAhDk6T5tg6k5cRIKBmhnehH5g=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=T4fm+MqIGPkla3eGgyR726X+eyB9xK2vME6ypuTQG+TG/ttevPp+ljGePF9FOR4JciMDOt0hfhW3A4IE7zvxx7yFSJn+JStRua+Ik7huaEcMvRn0eizvwTjYxyra/rjA1Z7lyq3Y7rS8kV9deDygJMToT3+3VTTm60KLD2D/8Jg= ARC-Authentication-Results: i=1; sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=obs-cr.20251104.gappssmtp.com header.i=@obs-cr.20251104.gappssmtp.com header.a=rsa-sha256 header.s=20251104 header.b=VcKYLouq DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 352CF4BABF18 Received: by mail-oa1-x2b.google.com with SMTP id 586e51a60fabf-43b48e67e54so624977fac.0 for ; Fri, 22 May 2026 03:08:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=obs-cr.20251104.gappssmtp.com; s=20251104; t=1779444492; x=1780049292; darn=sourceware.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=zgum0CKxckI9KPEZ8yd0GnSZ9VOORMsaYgpU+IBaE3o=; b=VcKYLouqz4FufMoWv+sNQuichVGLOb4TJVLJUH1ui0wySXvFOmh3qqrkCpw4saizoX pcZoUiNa8vxJoKbHzY0jef4NKLho6HnnOBGg90jWPJURzJzrePN7cWSeUuRpkPX9A7E+ qblsMYHAChVQSJ1z07XqYZWT4Zkj+OWFlmbGVI8Y6Ah0FrOnn+E67H8RTv2pRLXl/ItB T/81LhnCVQosbOjVY01P3ZvfusqXO/gpoNxG1bchLAVqn/jCUgXVrMeou3KV4wnODuxy vh/O2Z1/lSnGxpire1vRyzq1fqRukBsuK0I/SbY0jB9efAkE1hSYQn5bNffCSfmfolaO I0Gg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779444492; x=1780049292; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=zgum0CKxckI9KPEZ8yd0GnSZ9VOORMsaYgpU+IBaE3o=; b=gTKG0b7YFpYGAW6n4ArnvGe2SayT87r9gk1uLiInUx7KINzwr0l/UD78Sqsb/Nbr+W iWNSHYeHSx20YQVBWBSNnso8pIkw4oe8lTFUifOddTVgrT3jqdntA9x13l3i1lvcBXWL Hq5eRzm0AqGl1xIAYRSVyzyDroakQtkLIypEFK6HXoUGs5VSmJNfBaBEsKVdY5K+qojW t3NcuhoCsDa3IY1zgznmVp7cJMSxbWthIl0djSuZm+UmaIn6RaijSRFUzhkAESe4zquM sgKhT9MXdRm71iEhlmyR99NXkEdCb6MMrZWxd7z96bdg8obNPp/45viNNtVeajLIplll CTxg== X-Gm-Message-State: AOJu0YzHZr27Qdyr+KzfA7uLP5ITXSRYVVs+SEex9g0sfPYokk/PK7VT spbWQEDhoUFsShVPkq3BG8BPrfW6bxXaBYLqX2NTXYOsScHukaY/yA3QNDkktBQVSg/PaTT05sj nxWdRPbM= X-Gm-Gg: Acq92OE9GnyGKbeNsecn8WGJfZGOwrXlNAe/dkZ7S8df2+GcIW0QTycB/Ae2m9TBPbS JpYm2F9LwqOgPYxEGbJXAPT6vDIs71CUnZm/UwsFaAwmP0x6D5KGecpxSafD1TDdCc+05drHNEH 8/RGxgnCZZUx1QNIgn//tD8cpv3PyTHLOjH++5HpNZGUmAAw4BDscxjvhcr80242lS/SACRVgnM FYUT3zWnO+Pfnfb0KuStplOAiYPSfoon+WdWrVrIrUVChc231V+41MMDdV/MS+bz5KcMkDjeXHH 5tT/fmfH3B0M919jja072mrSy+/8p0WIcDHfw2kw16f3RvQ2tY/PU/PuJreYfYGeRCTiUVTz74A aRLnm01MoFzGzXaZJbzKaoINX0l93oe1FM2pIjm2VdKhmxXi+abRBIPMvZp0qIs0mXWyebbjXLf ybCLAO9PiJTXWdOHC/c9o4hmjTSj16uzR/34Mp/wNmy9VRrY3le8+PRNnS0EWc3dtLt82ZCtw95 94q3bu5x8GL5UbeqVK1yfStjCUK6tVkeaScPErQO44UHrLul5BW6hb8iZeFn456IgeV X-Received: by 2002:a05:6870:8e07:b0:428:27a4:ada with SMTP id 586e51a60fabf-43b5ab533c8mr1708713fac.10.1779444492385; Fri, 22 May 2026 03:08:12 -0700 (PDT) Received: from ininer.rhod.uc.edu ([129.137.96.15]) by smtp.gmail.com with ESMTPSA id 586e51a60fabf-43b63976dacsm1344377fac.11.2026.05.22.03.08.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 22 May 2026 03:08:11 -0700 (PDT) From: Will Hawkins To: binutils@sourceware.org Cc: Will Hawkins Subject: [PATCH v2] gas: Clarify documentation about @ and % usage in .section Date: Fri, 22 May 2026 06:08:06 -0400 Message-ID: <20260522100809.829774-1-hawkinsw@obs.cr> X-Mailer: git-send-email 2.49.0 MIME-Version: 1.0 X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_PBL, SPF_HELO_NONE, SPF_NONE, TXREP shortcircuit=no autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on sourceware.org X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: binutils-bounces~patchwork=sourceware.org@sourceware.org In the documentation for the .section Assembler Directive for the ELF format, clarify the instances where @ and % can be used. Signed-off-by: Will Hawkins --- v2: Update text based on mailing list discussion. gas/doc/as.texi | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 3e1d2d0e254..5c80a3100dc 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -7121,9 +7121,10 @@ some targets extend this list with their own types Many targets only support the first three section types. The type may be enclosed in double quotes if necessary. -Note on targets where the @code{@@} character is the start of a comment (eg -ARM) then another character is used instead. For example the ARM port uses the -@code{%} character. +Note - certain targets treat @code{@@} as the start of a comment (e.g., ARM). +On such platforms, @code{%} is used instead. On platforms where neither +@code{@@} nor @code{%} indicate the start of a comment, @code{@@} and +@code{%} may be used interchangeably. Note - some sections, eg @code{.text} and @code{.data} are considered to be special and have fixed types. Any attempt to declare them with a different