Closes #11

docs/html/md_README.html

@@ -233,7 +233,7 @@ Parser</h2>
 Demo</h2>
 <p>File:</p>
 <ul>
-<li><code><a class="el" href="main_8cpp.html" title="Created: 2026-03-13 Author: Deeaitch (Dim. Himro)">main.cpp</a></code></li>
+<li><code>main.cpp</code></li>
 </ul>
 <p>Used as a small integration example.</p>
 <hr  />
@@ -797,7 +797,15 @@ Build Integration</h1>
 <li>qmake</li>
 <li>Makefile</li>
 </ul>
-<p>Just add the source files to the project.</p>
+<p>Open <code>dbc.pro</code> in Qt Creator to see two subprojects: <code>core</code> and <code>tests</code>. <code>core/core.pro</code> builds the C++17 static library <code>dbc_core</code> without a Qt dependency. <code>tests/tests.pro</code> builds the QtTest executable <code>dbc_tests</code> and links that library. The root project declares <code>tests.depends = core</code> for parallel builds.</p>
+<p>Build out of source (Qt 6; use <code>qmake</code> for Qt 5):</p>
+<div class="fragment"><div class="line">mkdir build</div>
+<div class="line">cd build</div>
+<div class="line">qmake6 ../dbc.pro</div>
+<div class="line">make -j</div>
+<div class="line">make check</div>
+</div><!-- fragment --><p><code>core/core_files.pri</code> lists the library sources and headers. Consumers include <code>core/core.pri</code> for include paths and library linkage; the test source lists live in <code>tests/parser_tests.pri</code> and <code>tests/decoder_tests.pri</code>. When building a consumer separately, pass <code>DBC_CORE_BUILD_DIR=/absolute/path/to/build/core</code> to qmake.</p>
+<p>The former demonstration program is preserved in <code><a class="el" href="examples_2main_8cpp.html" title="Created: 2026-03-13 Author: Deeaitch (Dim. Himro)">examples/main.cpp</a></code> with <code>examples/demo.pro</code>. Build it separately after building core, using that same <code>DBC_CORE_BUILD_DIR</code> option; run <code>dbc_demo &lt;file.dbc&gt;</code>.</p>
 <hr  />
 <h1><a class="anchor" id="autotoc_md100"></a>
 Summary</h1>
@@ -826,7 +834,7 @@ Runtime decode representation</h2>
 </div><!-- fragment --><p>This gives FrameTap a much better foundation for real use, because both browsing and decoding are supported without forcing one representation to do the other's job.</p>
 <h1><a class="anchor" id="autotoc_md103"></a>
 Regression tests</h1>
-<p>See <a class="el" href="md_tests_2README.html">tests/README.md</a> for compiler and qmake commands. Tests cover frame validation and error locations, Intel and Motorola extraction, signed and unsigned 64-bit boundaries, physical conversion, numeric output, and invalid signal payloads. </p>
+<p>See <a class="el" href="md_tests_2README.html">tests/README.md</a> for QtTest build and execution commands. Tests cover frame validation and error locations, Intel and Motorola extraction, signed and unsigned 64-bit boundaries, physical conversion, numeric output, and invalid signal payloads. </p>
 </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->