[NUT-devel] [nut]: r582 - docs/nut.txt

[michael]

Author: michael
Date: Tue Feb  5 00:05:01 2008
New Revision: 582

Log:
Make nut capable to handle attachments.
Alternative suggestions are welcome


Modified:
   docs/nut.txt

Modified: docs/nut.txt
==============================================================================
--- docs/nut.txt	(original)
+++ docs/nut.txt	Tue Feb  5 00:05:01 2008
@@ -923,8 +923,8 @@ stream_header (id=1)
 ...
 stream_header (id=n)
 
-Headers may be repeated, but if they are, then they MUST all be repeated
-together and repeated headers MUST be identical.
+Headers may be repeated, but if they are, then all mandatory headers MUST be
+repeated and repeated headers MUST be identical.
 
 Each set of repeated headers not at the beginning or end of the file SHOULD
 be stored at the earliest possible position after 2^x where x is an integer.
@@ -934,12 +934,22 @@ So the headers may be repeated at 4102 i
 Note: This allows an implementation reading the file to locate backup
 headers in O(log filesize) time as opposed to O(filesize).
 
-Headers MUST be placed at least at the start of the file and immediately before
+All headers MUST be placed at least at the start of the file.
+Mandatory headers MUST additionally be placed immediately before
 the index or at the end of the file if there is no index.
-Headers MUST be repeated at least twice (so they exist three times in a file).
+Mandatory headers MUST be repeated at least twice (so they exist three times
+in a file).
 
 There MUST be a syncpoint immediately before the first frame after any headers.
 
+The main header is mandatory, so are all stream headers except thouse for
+redundant and enhanchement streams. So for example if the file contains 2
+independant video streams encoding the same content at 2 different bitrates.
+Then only one is mandatory, which that is, is at the discretion of the muxer.
+Enhancement streams like font attachments are also non mandatory.
+The muxer SHOULD repeat non mandatory stream headers like mandatory ones if
+the overhead is not excessive.
+
 
 Index:
 ------