From 37e056f070a4878b225ab02115f2c9e7ec41b9a4 Mon Sep 17 00:00:00 2001
From: Matthew Jackson <1085847+MattJackson@users.noreply.github.com>
Date: Sun, 2 Aug 2026 18:27:01 -0700
Subject: [PATCH] Say plainly that the vendor playlist format is not a
 specification

---
 src/labels/paramount.rs | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/src/labels/paramount.rs b/src/labels/paramount.rs
index 9dbc6b7..c100898 100644
--- a/src/labels/paramount.rs
+++ b/src/labels/paramount.rs
@@ -3,6 +3,13 @@
 //! Richest structured format. Complete language lists with forced flags
 //! and commentary indices per playlist, all in XML attributes.
 //!
+//! NOT A SPECIFICATION. `/BDMV/JAR/` is application-defined space, so this
+//! file is one authoring house's internal metadata that happens to ship on
+//! the pressing. There is nothing to look up: every field meaning here was
+//! derived by measuring real discs and cross-checking against per-display-set
+//! content. Treat an unfamiliar value as unknown rather than guessing — the
+//! disc's own `forced_on_flag` is the only authoritative forced signal.
+//!
 //! ```xml
 //! <playlist name="Feature" id="00222"
 //!   aud="eng,deu,spa,spa,fra"
@@ -35,8 +42,9 @@ pub fn parse(reader: &mut dyn SectorSource, udf: &UdfFs) -> Option<ParseResult>
     if labels.is_empty() {
         return None;
     }
-    // High confidence: paramount's playlists.xml is fully structured
-    // and we extract every documented field.
+    // High confidence: this format is fully structured and we extract
+    // every field whose meaning the corpus establishes. "Documented" would
+    // be the wrong word — see the module note; nothing about it is.
     Some(ParseResult::high(labels))
 }