FLL - Specifications - FSS-0002 (Basic List)
Author: Kevin Day
Description: Featurless Linux Library Specifications
Keywords: Featureless, FLL, Kevin Day, Kevux, Linux, Library, Distribution, Open-Source, specification, standard, fss-0002, basic list

# Featureless Linux Library Specification

## FSS-0002 (Basic List)

The version date of this specification is `2024/08/30`.

Each Object starts at the beginning of a line and white space to the left of the Object is not treated as an Object. A colon `:` (`U+003A`) followed by any white space until a new line terminates a valid Object. White space after the last printable character of the Object but before the colon `:` (`U+003A`) is not considered part of the Object. Non-white space printable characters may not follow the colon of a valid Object. Implementations of the standard may choose to include the white space to the left and to the right of a valid Object may be included as an untrimmed Object.

Content is represented as a single Content column of every line following a valid Object until the end of file (or string) or until the next valid Object is found. Any Content that could be interpreted as a valid Object must have the colon delimited.

There is no single-quote (`U+0027`), double-quote (`U+0022`), or grave (`U+0060`) delimitation in this specification. Only a colon `:` (`U+003A`) that would result in a valid Object can be delimited.

Empty Objects are allowed, that is, the length of the Object may be zero.

Key:

- `\s` = White space, except new line.
- `\o` = Any printable character, except unescaped `:` (`U+003A`).
- `\c` = Either white space or printable, including new line, that not interpretable as an Object.
- `\n` = New line.
- `*` = Zero or more occurrences.

Before Structure:

- ``

Structure:

- `\s*\o\s*:\s*\n\c*\n*`

After Structure:

- ``

Example:

    # fss-0002
    # valid comments are ignored.
    "The Object":
      Does not need to be quoted.
      This: does not need to be delimited.
      This Does\:
    Second:
      Continues until EOS/EOF.
      All white space, including new line (and leading white space) is "part of content."
      # Valid comments are still ignored.

Example Results:

    Objects would be:
      1) "The Object"
      2) Second

    Contents would be:
      1.1) Does not need to be quoted.
           This: does not need to be delimited.
           This Does:
      2.1) Continues until EOS/EOF.
           All white space, including new line (and leading white space) is "part of content."