Continued:

[core.git] / contrib / file_stack / format.txt

diff --git a/contrib/file_stack/format.txt b/contrib/file_stack/format.txt
index 2a646c82f49a639a1cd23cf8fa351d51692d3459..058b5b879a9e72436ec6b83ebfd6396d555d87ae 100644 (file)
--- a/contrib/file_stack/format.txt
+++ b/contrib/file_stack/format.txt
@@ -1,23 +1,24 @@
 A file-based stack:
 ===================
 
 A file-based stack:
 ===================
 

-This is the format for a file-based stack which works as any Stackable class.
+This is the format for a file-based stack which works as any other Stackable
+class.

 
 General made up:
 
 
 General made up:
 

-Purpose: | "magic"   | separator | count    | position      | separator |
----------+-----------+-----------+----------+---------------+-----------+
-Bytes:   | 9         | 1         | 20 (hex) | 2 - n^2 (hex) | 1         |
----------+-----------+-----------+----------+---------------+-----------+
-Example: | STACKv1.0 | 00        | 00...ff  | 01            | ff        |
+Purpose: | "magic"   | separator | count    | separator | position | separator |
+---------+-----------+-----------+----------+-----------+------0---+-----------+
+Bytes:   | 9         | 1         | 20 (hex) | 1         | 20 (hex) | 1         |
+---------+-----------+-----------+----------+-----------+----------+-----------+
+Example: | STACKv1.0 | 01        | 00...ff  | 01        | 00...ff  | 02        |

 
 Continued:
 
 Purpose: | hash 0 | separator | name 0 | entry 0    | hash n | separator | name n | entry n    | EOF |
 ---------+--------+-----------+--------+------------+--------+-----------+--------+------------+-----+
 
 Continued:
 
 Purpose: | hash 0 | separator | name 0 | entry 0    | hash n | separator | name n | entry n    | EOF |
 ---------+--------+-----------+--------+------------+--------+-----------+--------+------------+-----+

-Bytes:   |  ???   | 1         | 10     | 1-n (pack) |  ???   | 1         | 10     | 1-n (pack) | 1   |
+Bytes:   |  64    | 1         | 10     | 1-n (pack) |  64    | 1         | 10     | 1-n (pack) | 1   |

 ---------+--------+-----------+--------+------------+--------+-----------+--------+------------+-----+
 ---------+--------+-----------+--------+------------+--------+-----------+--------+------------+-----+

-Example: | abc    |    ???    | foo    |    ...     | abc    |    ???    | bar    |     ...    | EOF |
+Example: | abc    |    03     | foo    |    ...     | abc    |    03     | bar    |     ...    | EOF |

 
 Explanations:
 -------------
 
 Explanations:
 -------------


@@ -25,8 +26,9 @@ Explanations:
  separator    - Serves to detect end of strings with unknown/flexible length
  count        - Total amount of entries (not deleted) encoded in hexa-decimal
  position     - Seek position of current entry (which current() will give)
  separator    - Serves to detect end of strings with unknown/flexible length
  count        - Total amount of entries (not deleted) encoded in hexa-decimal
  position     - Seek position of current entry (which current() will give)

- hash X       - Hash sum of entry X
+ hash X       - Hash sum of entry X (SHA 256)

  name X       - Name of stack the entries belongs in
  entry X      - The actual data, compressed with pack()
  EOF          - End-of-file character
  name X       - Name of stack the entries belongs in
  entry X      - The actual data, compressed with pack()
  EOF          - End-of-file character

+ ...          - Data

  ???          - Must be still found out which character/hashing algorthym fits best
  ???          - Must be still found out which character/hashing algorthym fits best