From cfe12e6a0e19482c7f4c228875aa209c6d65eb30 Mon Sep 17 00:00:00 2001
From: juga0 <juga@riseup.net>
Date: Sun, 5 May 2019 06:28:26 +0000
Subject: bandwidth-file: Add HeaderLine non-terminal

To make more clear that header lines do not contain spaces and simplify
parsers.
This does not change the format.

Closes: #30311
---
 bandwidth-file-spec.txt | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'bandwidth-file-spec.txt')

diff --git a/bandwidth-file-spec.txt b/bandwidth-file-spec.txt
index 1c36558..2776fab 100644
--- a/bandwidth-file-spec.txt
+++ b/bandwidth-file-spec.txt
@@ -112,6 +112,7 @@
 
     Line ::= ArgumentChar* NL
     RelayLine ::= KeyValue (SP KeyValue)* NL
+    HeaderLine ::= KeyValue NL
     KeyValue ::= Keyword "=" Value
     Value ::= ArgumentCharValue+
     ArgumentCharValue ::= any printing ASCII character except NL and SP.
@@ -141,6 +142,14 @@
 
 2.2. Header List format
 
+  It consists of a Timestamp line and zero or more HeaderLines.
+
+  All the header lines MUST conform to the HeaderLine format, except
+  the first Timestamp line.
+
+  The Timestamp line is not a HeaderLine to keep compatibility with
+  the legacy Bandwidth File format.
+
   Some header Lines MUST appear in specific positions, as documented
   below. All other Lines can appear in any order.
 
-- 
cgit v1.2.3-54-g00ecf