# fss-0002 iki-0000
#
# license: open-standard-license-1.0-or-later
# version 2025/11/21
#
# This file (assumed to be named controlfile.txt) can be more easily read using the following iki_read commands:
#   iki_read controlfile.txt +Q -w -WW code '"' '"' file '"' '"'
#
# To read the "Control File Documentation" section of this file, use this command sequence:
#   fss_basic_list_read controlfile.txt +Q -cn "Control File Documentation" | iki_read +Q -w -WW code '"' '"' file '"' '"'
#

Control File Documentation:

  A control file is intended to be used by controller programs similar to how the code:"fakefile" is used by the bold:"Featureless Make" program.

  A control file consists of the file:"entry.txt", file:"exit.txt", and file:"rule.txt" all merged into a single file.
  The goal of of a control file is to collapse the directory hierarchy structure into a single file.
  This imposes no new Objects or other structures.

  Any modifications, or deviations, from this standard that add additional things beyond the bold:"Entry", bold:"Exit", and bold:"Rule" are encouraged to follow the naming prefix pattern.
  The naming pattern is the simple standard name, like code:"entry", code:"exit", or code:"rule" followed by a forward slash (unicode:"U+002F") as a prefix.
  Then all Object names would then have that prefix.

  For example, if there is an bold:"Entry" named code:"main", then the control file representation would be code:"entry/main".

  A bold:"Rule", in addition, also has the directory path part appended (where only a forward slash (unicode:"U+002F") is allowed to represent a directory separation) followed by a forward slash (unicode:"U+002F") as part of the prefix.

  For example, if there is an bold:"Rule" named code:"one" from a directory named code:"terminal" with a bold:"Script", then the control file representation would be code:"rule/terminal/one/script".

  Due to the use of a forward slash (unicode:"U+002F"), bold:"Item" names for an bold:"Entry" or a bold:"Rule" should avoid using a forward slash (unicode:"U+002F").
