docs: fix doc_lazy_continuation across the workspace

Eighteen markdown list items in module- and item-doc comments had
continuation lines that were not indented to align under the item
text, so rustdoc rendered them as separate paragraphs and broke the
list. Corrected the indentation (and, at two sites where a general
wrap-up sentence followed a sublist, separated it with a blank doc
line so it does not mis-attach to the last item). Doc whitespace only;
no prose reworded, no code changed.

Workspace clippy is now warning-clean.
This commit is contained in:
2026-06-02 02:34:40 +02:00
parent b5799640f8
commit 1be2c1f145
6 changed files with 17 additions and 15 deletions
+1
View File
@@ -2195,6 +2195,7 @@ fn locate_str_runtime() -> Result<PathBuf> {
/// 1. the directory containing the running `ail` binary, walked up
/// (handles `target/release/ail` and `target/debug/ail`).
/// 2. the current working directory, walked up.
///
/// On miss, fails with `err_msg` verbatim — callers pass the
/// byte-identical message their flag expects.
fn locate_runtime_file(filename: &str, err_msg: &str) -> Result<PathBuf> {
+2 -2
View File
@@ -15,8 +15,8 @@
//! * borrow over value type -> `borrow-over-value` (signature),
//! * borrowed return -> `borrow-return-not-permitted` (sig),
//! * consume while borrowed -> `consume-while-borrowed` (linearity),
//! and emit the `over-strict-mode` advisory (a warning, exit 0) on a
//! true read-only `(own)` heap param.
//! and emit the `over-strict-mode` advisory (a warning, exit 0) on a
//! true read-only `(own)` heap param.
//!
//! Coupling discipline: the assertions key on the bracketed diagnostic
//! CODE (e.g. `[consume-while-borrowed]`) appearing in stderr, never on
+3 -3
View File
@@ -1,8 +1,8 @@
//! Embedding-ABI M1 coherent-stop proof (spec §"Testing strategy" 5
//! + Acceptance criteria): build `examples/embed_backtest_step.ail`
//! as a staticlib, link the C host against `libembed_backtest_step.a`
//! + `libailang_rt.a`, run it, assert the `s == 25` assertion holds
//! (exit 0). This is the whole-milestone existence proof.
//! as a staticlib, link the C host against `libembed_backtest_step.a`
//! + `libailang_rt.a`, run it, assert the `s == 25` assertion holds
//! (exit 0). This is the whole-milestone existence proof.
use ailang_test_support::workspace_root;
use std::path::PathBuf;
+1
View File
@@ -30,6 +30,7 @@
//! a fully-concrete substitution; the source body is taken
//! directly and rigid-var-substituted into a
//! `<name>__<type>…` fn.
//!
//! The loop re-walks bodies added by the previous round, which is
//! what closes it over chained class-method calls (e.g.
//! `Eq.ne x y = not (eq x y)`). Targets are deduplicated within a
+7 -7
View File
@@ -8,14 +8,14 @@
//! - `expected_params` — LLVM-IR param types as text
//! - `expected_ret` — LLVM-IR return type as text
//! - `wants_alwaysinline` — whether the dispatch site should
//! attach the `alwaysinline` attribute
//! to the emitted fn (was a separate
//! hardcoded name-list in the predicate
//! `intercept_emit_wants_alwaysinline`
//! before raw-buf.1)
//! attach the `alwaysinline` attribute
//! to the emitted fn (was a separate
//! hardcoded name-list in the predicate
//! `intercept_emit_wants_alwaysinline`
//! before raw-buf.1)
//! - `emit` — the per-arm IR-emission body, run
//! against `&mut Emitter` after the
//! sig check
//! against `&mut Emitter` after the
//! sig check
//!
//! Adding a new intercept = adding one row to `INTERCEPTS`. The
//! dispatch site (`try_emit_primitive_instance_body` in
+3 -3
View File
@@ -124,9 +124,9 @@ pub const FORM_A_SPEC: &str = include_str!("../specs/form_a.md");
///
/// This is the lowest-level entry point and does **not** resolve imports
/// — for the transitive closure use `ailang_surface::load_workspace`
/// (which composes [`workspace::load_modules_with`] + a prelude inject
/// + [`workspace::build_workspace`]). Errors are returned as
/// [`Error::Io`] / [`Error::Json`] / [`Error::SchemaMismatch`].
/// (which composes [`workspace::load_modules_with`] + a prelude inject
/// + [`workspace::build_workspace`]). Errors are returned as
/// [`Error::Io`] / [`Error::Json`] / [`Error::SchemaMismatch`].
pub fn load_module(path: &std::path::Path) -> Result<Module> {
let bytes = std::fs::read(path)?;
let module: Module = serde_json::from_slice(&bytes)?;