参考所有分组,完成尽量多的内容:锁定kinematics源码映射结论
结论:新增 kinematics source-map 文档和同步检查,固定 manifest 分组计数与 source-coverage 边界,并接入 native/all-native guardrail;未扩展 smoke 功能。
This commit is contained in:
49
docs/linuxcnc-kinematics-source-map.md
Normal file
49
docs/linuxcnc-kinematics-source-map.md
Normal file
@@ -0,0 +1,49 @@
|
||||
# LinuxCNC kinematics source map
|
||||
|
||||
This map tracks the LinuxCNC source/configuration basis for kinematics,
|
||||
switchkins, RTCP, and M428/M429/M430 remap coverage. It is intentionally a
|
||||
source-coverage document: the manifest entries here must not become browser or
|
||||
application behavior by themselves.
|
||||
|
||||
## Manifest groups
|
||||
|
||||
The kinematics manifest currently contains these LinuxCNC-root relative source
|
||||
groups:
|
||||
|
||||
| Group | Count | Source coverage role |
|
||||
| --- | ---: | --- |
|
||||
| `core` | 30 | LinuxCNC kinematics and posemath C/C++ sources. |
|
||||
| `config` | 33 | LinuxCNC switchkins INI/HAL/POSTGUI sources used by M428/M429/M430 and RTCP coverage. |
|
||||
| `remap` | 31 | LinuxCNC M428/M429/M430 remap subroutines. |
|
||||
| `component` | 8 | LinuxCNC halcompile component sources referenced by kinematics configs. |
|
||||
| `generated` | 8 | LinuxCNC halcompile-generated C sources adjacent to component coverage. |
|
||||
| `header` | 13 | LinuxCNC kinematics and posemath declarations. |
|
||||
| `metadata` | 34 | LinuxCNC build/manpage metadata adjacent to covered kinematics sources. |
|
||||
| `asset` | 122 | LinuxCNC INI-adjacent HAL, README, GUI, demo, PYVCP, and other source assets. |
|
||||
| `tooldata` | 10 | LinuxCNC tool table files referenced by covered M428/M429/M430 INI files. |
|
||||
|
||||
## Boundaries
|
||||
|
||||
- `asset`, `metadata`, `header`, and `tooldata` entries are source coverage,
|
||||
not browser API surface.
|
||||
- Browser-side file persistence remains OPFS-only and is not expanded by this
|
||||
manifest.
|
||||
- Switchkins/remap generation must continue to derive M428/M429/M430 cases from
|
||||
LinuxCNC INI/HAL/remap sources, not from hand-authored behavior.
|
||||
- RTCP and five-axis coverage must remain tied to LinuxCNC kinematics sources,
|
||||
remap files, and configuration files.
|
||||
|
||||
## Checks
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
./check-linuxcnc-kinematics-source-map.sh
|
||||
./check-linuxcnc-inputs.sh linuxcnc-kinematics-source-files.txt --require-kinematics-complete
|
||||
./check-linuxcnc-switchkins-remap-table.sh linuxcnc-kinematics-source-files.txt
|
||||
```
|
||||
|
||||
`check-linuxcnc-kinematics-source-map.sh` keeps this document's group counts in
|
||||
sync with `linuxcnc-kinematics-source-files.txt`; the input and table checkers
|
||||
validate LinuxCNC source existence, directory completeness, remap kinstype
|
||||
notes, and switchkins/remap table generation.
|
||||
Reference in New Issue
Block a user