Merge commit 'origin/translations' into experimental

[enigma2.git] / doc / FILEFORMAT

diff --git a/doc/FILEFORMAT b/doc/FILEFORMAT
index 1f8fcdd2d64a86ee6f86d6c6976310bfc37398f8..66e9598c47279f534156a450eb057ec4ec0c7c94 100644 (file)
--- a/doc/FILEFORMAT
+++ b/doc/FILEFORMAT
@@ -6,13 +6,28 @@ They don't have a private header.
 
 == .meta FILES ==
 
-.meta files have currently 4 lines:
+.meta files have currently up to 7 lines:
 
 <service reference>
 <name>
 <description>
 <recording time>
+[<tags>]
+[<length>]
+[<filesize>]
 
+The service reference contains the Service-ID of the recorded service. With
+that ID, you can find the PMT and the elementary streams.
+
+As a backup method, just find the first available PMT and use that.
+
+Strings are always UTF-8 encoded.
+
+tags is a space-delimited list of tags assigned to this movie.
+
+length is the length of the recording, in PTS-units (1/90000s). filesize was
+the filesize at the time the length was calculated, so you can validate if
+this is still up-to-date or must be recalculated.
 
 == .ap FILES ==
 
@@ -44,3 +59,8 @@ implicit 'in' point at zero.
 If the there is no final 'out' point, the end-of-file is an implicit
 'out'-point.
 
+Note that the PTS values are zero-based and continouus. If you want absolute
+PTS values, you can either:
+ - use the .ap file, find discontinuities, and interpolate between the APs
+ - or just use the first PTS value as an offset, and work around PTS
+   wraparounds. (simple method)