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:
@@ -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> {
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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;
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)?;
|
||||
|
||||
Reference in New Issue
Block a user