Bootstrap explicit model registration

cmake/Doc.cmake

@@ -3,14 +3,19 @@ if(${BUILD_DOC})
     COMMAND mkdir -p doc/gnufig
   )
   add_custom_command(OUTPUT doc/components.tex
-    COMMAND ${DAISY_BIN_NAME} -d doc all.dai -p document
+    COMMAND ${DAISY_BIN_NAME} -d doc
+            -D ${CMAKE_SOURCE_DIR}/lib
+            ${CMAKE_SOURCE_DIR}/lib/all.dai
+            -p document
     COMMAND cd doc && gnuplot document.gnuplot
     DEPENDS
     doc_setup
   )
 
   add_custom_command(OUTPUT doc/stdlog.tex
-    COMMAND ${DAISY_BIN_NAME} -d doc ${CMAKE_SOURCE_DIR}/txt/stdlog.dai
+    COMMAND ${DAISY_BIN_NAME} -d doc
+            -D ${CMAKE_SOURCE_DIR}/lib
+            ${CMAKE_SOURCE_DIR}/txt/stdlog.dai
     DEPENDS doc_setup
   )
 
@@ -104,8 +109,8 @@ if(${BUILD_DOC})
   # The docs target first builds reference.pdf, tutorial.pdf and exercises.pdf; then it deletes all
   # the files used/generated during build.
   add_custom_target(docs
-    COMMAND rm -r doc/gnufig
-    COMMAND find doc/ -type f -regex .+\.[^pdf] | xargs rm
+    COMMAND ${CMAKE_COMMAND} -E rm -rf doc/gnufig
+    COMMAND find doc -type f ! -name "*.pdf" -delete
     DEPENDS reference tutorial exercises
   )
 endif()

doc/testing.md

@@ -1,13 +1,25 @@
 # Testing
 ## Install test dependencies
-We use a set of python tools to check Daisy output against a baseline. These are available from [daispy-test](https://github.com/daisy-model/daisypy-test) and can be installed with
+We use a set of python tools to check Daisy output against a baseline. These are available from [daisypy-test](https://github.com/daisy-model/daisypy-test) and can be installed with
 
     pip install daisypy-test@git+https://github.com/daisy-model/daisypy-test
 
+## Recommended local entrypoints
+For local development, the recommended way to run the test suites is via the
+platform-specific Makefile targets:
+
+    make linux-test
+    make macos-test
+    make windows-test
+
+These targets build Daisy, create or reuse the local `uv` environment in the
+build directory, install `daisypy-test`, and then run `ctest`.
+
 Test scenarios are in [test/dai_test_files](test/dai_test_files).
 When adding a test you need to add it as a `dai_test_case` in [test/CMakeLists.txt](test/CMakeLists.txt).
 
-Use [ctest](https://cmake.org/cmake/help/latest/manual/ctest.1.html) to run tests.
+Use [ctest](https://cmake.org/cmake/help/latest/manual/ctest.1.html) directly if
+you need lower-level control from a configured build directory.
 
     ctest
 
@@ -26,6 +38,10 @@ and activate it
 
     source ~/.venvs/daisy/bin/activate
 
-Then you can use `pip` to install `daispy-test`.
+Then you can use `pip` to install `daisypy-test`.
 
-NOTE: This will most likely fail if you have already built daisy and try to setup the test environment from the build directory. The reason is that python binaries are copied to the build direcotry. The solution is to run the commands from another directory or specify the full path to the msys installed python binary.
+NOTE: This will most likely fail if you have already built daisy and try to set
+up the test environment from the build directory. The reason is that python
+binaries are copied to the build directory. The solution is to run the commands
+from another directory or specify the full path to the MSYS-installed python
+binary.

include/daisy/daisy_registration.h

@@ -0,0 +1,26 @@
+// daisy_registration.h -- Explicit registration for Daisy models.
+//
+// Copyright 2026 The Daisy Authors.
+//
+// This file is part of Daisy.
+//
+// Daisy is free software; you can redistribute it and/or modify
+// it under the terms of the GNU Lesser Public License as published by
+// the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// Daisy is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Lesser Public License for more details.
+//
+// You should have received a copy of the GNU Lesser Public License
+// along with Daisy; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+#ifndef DAISY_REGISTRATION_H
+#define DAISY_REGISTRATION_H
+
+void register_daisy_models ();
+
+#endif // DAISY_REGISTRATION_H