From: Kevin Day <thekevinday@gmail.com>
Date: Thu, 6 Jan 2022 04:05:40 +0000 (-0600)
Subject: Feature: Add fss-000e Payload specification.
X-Git-Tag: 0.5.8~139
X-Git-Url: https://git.kevux.org/?a=commitdiff_plain;h=ef8a80f8c5d811919dc8db0370fd39633e571ad6;p=fll

Feature: Add fss-000e Payload specification.
---

diff --git a/specifications/fss-000e.txt b/specifications/fss-000e.txt
new file mode 100644
index 0000000..b319bb0
--- /dev/null
+++ b/specifications/fss-000e.txt
@@ -0,0 +1,44 @@
+# fss-0002
+#
+# Note: This file is in fss-0002 format and as a result the example below has to be escaped (can potentially be confusing when reading this raw).
+#       The "header\:" in the example below is actually "header:" when processed by fss-0002.
+
+Featureless Settings Specification: 000e - Payload:
+  This is a fss-0002 Basic List with two required objects\:
+  1) "header".
+  2) "payload".
+
+  The header's Content is of type fss-0001 Extended.
+  The payload's Content is of any type including raw binary data.
+
+  The payload is recommended to be the last list Object in the file.
+  The payload is recommended to have its size designated in some manner in the "header".
+  The designated size is sugggested to use the fss-0001 Object "length".
+  The payload may contain anything, including NULL characters.
+
+  Other than the reserved list Objects "header" and "payload" any other valid Object may be specified.
+
+  Example\:
+    # fss-000e
+    # valid comments are ignored.
+    header\:
+      type error
+      status 296
+
+    payload\:
+    The program is out of memory.
+
+  Outer Objects would be\:
+    1) header
+    2) payload
+
+  "header" Objects would be\:
+    1.1) type
+    1.2) status
+
+  "header" Contents would be\:
+    1.1.1) error
+    1.2.1) 296
+
+  The payload would be\:
+    2) The program is out of memory.
diff --git a/specifications/fss.txt b/specifications/fss.txt
index c8f0875..caec0f3 100644
--- a/specifications/fss.txt
+++ b/specifications/fss.txt
@@ -139,3 +139,4 @@ Featureless Settings Specifications:
   - fss-000b: Simple List
   - fss-000c: Iki Text
   - fss-000d: Basic Rule
+  - fss-000e: Payload