docs: document full NSS reference tree including Makefiles
All checks were successful
Source release / source-package (push) Successful in 1m27s

Expand the NSS reference section in CLAUDE.md to cover the
complete /home/mario/mars/nss layout: all public_core
subdirectories, the *Modules.mk object-file lists, buildtools,
docs and shared/sdk.  Note that the Modules.mk files are the
authoritative source sets for subsystem imports.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Mario Fetka
2026-06-18 14:08:45 +02:00
parent fce101e06f
commit 98e0969f11

View File

@@ -113,16 +113,36 @@ IPX/TCP → nwtransport → nwconn (dispatcher) → NCP providers
### Original NSS reference sources
The original NSS sources are available on the host at `/home/mario/mars/nss`:
The complete original NSS source tree is at `/home/mario/mars/nss`:
```
/home/mario/mars/nss/public_core/ — comn, nss, library, lsa, manage, ndpmod, nebdrv, sharedsrc, …
/home/mario/mars/nss/shared/sdk/ — include, internal, public, comnSA headers
/home/mario/mars/nss/
├── Makefile — top-level build entry point
├── buildtools/ — build helper scripts and tools
├── docs/ — NSS documentation
├── public_core/ — NSS C sources
│ ├── Makefile
│ ├── admindrv/ admindrvModules.mk
│ ├── comn/ comnModules.mk ← namespace, beast, common, compression, …
│ ├── library/ libraryModules.mk ← stdio, wio, OS helpers, …
│ ├── lsa/ lsaModules.mk
│ ├── manage/ manageModules.mk
│ ├── ndpmod/ ndpmodModules.mk
│ ├── nebdrv/ nebdrvModules.mk
│ ├── nss/ nssModules.mk
│ ├── nsslnxlib/ nsslnxlibModules.mk
│ ├── nwraid/ nwraidModules.mk
│ ├── sharedsrc/ — shared .c.h source fragments
│ └── zlss/ zlssModules.mk
└── shared/
├── sdk/ — include/, internal/, public/, comnSA/ headers
├── schema/
└── support/
```
Use these directly for comparison when importing or auditing files into
`src/nwnss/` and `include/nwnss/`. The provenance mapping is in the section
below.
The `*Modules.mk` files list the exact object files each subsystem builds —
use them to find the authoritative source set for any subsystem before
importing or auditing files into `src/nwnss/` and `include/nwnss/`.
### NSS import layout