Skip to content

Commit aae30cc

Browse files
android(net): rewrite Api.kt KDoc to avoid embedded '*/' close-comment marker
The Wave-3 scaffold's docstring contained a literal '`*/public`' inside a /** … */ KDoc block. Kotlin's KDoc parser does not escape '*/'; it terminates the comment at the first occurrence, so 'public' became a code token and kotlinc fired 'Syntax error: Expecting a top level declaration' for every subsequent byte of the file. First caught by android.yml run 26395264293. Rewrote the line to read '`/public` sub-path' with an inline note explaining the workaround. Same intent, parser-safe.
1 parent f934014 commit aae30cc

1 file changed

Lines changed: 3 additions & 2 deletions

File tree

  • android/app/src/main/java/dev/zeroauth/android/net

android/app/src/main/java/dev/zeroauth/android/net/Api.kt

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,9 @@ import java.util.concurrent.TimeUnit
2222
* stretch: it returns the human-readable "Sign in to Chrome on a
2323
* MacBook Pro" label IF the backend has populated it.
2424
*
25-
* Why a separate `*/public` path (NOT documented in api_contract.md as
26-
* of 2026-05-22):
25+
* Why a separate `/public` sub-path (NOT documented in api_contract.md
26+
* as of 2026-05-22 — the literal `* /public` would close this KDoc
27+
* block, so the path is written without the leading asterisk):
2728
*
2829
* - The phone holds NO tenant API key. ADR-0009 § "Phone is
2930
* air-gapped from the backend" explicitly says the phone never

0 commit comments

Comments
 (0)