Skip to content

Add Comment - #340

Merged
LunaStev merged 2 commits into
wavefnd:masterfrom
LunaStev:docs/comment
Aug 20, 2026
Merged

Add Comment#340
LunaStev merged 2 commits into
wavefnd:masterfrom
LunaStev:docs/comment

Conversation

@LunaStev

@LunaStev LunaStev commented Aug 19, 2026

Copy link
Copy Markdown
Member

Summary

There are some parts of the current code that are difficult to understand because they lack comments. The task involves adding comments to each function and line of code.

Add module-level documentation across all Rust source files so contributors can identify each component's responsibility and phase boundaries before modifying it.

Explain frontend parsing, import expansion, generic monomorphization, semantic typing, CLI planning, target resolution, C ABI classification, LLVM lowering, inline assembly, CRT discovery, and pre-link validation contracts.

Document opaque-pointer and expression-type invariants, distinguish active implementations from compatibility paths, and add concrete safety rationale around LLVM FFI, GEP, and inline-assembly operations.

Replace temporary or informal comments with concise Rustdoc that passes strict rustdoc warning checks without changing compiler behavior.
@LunaStev
LunaStev marked this pull request as ready for review August 20, 2026 04:49
@LunaStev
LunaStev merged commit f94425f into wavefnd:master Aug 20, 2026
4 of 6 checks passed
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