docs: confusing gimple "Statement and operand traversals"
Project / Subsystem
gcc / docs
Date
2026-08-24
Proposer
Georg-Johann Lay <avr@gjlay.de>
Source type
public_inbox
Consensus
Proposed
Sentiment
8/10
All attributes
- project
- gcc
- subsystem
- docs
- patch_id
- —
- discussion_id
- 2b560ae9-c894-44c2-8d79-e1df8f811384@gjlay.de
- source_type
- public_inbox
- title
- docs: confusing gimple "Statement and operand traversals"
- headline
- Confusing GIMPLE statement and operand traversal documentation
- tldr
- Documentation for GIMPLE statement and operand traversals contains type mismatches and unclear return value mappings.
- proposer
- Georg-Johann Lay <avr@gjlay.de>
- consensus
- Proposed
- outcome
- proposed
- sentiment_score
- 8
- technical_tradeoffs
- []
- series_id
- —
- series_role
- standalone
- series_parts
- []
- tags
-
- • documentation
- • GIMPLE
- • compiler internals
- bugzilla_url
- —
- date
- 2026-08-24T00:00:00.000Z
docs: confusing gimple "Statement and operand traversals"
Johann Lay points out discrepancies in the GCC documentation for GIMPLE statement and operand traversals. Specifically, the function signatures in the online documentation do not match those defined in gimple-walk.h, and the return types and their mappings between different traversal functions are unclear, causing confusion for developers.