Say plainly that the vendor playlist format is not a specification

This commit is contained in:
Matthew Jackson
2026-08-02 18:27:01 -07:00
parent 1df36c78b2
commit 37e056f070
+10 -2
View File
@@ -3,6 +3,13 @@
//! Richest structured format. Complete language lists with forced flags //! Richest structured format. Complete language lists with forced flags
//! and commentary indices per playlist, all in XML attributes. //! 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 //! ```xml
//! <playlist name="Feature" id="00222" //! <playlist name="Feature" id="00222"
//! aud="eng,deu,spa,spa,fra" //! 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() { if labels.is_empty() {
return None; return None;
} }
// High confidence: paramount's playlists.xml is fully structured // High confidence: this format is fully structured and we extract
// and we extract every documented field. // 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)) Some(ParseResult::high(labels))
} }