Skip to content

feat(standard): require explicit notation for applied/disabled compiler flags — v1.31#10

Merged
UnbreakableMJ merged 1 commit into
mainfrom
compiler-flags-notation-v1.31
Jun 24, 2026
Merged

feat(standard): require explicit notation for applied/disabled compiler flags — v1.31#10
UnbreakableMJ merged 1 commit into
mainfrom
compiler-flags-notation-v1.31

Conversation

@UnbreakableMJ

Copy link
Copy Markdown
Contributor

Summary

  • §3.2 compiler optimization flag documentation rule extended symmetrically: previously only disabled flags required documentation; now both applied and disabled flags must be explicitly noted
  • Applied flag notation: comment in build file or build-time message
  • Disabled flag notation: same, plus the reason for disabling
  • Rationale stated in the text: "visible flag state at compile time makes errors traceable to a specific flag"
  • Stability/Priority-1-over-Performance rule and the never-ship-broken-build rule preserved
  • Compliance-checklist §3.2 bullet updated to include compiler optimization flags applied/disabled with explicit notation

Test plan

  • makeinfo --no-split The_Steelbore_Standard.texi → zero errors, zero warnings ✓
  • grep "Every applied flag" The_Steelbore_Standard.md → present in §3.2 ✓
  • grep "traceable" The_Steelbore_Standard.md → present in §3.2 rationale ✓
  • grep "1.31" The_Steelbore_Standard.texi@settitle, @set VERSION, changelog ✓

🤖 Generated with Claude Code

…er flags — v1.31

Extends the §3.2 compiler optimization rule symmetrically: previously
only disabled flags required documentation; now both applied flags and
disabled flags (with reason) must be explicitly noted — e.g. a comment
in the build file or a build-time message.  The stated purpose is
visibility: full flag state at compile time makes build errors traceable
to specific flags.  Compliance-checklist §3.2 bullet updated to include
the notation requirement.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@UnbreakableMJ UnbreakableMJ merged commit e44f5f4 into main Jun 24, 2026
1 check passed
@UnbreakableMJ UnbreakableMJ deleted the compiler-flags-notation-v1.31 branch June 24, 2026 08:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant