Closes #14

docs/html/md_changelog.html

@@ -101,6 +101,9 @@ Unreleased</h1>
 <h3><a class="anchor" id="autotoc_md3"></a>
 Added</h3>
 <ul>
+<li>Stable application identifiers: <code><a class="el" href="structFrameKey.html" title="Stable frame identifier: normalized CAN ID and frame type.">FrameKey</a></code> (normalized CAN ID and frame type) and <code><a class="el" href="structSignalKey.html">SignalKey</a></code> (frame key and signal name), with equality and hashers.</li>
+<li>Runtime <code>FindSignal</code>, frame <code>GetKey</code>, and keys on decoded frame/signal results.</li>
+<li>Reload/lifetime tests for retained frames and independent signals, lookup handles, copies/moves, snapshot release, stable keys, removed/renamed definitions, failed/empty reloads, duplicate keys, and insufficient payloads.</li>
 <li><code>ParseFileWithDiagnostics</code> and <code><a class="el" href="structDbcParseResult.html">DbcParseResult</a></code> with severity, stable error code, supplied file path, physical line number, and message for each diagnostic.</li>
 <li>Warnings for unregistered statements, including floating-point signal types, attributes, signal type references, environment variables, and vendor extensions.</li>
 <li>Quiet common DBC header handlers registered through <a class="el" href="classTypeFactory.html" title="Registry-based factory for creating objects by runtime identifier.">TypeFactory</a>; <code>NS_</code> symbol declarations do not produce unsupported-statement warnings.</li>
@@ -109,6 +112,9 @@ Added</h3>
 <h3><a class="anchor" id="autotoc_md4"></a>
 Changed</h3>
 <ul>
+<li><b>API change:</b> <code><a class="el" href="classDecodeDatabase.html" title="Immutable runtime snapshot. Copies share storage; reload replaces a snapshot. Owning lookup handles a...">DecodeDatabase</a></code> is an immutable shared snapshot. Use <code>GetFrames()</code> for reads or construct a new snapshot from a vector; its frame index is private and built automatically, with duplicate-key validation.</li>
+<li><b>API change:</b> decoded <code>definition</code> fields and <code><a class="el" href="classDbcDecoder.html#a4005c4311f57b7faf21c0cb31463039c" title="Find frame definition by CAN ID.">DbcDecoder::FindFrame</a></code> return <code>shared_ptr&lt;const ...&gt;</code> ownership. Stored results retain old definitions across reload/clear/destruction, including separately copied signals and <code>VAL_</code> strings. Decoding shares metadata without per-result definition copies.</li>
+<li>Documented borrowed views, owning handles, snapshot retention, identifier scope, reload behavior, application migration, and synchronization requirements.</li>
 <li>Kept <code>ParseFile</code> compatible while sharing parsing with the diagnostic API. Parsing stops at the first error and never returns a partial database.</li>
 <li>Deferred value-description and multiplexing errors carry structured source locations without extracting them from exception messages.</li>
 <li>Documented supported syntax, warning behavior, diagnostic codes, and limitations.</li>
@@ -208,7 +214,7 @@ Added</h3>
 <ul>
 <li>Initialized the repository with a README and MIT license. (<code>4270459</code>)</li>
 <li>Added the DBC parser, frame and signal metadata, a tree representation and builder, a demonstration program, and a qmake project. (<code>2a90b2d</code>)</li>
-<li>Added runtime decoding through <code><a class="el" href="classDbcDecodeBuilder.html" title="Converts parsed DBC data into runtime decode database.">DbcDecodeBuilder</a></code>, <code><a class="el" href="structDecodeDatabase.html" title="Runtime decode database with fast lookup by CAN ID.">DecodeDatabase</a></code>, and <code><a class="el" href="classDbcDecoder.html" title="Runtime CAN decoder using prebuilt decode database.">DbcDecoder</a></code>, including CAN-frame lookup, Intel and Motorola extraction, signed and unsigned signals, and factor/offset conversion. Updated parser metadata and the demo to support decoding. (<code>a53a5df</code>)</li>
+<li>Added runtime decoding through <code><a class="el" href="classDbcDecodeBuilder.html" title="Converts parsed DBC data into runtime decode database.">DbcDecodeBuilder</a></code>, <code><a class="el" href="classDecodeDatabase.html" title="Immutable runtime snapshot. Copies share storage; reload replaces a snapshot. Owning lookup handles a...">DecodeDatabase</a></code>, and <code><a class="el" href="classDbcDecoder.html" title="Runtime CAN decoder using prebuilt decode database.">DbcDecoder</a></code>, including CAN-frame lookup, Intel and Motorola extraction, signed and unsigned signals, and factor/offset conversion. Updated parser metadata and the demo to support decoding. (<code>a53a5df</code>)</li>
 </ul>
 <h3><a class="anchor" id="autotoc_md22"></a>
 Documentation and maintenance</h3>