qleisli 0.2.7

Experimental quantum language with linear ownership, exact contracts and independent finite IR verification
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# Comments and documentation in .qli

English implemented syntax metadata, no effect/owner/IR/evidence; prose never authorizes acceptance, comments may change source binding. QLT>=0.4 remains future, fences text only.

## Lexical forms and attachment

// LF/EOF, /* */ nested. /// and /** */ outer next function/use (including pub); //! and /*! */ inner module/function. ////,/**/,/***/,/*** ordinary. Only outermost block creates doc; nested markers text, quoted/Markdown delimiters still close comments, unclosed reject. Module inner before all items/outer docs, function inner immediately after `{` before statements. Ordinary comments/space may intervene, docs source order. Orphan/late/parameter/local/arbitrary-block docs reject. Original half-open UTF-8 spans include delimiters/exclude line LF; strip delimiters/normalize CRLF in text only, forbidden characters/bare CR reject. Iterative scan source-linear/separate depth/byte limits.

## Public data and command

parse_module keeps public AST/tokens; both parser entries validate attachment, lex returns syntax tokens only. parse_documented_module -> DocumentedModule{syntax,module_docs,declaration_docs,import_docs}, aligned vectors/empty undocumented slots. DocComment Outer/Inner,text,span/no seal. render_markdown parses or located ParseError, displays module/import docs/all signatures+visibility, strips one display space only, no link/example execution. `qleisli doc FILE` UTF-8->Markdown, no --qrate/JSON/import/check/execute/file write; exits0/1/2,error stderr.

## Trust, migration and library coverage

Move formerly arbitrary doc text to valid attachment or ordinary comment; bare CR->LF/CRLF. Four bundled files/twelve public/three private docstrings; [ledger](stdlib-contracts.md) authority, no automatic doctest/evidence/rustdoc guarantee.