git.lucas.co / cce-browser
web browser (Servo)
git clone https://git.lucas.co/cce-browser.git

commitab26d4d8ca3afe265726e477abeaa74dcea001c8
parentcd520a0915
authorLucas Galante <[email protected]>
date2026-09-19 07:34
docs: sixteen files, not eight; mark webview.rs as the retired backend

"Eight files, ~3k lines" is sixteen files and ~8.8k — the crate roughly
tripled, most of it the WPE port's `src/wpe/` (host, input, subclass,
glib_source, formwatch) plus lineedit.rs. The table covers ten of them; it
now says so rather than implying it is the whole crate.

The table also listed `src/webview.rs` as if it were live code. It is the
retired Servo backend behind the non-default `servo` feature, not built by a
plain `cargo build`. The intro says Servo survives behind a flag, but a
reader going straight to the file table — which is what a file table is for —
had no way to tell which of the ten entries is the engine and which is the
museum piece.

Co-Authored-By: Claude Opus 5 <[email protected]>

 CLAUDE.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 207a9bd..2372873 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,14 +14,14 @@ fetch-only static mirror now kept as the `published` remote). Read the workspace
 `../cce-compositor/WORKSPACE.md` first: workspace layout, the `cce-ui` toolkit, config
 conventions, and the multi-repo rules all live there.
 
-Eight files, ~3k lines:
+Sixteen files, ~8.8k lines. The ten that carry the design:
 
 | file | what it owns |
 | --- | --- |
 | `src/main.rs` | `BrowserApp` — the `cce-ui` `Application`: chrome layout, hit-testing, the URL line editor, key/pointer routing |
 | `src/instance.rs` | single-instance forwarding: a later launch hands its argument to the running instance's socket and exits |
 | `src/bin/open.rs` | `cce-browser-open`, the desktop entry's `Exec` target: a ~500KB forwarder linking only libc (~4ms vs ~22ms through the full binary), exec'ing `cce-browser` when no instance answers |
-| `src/webview.rs` | `ServoHost` — Servo boot, the delegate, one `WebView` per tab, the frame pipeline |
+| `src/webview.rs` | **retired backend, behind the non-default `servo` feature** — `ServoHost`: Servo boot, the delegate, one `WebView` per tab, the frame pipeline. Not built by `cargo build`; see WPE-PORT.md |
 | `src/pages.rs` | the `cce:` protocol handler and its History / Bookmarks / Favorites stores |
 | `src/downloads.rs` | the chrome-side download pipeline (Servo has none) |
 | `src/session.rs` | open-tab persistence: the tab set survives a restart |