Skip to content

docs: correct DV routing, CLI flags, and source map against 4.6.3#84

Merged
superuser404notfound merged 1 commit into
mainfrom
docs/accuracy-pass-4.6.3
Jun 27, 2026
Merged

docs: correct DV routing, CLI flags, and source map against 4.6.3#84
superuser404notfound merged 1 commit into
mainfrom
docs/accuracy-pass-4.6.3

Conversation

@superuser404notfound

Copy link
Copy Markdown
Owner

Audited the README and docs/{architecture,formats,cli}.md against the actual sources at HEAD (4.6.3) and fixed the drift found. Docs-only, no code changes.

formats.md (the biggest miss: Dolby Vision signaling)

  • DV routing table no longer collapses P5 / P8.1 / P8.4 under "dvh1 / dvhe". Reality per CodecRoutePolicy.swift: P5 emits a bare dvh1 primary; P8.1 / P8.4 / P7 emit hvc1 primary + dvvC with dvh1.08/db1p or /db4h in SUPPLEMENTAL-CODECS on DV panels, plain HDR10 / HLG base elsewhere. dvhe is never emitted.
  • AV1+DV corrected: P10.0 / P10.1 are bare dav1 with no supplemental; only P10.4 carries the dav1/db4h supplemental.
  • Documented the SDR-compatible-base profiles (HEVC P8.2, AV1 P10.2) that strip the DV config and play the Rec.709 base on every panel.

cli.md

  • "Fifteen subcommands" was off by one (sixteen).
  • hlslive --segments is a required comma-separated list of .ts paths, not a numeric sizing flag; clarified --seconds / --segment-seconds / --disc.
  • serve --native-subs: the <index> value is legacy and ignored; the flag drives requestNativeSubtitleTrack() + attachAllNativeSubtitleStores(), not LoadOptions.prepareNativeSubtitles.
  • Added the undocumented flags: live --serve-only / --rewind-test / --gen-highbitrate-seed, and customio --audio-only.

architecture.md source map

  • Added the omitted files: DiscRecognitionCache, HTTPDiscIOReader, MovTextSampleBuilder, NativeSubtitleCueStore, DoviRpuConverter+Probe, Issue65LivelockBreakers.
  • Added the AetherEngineSMB target subtree and a pointer to cli.md for the aetherctl target.

README.md

  • Audio bridge row now lists DTS-HD MA.
  • Documented LoadOptions.nativeRemoteHLS for AVPlayer-native remote HLS.

Each claim was verified against the cited source (CodecRoutePolicy.swift, Serve.swift, HLSLiveRepro.swift, main.swift, the Sources/ tree). All cross-doc anchors and file links resolve; no broken references.

🤖 Generated with Claude Code

Audited README + docs/{architecture,formats,cli}.md against the actual
sources at HEAD (4.6.3) and fixed the drift found:

formats.md (Dolby Vision signaling was the biggest miss):
- DV routing table no longer collapses P5/P8.1/P8.4 under "dvh1/dvhe".
  P5 emits a bare dvh1 primary; P8.1/P8.4/P7 emit hvc1 primary + dvvC
  with dvh1.08/db1p or /db4h in SUPPLEMENTAL-CODECS on DV panels, plain
  HDR10/HLG base elsewhere. dvhe is never emitted.
- AV1+DV corrected: P10.0/P10.1 are bare dav1 with no supplemental,
  only P10.4 carries the dav1/db4h supplemental.
- Documented the SDR-compatible-base profiles (HEVC P8.2, AV1 P10.2)
  that strip the DV config and play the Rec.709 base on every panel.

cli.md:
- "Fifteen subcommands" was off by one (sixteen).
- hlslive --segments is a required comma-separated list of .ts paths,
  not a numeric sizing flag; clarified --seconds/--segment-seconds/--disc.
- serve --native-subs: the index value is legacy/ignored; the flag drives
  requestNativeSubtitleTrack + attachAllNativeSubtitleStores, not
  LoadOptions.prepareNativeSubtitles.
- Added the undocumented flags: live --serve-only/--rewind-test/
  --gen-highbitrate-seed and customio --audio-only.

architecture.md source map:
- Added the omitted files: DiscRecognitionCache, HTTPDiscIOReader,
  MovTextSampleBuilder, NativeSubtitleCueStore, DoviRpuConverter+Probe,
  Issue65LivelockBreakers.
- Added the AetherEngineSMB target subtree and a pointer to cli.md for
  the aetherctl target.

README.md:
- Audio bridge row now lists DTS-HD MA.
- Documented LoadOptions.nativeRemoteHLS for AVPlayer-native remote HLS.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XZTEfmztPE8hAdjHdBr9BH
@superuser404notfound superuser404notfound merged commit c8d6f8a into main Jun 27, 2026
3 checks passed
@superuser404notfound superuser404notfound deleted the docs/accuracy-pass-4.6.3 branch June 27, 2026 10:35
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