Document LinuxCNC Boost.Python shim source basis

core/wasm_shims/boost/python/class.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: interpmodule.cc, pyblock.cc, pyemctypes.cc, and
+// array1.hh include boost/python/class.hpp for Python binding classes.
 #include <boost/call_traits.hpp>
 #include <boost/config.hpp>
 

core/wasm_shims/boost/python/converter/registry.hpp

@@ -1,3 +1,5 @@
 #pragma once
 
+// LinuxCNC source basis: array1.hh includes boost/python/converter/registry.hpp
+// for registered class object lookup.
 #include "boost/python/object.hpp"

core/wasm_shims/boost/python/def.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: canonmodule.cc and interpmodule.cc include
+// boost/python/def.hpp for Boost.Python module functions.
 #include "boost/python/object.hpp"
 
 namespace boost {

core/wasm_shims/boost/python/detail/caller.hpp

@@ -1,3 +1,5 @@
 #pragma once
 
+// LinuxCNC source basis: pyarrays.cc includes boost/python/detail/caller.hpp
+// for return_internal_reference support.
 #include "boost/python/object.hpp"

core/wasm_shims/boost/python/enum.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: canonmodule.cc, boost_pyenum_macros.hh, and array1.hh
+// use boost::python::enum_ for Python enum bindings.
 #include "boost/python/object.hpp"
 
 namespace boost {

core/wasm_shims/boost/python/exception_translator.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: interpmodule.cc uses
+// boost::python::register_exception_translator.
 #include "boost/python/object.hpp"
 
 namespace boost {

core/wasm_shims/boost/python/module.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: canonmodule.cc and interpmodule.cc use
+// BOOST_PYTHON_MODULE for embedded Python module declarations.
 #include "boost/python/object.hpp"
 
 #define BOOST_PYTHON_MODULE(name) extern "C" void init_##name()

core/wasm_shims/boost/python/object/class_detail.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: array1.hh includes boost/python/object/class_detail.hpp
+// for registered_class_object().
 #include "boost/python/object.hpp"
 
 namespace boost {

core/wasm_shims/boost/python/object_fwd.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: interp_internal.hh forward-declares Boost.Python
+// object pointers through boost/python/object_fwd.hpp.
 namespace boost {
 namespace python {
 
@@ -7,4 +9,3 @@ class object;
 
 } // namespace python
 } // namespace boost
-

core/wasm_shims/boost/python/return_internal_reference.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: pyarrays.cc uses boost::python::return_internal_reference
+// for array wrapper bindings.
 #include "boost/python/object.hpp"
 
 namespace boost {

core/wasm_shims/boost/python/suite/indexing/map_indexing_suite.hpp

@@ -1,5 +1,7 @@
 #pragma once
 
+// LinuxCNC source basis: interpmodule.cc, pyblock.cc, pyparamclass.cc, and
+// pyinterp1.cc include map_indexing_suite for Boost.Python map wrappers.
 namespace boost {
 namespace python {
 

test-linuxcnc-wasm-cmake-safe-probe.sh

@@ -1420,6 +1420,17 @@ grep -F 'LinuxCNC source basis: interp_python.cc, interp_namedparams.cc,' core/w
 grep -F 'LinuxCNC source basis: interp_python.cc, rs274ngc_pre.cc, and' core/wasm_shims/boost/python/import.hpp >/dev/null
 grep -F 'LinuxCNC source basis: interp_python.cc and python_plugin.cc use' core/wasm_shims/boost/python/str.hpp >/dev/null
 grep -F 'LinuxCNC source basis: rs274ngc_pre.cc uses boost::python::scope' core/wasm_shims/boost/python/scope.hpp >/dev/null
+grep -F 'LinuxCNC source basis: interpmodule.cc, pyblock.cc, pyemctypes.cc, and' core/wasm_shims/boost/python/class.hpp >/dev/null
+grep -F 'LinuxCNC source basis: canonmodule.cc and interpmodule.cc include' core/wasm_shims/boost/python/def.hpp >/dev/null
+grep -F 'LinuxCNC source basis: canonmodule.cc and interpmodule.cc use' core/wasm_shims/boost/python/module.hpp >/dev/null
+grep -F 'LinuxCNC source basis: canonmodule.cc, boost_pyenum_macros.hh, and array1.hh' core/wasm_shims/boost/python/enum.hpp >/dev/null
+grep -F 'LinuxCNC source basis: interpmodule.cc uses' core/wasm_shims/boost/python/exception_translator.hpp >/dev/null
+grep -F 'LinuxCNC source basis: pyarrays.cc uses boost::python::return_internal_reference' core/wasm_shims/boost/python/return_internal_reference.hpp >/dev/null
+grep -F 'LinuxCNC source basis: pyarrays.cc includes boost/python/detail/caller.hpp' core/wasm_shims/boost/python/detail/caller.hpp >/dev/null
+grep -F 'LinuxCNC source basis: array1.hh includes boost/python/converter/registry.hpp' core/wasm_shims/boost/python/converter/registry.hpp >/dev/null
+grep -F 'LinuxCNC source basis: array1.hh includes boost/python/object/class_detail.hpp' core/wasm_shims/boost/python/object/class_detail.hpp >/dev/null
+grep -F 'LinuxCNC source basis: interp_internal.hh forward-declares Boost.Python' core/wasm_shims/boost/python/object_fwd.hpp >/dev/null
+grep -F 'LinuxCNC source basis: interpmodule.cc, pyblock.cc, pyparamclass.cc, and' core/wasm_shims/boost/python/suite/indexing/map_indexing_suite.hpp >/dev/null
 test -f core/wasm_shims/libgen.h
 grep -F 'LinuxCNC source basis: src/emc/rs274ngc/interp_o_word.cc uses basename()' core/wasm_shims/libgen.h >/dev/null
 grep -F 'inline char *basename(const char *path)' core/wasm_shims/libgen.h >/dev/null