Skip to content

chore: format cleanup to mach skill#363

Merged
octalide merged 16 commits into
devfrom
chore/362-format-cleanup
Jul 4, 2026
Merged

chore: format cleanup to mach skill#363
octalide merged 16 commits into
devfrom
chore/362-format-cleanup

Conversation

@octalide

@octalide octalide commented Jul 4, 2026

Copy link
Copy Markdown
Collaborator

Closes #362.

Brings every tracked .mach file into conformance with the mach authoring skill. Formatting, docs, and comments only, no semantic changes.

Changes

  • Docstrings: converted all old-form # name: summary. docstrings to the new bare form (lowercase summary, no leading identifier, no trailing period); component # --- blocks preserved. Relocated two misplaced module docstrings (text/parse, memory) to the top of their files and added module docstrings to the four surface files that lacked one (lib, runtime/linux, runtime/darwin, runtime/windows).
  • Alignment: aligned value columns in drifted rec/uni field blocks (sha256/sha512 State, darwin stat_t/dirent64, windows WIN32_FIND_DATAA) and use alias groups (toml, format, dns, rand, thread, parse).
  • Indentation: converted the one tab-indented file (types/size) to 4-space.
  • Naming: renamed the two convention outliers, internal spawn_ctxSpawnCtx and the base64 lookup tables std_table/url_table/decode_tableSTD_TABLE/URL_TABLE/DECODE_TABLE. Preserved the intentional lowercase primitive aliases (usize, isize, bool, char, str), libc/Win32 struct mirrors (timespec, stat_t, dirent64, ...), C stream names (stdin/stdout/stderr), and all ext fun symbol names.
  • Em dashes: removed all 48 em dashes from comments (replaced with commas).
  • Typo: fixed a pre-existing garbled docstring (timespe#timespec) and a misattached docstring on the private cmp_ratio_pow2 helper in text/parse.

Committed in batches by directory. mach build . and mach test . pass identically (620 tests, 0 failures).

🤖 Generated with Claude Code

octalide added 16 commits July 3, 2026 20:17
Convert docstrings to bare-summary form, align field/import/const columns, convert size.mach tabs to 4-space indent.
Convert docstrings to bare-summary form; align field/import/const columns.
Convert docstrings to bare-summary form; align columns; move memory.mach module docstring to file top.
Convert docstrings to bare-summary form; align columns.
Convert docstrings to bare-summary form; align sha256/sha512 State field columns.
Convert docstrings to bare-summary form; align toml use group.
Convert docstrings to bare-summary form; rename base64 lookup tables to SCREAMING_SNAKE.
Convert docstrings to bare-summary form.
Convert docstrings to bare-summary form.
Convert docstrings to bare-summary form; align dns use group; drop em dashes.
Convert docstrings to bare-summary form.
Convert docstrings to bare-summary form; align thread use group; drop em dashes.
Convert docstrings to bare-summary form; align darwin stat_t/dirent64 and windows WIN32_FIND_DATAA field columns; rename internal spawn_ctx to SpawnCtx; fix garbled timespe# docstring; drop em dashes.
Convert docstrings to bare-summary form; move parse.mach module docstring to file top; align parse use group; fix misattached cmp_ratio_pow2 docstring; drop em dashes.
Convert docstrings to bare-summary form; add module docstrings to the linux/darwin/windows entrypoint surfaces; drop em dashes.
Convert docstrings to bare-summary form; add lib.mach module docstring; align format use group; drop em dashes.
@octalide octalide marked this pull request as ready for review July 4, 2026 00:19
@octalide octalide merged commit 65a2573 into dev Jul 4, 2026
3 checks passed
@octalide octalide deleted the chore/362-format-cleanup branch July 4, 2026 00:25
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.

chore: format cleanup to mach skill

1 participant