[PATCH v2] gas: Clarify documentation about @ and % usage in .section
Project / Subsystem
binutils / gas
Date
2026-05-22
Proposer
Will Hawkins <hawkinsw@obs.cr>
Source type
public_inbox
Consensus
Proposed
Sentiment
—/10
Technical tradeoffs
- • The change is purely documentation and does not affect the functionality of the assembler.
- • Correct documentation is crucial for usability.
All attributes
- project
- binutils
- subsystem
- gas
- patch_id
- —
- discussion_id
- 20260522100809.829774-1-hawkinsw@obs.cr
- source_type
- public_inbox
- title
- [PATCH v2] gas: Clarify documentation about @ and % usage in .section
- headline
- Gas: Clarify documentation about @ and % usage in .section
- tldr
- The documentation for the .section assembler directive is clarified regarding the use of @ and % to avoid confusion related to comment characters.
- proposer
- Will Hawkins <hawkinsw@obs.cr>
- consensus
- Proposed
- outcome
- proposed
- sentiment_score
- —
- technical_tradeoffs
-
- • The change is purely documentation and does not affect the functionality of the assembler.
- • Correct documentation is crucial for usability.
- series_id
- —
- series_role
- standalone
- series_parts
- []
- tags
-
- • binutils
- • gas
- • assembler
- • documentation
- • section
- bugzilla_url
- —
- date
- 2026-05-22T00:00:00.000Z
[PATCH v2] gas: Clarify documentation about @ and % usage in .section
This patch clarifies the documentation for the .section assembler directive in the GNU assembler (gas). It explains when to use @ or % characters, especially on targets like ARM where @ signifies the start of a comment. On such platform, % is used instead. It aims to prevent confusion about how to specify section attributes.