Skip to content

golden の決まり方、backend の既定、tcs の探し方、csproj から読むもの、lubx の C の面を、それぞれ正の 1 か所に書き、ほかはそこを指す - #656

Draft
neguse wants to merge 1 commit into
masterfrom
docs/one-source-per-topic

Conversation

@neguse

@neguse neguse commented Nov 21, 2026

Copy link
Copy Markdown
Owner

問題

同じ事実を複数の文書が写していて、写しが実装とずれていた。

  • golden: README.md、docs/d3d12-backend.md、scripts/run-golden.sh は lavapipe の出力が機材によらず完全に一致すると書くが、lavapipe の出力は mesa の版で変わり、CI の linux job はそのために比較を外している (ci.yml のコメントだけがそう書く)。
  • backend の既定: API reference (stub の ConfigOpts.Backend) に openxr と Android の既定が無く、README.md と docs/design.md が別々に既定の一覧を持つ。
  • tcs の探し方: docs/manual/08-csharp.md に環境変数 LUB_TCS が無く、README.md は 3 つ目の候補を書かない。
  • csproj から lub が読むもの: docs/manual/08-csharp.md は csproj のディレクトリの *.cs だけを書き、Lub="Source" の参照と *.ref.cs を書かない (docs/api-glue.md にだけある)。
  • lubx: docs/manual/06-lub-lubx.md は lubx を純粋な C# と書くが、C の実装 (src/lubx/vorbis.c、stub の namespace Lubx) がある。

変更

話題ごとに正を 1 か所にし、実装に合わせて直し、ほかはそこを指す。

話題 正 正を指すようにした所
golden の比べ方と byte 一致の条件 scripts/run-golden.sh の先頭のコメント (mesa の版と、inbox と NuGet の WARP の違いを足す) README.md、docs/d3d12-backend.md、docs/design.md、ci.yml のコメント
backend の値と platform ごとの既定 stub の ConfigOpts.Backend (openxr と Android の既定を足す) README.md、docs/design.md
lub が tcs を探す順 docs/manual/08-csharp.md (LUB_TCS を足し、順を番号の列にする) README.md
csproj から lub が読むもの docs/manual/08-csharp.md の新しい節 (Lub="Source" の参照、*.ref.cs) docs/api-glue.md、同じ章の lub check の段落
lubx の C の面 docs/api-glue.md docs/manual/06-lub-lubx.md (純粋な C# の記述を直す)
超越関数の一覧 tcs の doc/il-spec.md の 13 節 docs/design.md

csproj から読むものの正は、#649 の表では docs/api-glue.md としたが、ゲームを書く人が読む約束なので manual の章にした。

stub を変えたので、scripts/gen-api.sh で生成物 (include/lub/lub_api.h、dotnet/Lub/Lub.g.cs、web/gen/lub-api-docs.json) を作り直した。

確かめたこと

  • scripts/docs-lint.sh と scripts/gen-api.sh --check が通る。
  • 正に書いたことは実装で確かめた: src/app.c の LUB_DEFAULT_BACKEND と openxr を組み込む条件 (root の CMakeLists.txt)、src/tcs_build.c の resolve_tcs_cmd、src/vm_project.c の collect_refs と scan_dir、tcs/runtime/math の file と各 file の先頭のコメント。

入れなかったもの

Refs #649

🤖 Generated with Claude Code

https://claude.ai/code/session_01Bkc8zTBHyUd33xex3cycYb

… か所に書き、ほかはそこを指す

golden の byte 一致の条件は scripts/run-golden.sh の先頭のコメントを正にし、lavapipe の出力が mesa の版で変わること (CI の linux job が比較を外す理由) を書く。README.md、docs/d3d12-backend.md、docs/design.md、ci.yml のコメントはそこを指す。
backend の値と platform ごとの既定は stub の ConfigOpts.Backend を正にし、無かった openxr と Android の既定を足す。README.md と docs/design.md の既定の一覧はそこを指す。
lub が tcs を探す順と csproj から読むもの (Lub="Source" の参照と *.ref.cs) は docs/manual/08-csharp.md を正にし、抜けていた LUB_TCS と参照の規則を足す。README.md と docs/api-glue.md はそこを指す。
docs/manual/06-lub-lubx.md の、lubx を純粋な C# とする記述を、C の実装を持つ所がある形に直す。
docs/design.md の超越関数の一覧は tcs の il-spec を指す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bkc8zTBHyUd33xex3cycYb
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant