0.0.1

.github/workflows/ci-cell.yml

@@ -39,6 +39,12 @@ jobs:
             mingw-w64-x86_64-cmake
             mingw-w64-x86_64-make
 
+      - name: Checkout STLSoft
+        shell: bash
+        run: |
+          set -euo pipefail
+          git clone --depth 1 https://github.com/synesissoftware/STLSoft "$RUNNER_TEMP/stlsoft"
+
       - name: Configure
         shell: bash
         run: |
@@ -49,9 +55,11 @@ jobs:
               -DCMAKE_BUILD_TYPE="${{ inputs.build-type }}" \
               -DCMAKE_C_COMPILER=gcc \
               -DCMAKE_CXX_COMPILER=g++ \
+              -DSTLSOFT="$RUNNER_TEMP/stlsoft" \
               -DBUILD_TESTING=OFF
           else
             cmake -B build -S . \
+              -DSTLSOFT="$RUNNER_TEMP/stlsoft" \
               -DBUILD_TESTING=OFF
           fi
 
@@ -86,4 +94,4 @@ jobs:
           set -euo pipefail
           PREFIX="${RUNNER_TEMP}/install-prefix"
           PROJECT="$(tr -d '[:space:]' < .sis/project_name.txt)"
-          "$PREFIX/bin/${PROJECT}.exe"
+          "$PREFIX/bin/${PROJECT}.exe" --version

.gitignore

@@ -0,0 +1,151 @@
+
+# directories (by name)
+
+/.svn/
+/.vs/
+
+/_build/
+/_internal/
+
+/bin/
+/include/
+/lib/
+/node_modules/
+
+/include/b64/
+/include/shwild/
+/include/xcontract/
+/include/xcover/
+/include/xtests/
+
+/src/b64/
+/src/shwild/
+/src/xcontract/
+/src/xcover/
+/src/xtests/
+
+Debug Multithreaded DLL/
+Debug Multithreaded Dll/
+Debug Multithreaded pseudoUNIX/
+Debug Multithreaded pseudoUnix/
+Debug Multithreaded/
+Debug/
+DebugDLLUNIX/
+DebugDll/
+DebugMTDLL/
+DebugMt/
+DebugNox/
+DebugUNIX/
+DebugUnix/
+Release Multithreaded DLL/
+Release Multithreaded Dll/
+Release Multithreaded pseudoUNIX/
+Release Multithreaded pseudoUnix/
+Release Multithreaded/
+Release/
+ReleaseDLLUNIX/
+ReleaseDll/
+ReleaseMTDLL/
+ReleaseMt/
+ReleaseNox/
+ReleaseUnix/
+UDebug/
+UDebugMt/
+URelease/
+UReleaseMt/
+Unicode Debug Multithreaded DLL/
+Unicode Debug Multithreaded Dll/
+Unicode Debug Multithreaded/
+Unicode Debug/
+Unicode Release Multithreaded DLL/
+Unicode Release Multithreaded Dll/
+Unicode Release Multithreaded/
+Unicode Release/
+
+Win32/
+ipch/
+x64/
+
+
+# directories (by pattern)
+
+
+# files (by name)
+
+.DS_Store
+.ruby-version
+.svnignore
+.svnignore-at-root
+.update_deps
+
+list_changes.cmd
+logging-bailout.txt
+prepare.cmd
+sh.exe.stackdump
+update_deps.cmd
+
+build/makefile.tmpl
+build/makefile.tools.xml
+
+ReadDebugString
+ReadDebugString_test
+
+
+# files (by pattern)
+
+RCa0*
+RCb0*
+
+*~
+*.???_obj
+*.a
+*.app
+*.aps
+*.b64
+*.bak
+*.chm
+*.class
+*.csproj*user
+*.d
+*.dll
+*.dylib
+*.exe
+*.gch
+*.gem
+*.idb
+*.ilk
+*.iobj
+*.ipch
+*.ipdb
+*.la
+*.lai
+*.lib
+*.lo
+*.log
+*.ncb
+*.o
+*.obj
+*.opensdf
+*.opt
+*.org
+*.out
+*.pch
+*.pdb
+*.pyc
+*.rar
+*.res
+*.sbr
+*.scc
+*.sdf
+*.slo
+*.so
+*.suo
+*.swp
+*.tlog
+*.tmp
+*.unsuccessfulbuild
+*.vcproj*user
+*.vcxproj*user
+*.xcuserstate
+*.zip
+

.sis/script_info_lines.txt

@@ -1,2 +1,2 @@
 ReadDebugString is a Windows CLI that reads messages from the Windows debugger
-Copyright (c) 2026, Matthew Wilson and Synesis Information Systems
+Copyright (c) 2025-2026, Matthew Wilson and Synesis Information Systems

AUTHORS.md

@@ -0,0 +1,17 @@
+# ReadDebugString - Authors <!-- omit in toc -->
+
+
+## Major Contributors
+
+* Matthew Wilson ([mwsis](https://github.com/mwsis));
+
+
+## Defect reports, fixes and suggestions (for which we are very grateful)
+
+* \<none> (yet);
+
+
+Contributions are welcomed.
+
+
+<!-- ########################### end of file ########################### -->

CHANGES.md

@@ -0,0 +1,23 @@
+# ReadDebugString - Changes <!-- omit in toc -->
+
+
+## 0.0.1 - 24th August 2026
+
+* Replaced the initial executable scaffold with a Windows debugger message reader;
+* Added process identification to reader output;
+* Improved error handling for Windows file-mapping and debugger access failures;
+* Improved CMake flexibility for uninstalled **STLSoft** source trees supplied via **STLSOFT**;
+* Added validation and an imported **STLSoft::STLSoft** target for local STLSoft source trees;
+* Added Windows **cl** and MinGW CI configuration with STLSoft source checkout;
+* Added an installation smoke test using **--version** so the long-running reader is not started;
+* Added a section-1 reference page and installed it with CMake;
+
+
+## 0.0.0 - 16th August 2026
+
+* Added the initial Windows-only **ReadDebugString** executable scaffold;
+* Added **--help** and **--version** command-line handling;
+* Added CMake configuration, helper scripts, and editor settings;
+
+
+<!-- ########################### end of file ########################### -->