docs(scheduler-allocation): fix xce_host_iter_t.next() return type

Found during task 1.1 implementation: the Data Structure Changes
Summary declared next() returning xce_worker_t* (the wire/config
type), but the Composition Algorithm pseudocode in the same document
already used xce_sched_worker_t* (the scheduler-internal type with
resvals/resInUse/host_eval_ctx) for the identical call -- these are
genuinely different types in this codebase, confirmed via
make_sched_worker()'s xce_worker_t* -> xce_sched_worker_t* conversion.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XYdtrEWWZfKRRGED7raEYg
This commit is contained in:
Rongsong Shen 2026-09-04 13:26:18 +00:00
parent 48c789dfcb
commit d1a3e158ae
No known key found for this signature in database
GPG key ID: 5BCDAAE0123E9FE2
2 changed files with 18 additions and 2 deletions

View file

@ -276,9 +276,15 @@ struct xce_alloc_plan_iter_s {
##### Service Interface
```c
/* Correction (found during task 1.1 implementation): next() returns
* xce_sched_worker_t* (sched/types.h -- resvals/resInUse/host_eval_ctx),
* not xce_worker_t* (xce/types.h -- the wire/config type make_sched_worker()
* converts FROM). requirements.md's own Composition Algorithm pseudocode
* already used xce_sched_worker_t*; this struct declaration was out of
* sync with it. */
struct xce_host_iter_s {
int (*init)(xce_host_iter_t* iter, xce_alloc_plan_t* plan, var workers);
xce_worker_t* (*next)(xce_host_iter_t* iter);
xce_sched_worker_t* (*next)(xce_host_iter_t* iter);
void (*fini)(xce_host_iter_t* iter);
void* private;
};