docs(protocol): describe extension scanning without internal phase names
- commit
- 72b1a2801c13a45eec1086a1a208b6de5e7dfa05
- author
- brice · · 2026-09-28 08:49 UTC
- parent
- edb855f
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
2 files · +3 -3
M docs/protocol-migration.md +2 -2
| @@ -25,5 +25,5 @@ The scanner accepts `-import wl_surface=github.com/bnema/wlturbo/protocol/core` | |||
| 25 | 25 | (repeat for each external type); local XML definitions take precedence, then | |
| 26 | 26 | explicit external mapping, then only bootstrap display/registry. Generate with | |
| 27 | 27 | `GOWORK=off go generate ./...`; metadata and XML license are in | |
| 28 | - | `protocol/SOURCE.md`. P3 extensions will use the same scanner and public core | |
| 29 | - | mappings; no generator-owned compositor policy is introduced here. | |
| 28 | + | `protocol/SOURCE.md`. Extension packages under `protocol/` use the same scanner | |
| 29 | + | and public core mappings; the generator carries no compositor policy. | |
| @@ -25,5 +25,5 @@ The scanner accepts `-import wl_surface=github.com/bnema/wlturbo/protocol/core` | |||||
| 25 | (repeat for each external type); local XML definitions take precedence, then | 25 | (repeat for each external type); local XML definitions take precedence, then | ||
| 26 | explicit external mapping, then only bootstrap display/registry. Generate with | 26 | explicit external mapping, then only bootstrap display/registry. Generate with | ||
| 27 | `GOWORK=off go generate ./...`; metadata and XML license are in | 27 | `GOWORK=off go generate ./...`; metadata and XML license are in | ||
| 28 | - | `protocol/SOURCE.md`. P3 extensions will use the same scanner and public core | 28 | + | `protocol/SOURCE.md`. Extension packages under `protocol/` use the same scanner |
| 29 | - | mappings; no generator-owned compositor policy is introduced here. | 29 | + | and public core mappings; the generator carries no compositor policy. |
M internal/scanner/scanner_test.go +1 -1
| @@ -47,7 +47,7 @@ func TestCoreGeneration(t *testing.T) { | |||
| 47 | 47 | } | |
| 48 | 48 | } | |
| 49 | 49 | ||
| 50 | - | // P3 uses wl_buffer as both an event-created child and a request-created child. | |
| 50 | + | // Extension protocols use wl_buffer as both an event-created child and a request-created child. | |
| 51 | 51 | // Verify the generated code uses the public constructor instead of embedding | |
| 52 | 52 | // an inaccessible BaseProxy context field across package boundaries. | |
| 53 | 53 | func TestExternalChildFactory(t *testing.T) { | |
| @@ -47,7 +47,7 @@ func TestCoreGeneration(t *testing.T) { | |||||
| 47 | } | 47 | } | ||
| 48 | } | 48 | } | ||
| 49 | 49 | ||||
| 50 | - | // P3 uses wl_buffer as both an event-created child and a request-created child. | 50 | + | // Extension protocols use wl_buffer as both an event-created child and a request-created child. |
| 51 | // Verify the generated code uses the public constructor instead of embedding | 51 | // Verify the generated code uses the public constructor instead of embedding | ||
| 52 | // an inaccessible BaseProxy context field across package boundaries. | 52 | // an inaccessible BaseProxy context field across package boundaries. | ||
| 53 | func TestExternalChildFactory(t *testing.T) { | 53 | func TestExternalChildFactory(t *testing.T) { | ||