docs: 补充注释与格式化

This commit is contained in:
2026-08-06 23:10:27 +08:00
parent e36a69976e
commit 31e28a03a6
156 changed files with 2393 additions and 1687 deletions
+6 -6
View File
@@ -1,9 +1,9 @@
//! liveness 分析 pass:IRFunction + CFG → LiveInfo(只读,D-15)。
//! liveness 分析 pass:IRFunction + CFG → LiveInfo(只读)。
//!
//! 消费 `oxide_ir::IRFunction`(只读)与 `oxide_cfg::Cfg`(preds/succs + exit 哨兵,D-12),
//! 产出 LiveInfo 分析视图(D-01:pass 输出不住进 IR)。两阶段:`dataflow`(块级
//! 消费 `oxide_ir::IRFunction`(只读)与 `oxide_cfg::Cfg`(preds/succs + exit 哨兵),
//! 产出 LiveInfo 分析视图(pass 输出不住进 IR)。两阶段:`dataflow`(块级
//! liveIn/liveOut 不动点)→ `ranges`(块内反向扫描逐指令 live 集)。gen/kill 直接消费
//! contract.rs def_reg/use_regs(D-22),None→0 / This→254 / NewTarget→255 零重复映射。
//! contract.rs def_reg/use_regs,None→0 / This→254 / NewTarget→255 零重复映射。
mod dataflow;
mod live_info;
@@ -14,8 +14,8 @@ pub use live_info::LiveInfo;
use oxide_cfg::Cfg;
use oxide_ir::IRFunction;
/// 计算 liveness:`&IRFunction + &Cfg → LiveInfo`。纯函数,只读 IR(D-15)。
/// 空 IRFunction 退化:返回 LiveInfo::new()(照 oxide_dce 空函数先例)。
/// 计算 liveness:`&IRFunction + &Cfg → LiveInfo`。纯函数,只读 IR。
/// 空 IRFunction 退化:返回 LiveInfo::new()。
pub fn liveness(f: &IRFunction, cfg: &Cfg) -> LiveInfo {
if f.insts.is_empty() {
return LiveInfo::new();