Update: Out of date build documentation.

The "See: ..." files should now end in ".txt".

The directory structure for both the status project and the work directory have changed since this documentation was last modified.

Update documentation regarding running Featureless Make with no arguments.

Remove redundant "Alternatively..." documentation that is already described elsewhere.

Bugfix: The bootstrap script needs to support settings-specific built files.

Bugfix: The bootsrap script needs to treat -s/--settings as a possible path.

Update: Add fakefile for the FLL monolithic and level builds.

Update: Add not implemented clarifications for 0.6.x versions.

Feature: Add 'import' Object to fakefile and settings specifications.

This is important for building complex project structures and reducing the code redundancy.
To keep the logic and design simple, recursion is not allowed.

One can now create a base settings file that is imported by other settings files.
The same is true for fakefile files.

Cleanup: Fix styling, spelling, and wording mistakes in the specifications and documentation.

Bugfix: Imprecise desciption for --partial.

The original message  a little confusing and misleading.
When running in --partial mode only the Objects or Contents are printed but not both.

Bugfix: FSS write functions should use 'quote' when passed rather than f_fss_delimit_quote_single_s.

Security: Invalid write in FSS functions and ensure a reset used length on error.

The command that triggers this is "fss_basic_write -oc hi there".

An invalid write is happening due to not always performing the array size increase operations.
Update all FSS write functions with more thorough checks.
This problem is being obfuscated by the lossy allocation.

When errors happen the destination->used needs to be consistently reset to the original value on return.

Use the lossy allocation as well for allocation shwere the increase by is a raw digit.
In these specific cases use state.step_small rather than state.step_large.

Rename used_start to destination_used for improved consistency.

Update: the stand alone fake config.h file.

Update: Add more notes to 'disable' about.txt documentation.

Cleanup: Rebuild the config.h file for stand alone byte_dump.

Cleanup: Update the build disable process.

Make changes to the documentation and rebuild the files based on recent changes.

Bugfix: _di_string_ascii_s_ is missing the _f.

Update: Add mising _d in wrapping defines.

Update: The define _di_f_array_t_ should be _di_f_array_length_t_.

Update: The status code wrapping global constant string wrapping defines should end in _s.

Update: The _di_compiler_attributes_ should e _di_compiler_attributes_d_.

Bugfix: Some of the level checking defines have an "s" that should not be there.

Fix incorrect _di_level_0_parameters_checking_, replacing it with _di_level_0_parameter_checking_.
Fix incorrect _di_level_2_parameters_checking_, replacing it with _di_level_2_parameter_checking_.

Update: The status code wrapping defines should end in _e.

Bugfix: The f_environment_max_length should be f_environment_max_length_d.

This is a mistake and should have been f_environment_max_length_d the entire time.

Update: Style guide documentation.

I discovered the style guide is a bit out of date.
As I started cleaning it up I noticed that there is a lot more work needed.

This is a quick pass and more reviewing and fixes should follow.

Update: Add stand alone firewall build.

Bugfix: Add missing dependencies and remove incorrect library from firewall program.

Update: Remove unused "test" mode and add "clang" mode to stand alone builds.

Update: The disable defines files need to be updated when defines change.

Update: The fake stand alone build defines.

Redesign to match the more recent stand alone config.h structure.

Cleanup: Add updated type and add commented out status codes.

The status codes should always be present for consistency between programs despite these being stand alone.

Update: The ifndef wrappers should end in _t_ to represent it wrapping a type.

Cleanup: Remove random '_f' in ifndef define.

Cleanup: Update the stand alone utf8 to match how the byte_dump stand alone is designed.

Bugfix: The private is_zero_width function is also needed by the is_graph functions.

Cleanup: Remove random '_f' added to ifndef define.

Update: Wrap the conversion digits defines in _di_f_conversion_digits_d_.

Also remove the extra _di_f_type_number_64_t_ from the build disable defines.

Bugfix: Add missing ifdefs for f_file_stat() and f_file_stat_at().

Update: Add pre-built define files for stand alone use.

Use these per-project files for adding a complete list of functions, structures, and macros with each ifdef define block disabled.

Cleanup: The static inline functions are being included when the function they call is not.

Wrap the static inline functions with the appropriate wrapping defines.

Cleanup: Update stand alone config.h files and add an additional comment.

Bugfix: The type_array is probably a dependency for most of these.

Almost everything is using an array from f_type_array.
Add this dependency to all programs rather than investigating every case.

Cleanup: The utf8 stand alone program does not need the libcap.so.

Bugfix: Incorrect ifndef defines for some functions and structures.

The _di_string_ascii_s_ is incorrect and should instead be _di_f_string_ascii_s_.

These have been exposed while building the stand alone which is very sensitive to the defines.

Cleanup: Rename quoted to quote.

There are several cases where "quoted" is still used.
This is likely the result of a long lost incomplete refactor.

Cleanup: Use file parameter is not in alphabetic ordering.

Update: FSS and IKI specification now supports backticks for quoting similar to single and double quotes.

The 0.6 version is not having this support added to prevent API breakage.
This should be supported in 0.7 and greater.

Bugfix: Invalid print of character when a placeholder should be printed in byte_dump.

The following is happening:
  # clear ; echo -n "xa" | byte_dump -wt 2 && echo -n "∩" | byte_dump -wt 2 && echo -n "∩xa" | byte_dump -wt 2

  Piped Byte Dump: (in Hexidecimal)
  0000000000000000  78 61  | x a  |

  Piped Byte Dump: (in Hexidecimal)
  0000000000000000  e2 88  | ∩    |
  0000000000000001  a9     | ∩    |

  Piped Byte Dump: (in Hexidecimal)
  0000000000000000  e2 88  | ∩    |
  0000000000000001  a9 78  |   x  |
  0000000000000002  61     | a    |

In the second case the line 0000000000000001 should not print the string '| ∩    |'.
This is happening because the character is not being properly reset in the situation where the overflow happens at the end of input.

With this change the results should now be:
  # clear ; echo -n "xa" | byte_dump -wt 2 && echo -n "∩" | byte_dump -wt 2 && echo -n "∩xa" | byte_dump -wt 2

  Piped Byte Dump: (in Hexidecimal)
  0000000000000000  78 61  | x a  |

  Piped Byte Dump: (in Hexidecimal)
  0000000000000000  e2 88  | ∩    |
  0000000000000001  a9     |      |

  Piped Byte Dump: (in Hexidecimal)
  0000000000000000  e2 88  | ∩    |
  0000000000000001  a9 78  |   x  |
  0000000000000002  61     | a    |

Perform a trivial cleanup/optimization where inverse of bytes is being checked for.
This is pointless when there is an else block.
Reverse the order and remove the "not" operator.

Cleanup: Minor improvement to comments and specifications.

Bugfix: The fss_payload_write should not allow "payload" to be something other than last when specified.

Update: Fix and improve FSS unit test regarding zero-width.

Recent changes to the Unicode functions regarding zero-width improved or changed how what is designated as a zero-width character.
The test is failing due to this change.

Update the test to treat the tested character as zero-width.
Add an additional test condition to test the stop range.

Regression: The f_console_environment_process() is accidentally set to private.

The commit 05c24138c0ad8f15a557274f21956fed206fec23 accidentally set the public function to private.
There are private functions that were set to private here but I somehow added F_attribute_visibility_internal_d to a public function.

Regression: Improper execution when no arguments and no pipe are passed to fake.

At some point in time the default for executing without a "clean", "make", or "build" stopped working.
This probably happened when I fixed the empty pipe bug.

The default should run the "make" operation.

Security: Invalid access when calling fake without 'make' or 'build'.

This is caused by the F_data_not return result not being processed in some of the fl_fss functions.

Additional changes:
- Make the return status constant.
- The status is being returned regardless in some cases so remove the effectively redundant lines of code.
- Combined the additional if condition blocks together.

Update: All projects should have fakefiles.

This is an oversight and neither a bug nor a feature.

The FLL is designed to be built using the build settings.
The flagship program fake, should still be directly supported and fakefiles should be available.
Most of these fakefiles just trigger the build settings.

Bugfix: The level_0 console should use private functions.

The level_0 f_console_identify function should not be directly called by another function in this project.
Create a private function and call that function.

This is the standard practice for this project
This improves hackability.

Bugfix: The first character never gets printed for payload Content.

Bugfix: Add missing f_type_array dependency.

The f_type_array dependency is now present in the build settings file.

Cleanup: The fake program doesn't depend on fll_iki.

Feature: Add support for additional dependencies and settings files in level_3.

The package.sh build system helper script now supports additional dependencies and settings files.
This allows for special build modes, such as how the controller program has support for "controller" and "init" programs.

Bugfix: Incomplete UTF-8 zero-width detection, particularly for combining characters.

The zero-width calculations should be and are not including zero-width and most control characters.
The combining characters and most of the control characters are now considered zero-width.

Cleanup: Add comment about special control code handling.

Cleanup: Add comment about BOM.

Bugfix: Incorect spacing when combining --unicode with other digit displays.

The original calculations are again the 6-digit Unicode "U+1234".
There are also 8-digit Unicodes "U+123456".

Update: Next micro version (0.6.2).

Update: Slight improvement in UTF unassigned detection and add or correct some ranges.

Change "character" to "sequence" to be consistent with the rest of the private functions.

Add several additional checks to ideally reduce the number of checks.
This is only a cursory pass and not much effort is put into fine-tuned optimization.
There is huge room for improvement.

I discovered some ranges that needed to be added as unassined and added them.
Include the invalid ranges as unassigned.

Bugfix: Two 0's are printed when --total is used and there are no matching Objects.

There is an optimization used that immediately prints 0 and returns if there is no matching data on load.
The problem is that the caller isn't told that it should stop processing because F_none is returned.

Remove the optimization rather than implementing a custom return code and changing the code to handle this.
The normal code is still run and still correctly determines that there are 0 Objects.

Feature: Add support for ZSH in addition to BASH.

Some systems have started provided ZSH for license reasons (they don't want to agree to the license of BASH).
I experimented with and found that I can make my scripts ZSH friendly.

There is no way to "detect" that ZSH is being used as far as I can tell so I defined a new environment variable SHELL_ENGINE.
Set this to "zsh" and then run the script via the "zsh" program.

Enable emulation mode of "ksh" when using ZSH to be BASH friendly.

The ZSH doesn't support "${!i}" substitution.
I found a separate way to do this in ZSH via "${(P)i}".
It is a shame that they cannot simply replace "(P)" with "!".

There are several cases where "bash" is being directly called.
Replace this with a "shell_command" environment variable.
In some cases, directly calling "bash" may cause a loss of needed environment settings and so "bash" is not directly called when using BASH but "zsh" is still directly called when using ZSH.

The ZSH does not automatically handle arrays as well as BASH does.
Explicitly define arra with "-A" and explicitly set the initial value to "()".
Doing this may introduce problems with older versions of BASH that do not support "-A".

The ZSH cannot expand parameters as intelligently as BASH.
Parameters followed by certain characters, such as a bracket, that are not encases in braces result in ZSH errors.
Mass change many of the parameter uses to always be in braces.
Not all cases are changed and there may be some areas where I intended to make such a change and missed.

The ZSH appears not to handle output redirection from shell functions.
This behavior is used heavily in the project for building and using the variables array.
Change the behavior (at the cost of making the code a bit ugglier and harder to read in some cases) to assign a variable defined at a higher scope (such as "key").

The ZSH also appears to utilize "path" as a variable for "PATH" or is case insensitive when it comes to environment variables and shell variables.
This is a serious problem.
The variable "path" is defined so rename that to "path_" to avoid conflicts (and I'll just have to suffer cringing every time I see that trailing underscore).

I stumbled onto some bugs as well while making changes.
The necessary changes change the code that is buggy so I am allowing it to be in the same commit.
One of the bugs is a typo where errror is used rather than error.
Another bug is where the c_warning is used and then c_error is used within the same string (should be consistently using c_warning in this case).
It turns out "has-build_compiler" is not defined but conveniently a space for it is missing in bootstrap.sh (must be an accidental delete given the coincidence).
Some of the "mode" properties are incorrectly being assigned the non-mode value when a mode value exists in bootstrap.sh.

Cleanup: Rename and relocate private is_unassigned files.

The private-is_unassigned.c and private-is_unassigned.h are in incorrect locations and have incorrect names.
Relocate and rename to make these private files consistent with other private files.

Update: Support Unicode 15.0.

I couldn't easily find what Unicode version I am trying to suppot so I added a unicode.txt document.

The initial work was done for Unicode 12.1 and later switched to 14.0.
I was still in the initial stages of learning Unicode and so I expect there to be notable incompleteness or incorrectness.
With the release of Unicode 15.0 I am able to determine a distinct set of changes and I have applied the changes.

Add a private_inline_f_utf_character_handle_digit_offset() inline function to simplify some of the redundant code.

Feature: The iki_read should still support the older "--substitute" behavior.

The commit bbc7591a040baeca7d19d1d6b644b80ad2e70d01 considered the behavior of --substitute to be incorrect and therefore a bug.

After some consideration I decided that this "bug" would still be useful in certain cases.
The old behavior of "--substitute" where the "--wrap" is ignored is re-created within the new parameter "--reassign".

This is a grey area when it comes to a "bug" and a "feature".
The behavior that is considered a "bug" turned out to be useful and as the behavior is already present it is carried on.

Bugfix: The iki_read is should apply the "--wrap" when using "--substitute".

Given some iki text such as:
  This is some random:"iki" random:"text".

Run the command:
  # echo 'This is some random:"iki" random:"text".' | iki_read -W random "___" "______" -L -s random text PIZZA -r random tomato

The result that I get is:
  random:"___tomato______"
  random:"PIZZA"

I think the following is better:
  random:"___tomato______"
  random:"___PIZZA______"

This makes more sense to me rather than having substitute not include wrap.
This is a behavioral change that I thought and perhaps still think can be considered a bug.
This "bug" is by design as per the documentation but in retrospect I think this is a mistake in the design and should be considered a bug.

Bugfix: The fll_program_standard_signal_received() changes are incomplete and break tests.

The commit ed22b926b67429681841b6b0dc3d76daca1b451f introduced incomplete settings.

I forgot to update the new "stand alone" build settings with the new private source file.
The tests now use this "stand alone" build for building fake and using that fake to perform the tests.

Fix a problem with existing code that has incorrect macros.

Update: Cygwin documentation.

Update: f_memory_structure_increase_by() shouldn't do anything if amount is 0.

Bugfix: private_f_memory_structure_resize() is not returning the error status codes.

The private_f_memory_structure_adjust() function is returning error status code returned by private_f_memory_adjust().

The private_f_memory_structure_resize() is now changed to do the same thing as private_f_memory_structure_adjust() but with tbe status code returned by private_f_memory_resize().

Cleanup: The fss_status_code never returns F_false.

At some point I planned on returning F_true and F_false to allow for easier scripting.
This never happened and so this check is dead code.

The next development cycle may introduce this easier to script functionality.

Bugfix: The fll_program_standard_signal_received() needs a private implementation.

The function fll_program_standard_signal_received() is being called by fll_program_standard_signal_state().
This is not supposed to be allowed and breaks the functional-modular design.

A private function now exists that is called.

The verify option in utf8 returns F_false but the program doesn't return 1.

When the --verify parameter is passed the result is not properly returned.
When F_false is returned, the the verify failed so return 1.
The F_false should not be returned in any other cases.

Cleanup: Fix mistakes in documentation comments.

The private function in fll_error should not descrribe itself as an implementation of itself.

Remove the pointer from f_string_constant_t in the comments.

Fix typo in f_console "strictly".

Update: Implement stand alone build for UTF8 program.

Cleanup: Add missing dependency in UTF8 program.

Update: Stand alone Featureless Make custom config.h header.

Fix some mistakes.
Add several more disable macros to further shrink the size of the resulting binary.

Update: The utf8 program should be using the stream read functions.

The file is opened using the stream open functions.
It is silly and inconsistent to use the non stream functions to read from a file opened via a stream.

Cleanup: Use functions directly rather than macros.

The macro use is the old way and is now only used in special cases.

Bugfix: Functions private_f_file_flush() and private_f_print_safely_get() are not being inclided when needed.

The disable macro _di_f_file_stream_close_ is missing.
The disable macros _di_f_print_raw_safely_, _di_f_print_raw_safely_dynamic_, and _di_f_print_raw_safely_dynamic_partial_ are missing.

Update: Describe modes being used when performing build or make.

Make it more obvious which mode is being used when printing.

Bugfix: Stand alone build is pulling headers from system.

The projects headers should be pulled rather than system headers.

Restructure the stand alone package structure to match the installed headers structure.
This allows for leveraging the pre-compilers ability to locate the files.
Pass '-I sources/c' to the flags to properly locate the local headers rather than the system headers.

Update: The test script not uses stand alone mode for compiling Featureless Make.

The Featureless Make program that is compiled and used to run the tests is now done so using the stand alone mode.
This simplifies the process and avoids having any libraries in the path that could potentially be used (this has never happened, by the way).

Update: Implement stand alone build for Featureless Make.

This functions as both an example as well as a functional program.

I have not yet automated the disable macro process.
This process has been manually performed and may not remove all of the unnecessary code.
This does remove a vast majority of the unnecessary code.

Feature: Add support for 'stand_alone' builds in the package script.

Provide a way to compile programs, such as Featureless Make, with all of their dependencies and most (if not all) of the unnecessary dependencies not part of the programs.
These programs, such as the Featureless Make program, are compiled as a single program with no libfll.so (or program library such as libfake.so) built.

These are still compiled as either shared or static.
All non-FLL libraries in the shared programs are still linked as libraries.

This is a feature in the helper script and does not result in any API (or ABI) breakage.

Bugfix: Mistakes in disable macros and remove redundant check.

Fix numerous disable macro mistakes.
There are several functions that do not have the correct amount of disable macros.
There are several disable macros that have mistakes in the name structure.

The functions private_f_utf_string_append() and private_f_utf_string_append_nulless() are accidentally defined in the dynamic.h header file in addition to the string.h header file.
These should only be defined in one location and the ones defined in dynamic.h are incorrectly located.

Remove redundant errno check for ENOMEM in private_fl_directory_list().

Bugfix: Featureless Make dependencies are not accurately communicated.

Add missing dependencies.

Add new lines to separate levels in the dependencies file.

Update: Add medium logos.

Update: Use resize functions rather than adjust functions forr append and append_all functions.

The resize functions should be used.
The adjust perform extra tasks which are meaningless for append and append_all.

Update: Change logic to avoid potential negative numbers.

Avoid using a subtraction.
Instead just use a comparison.
This should be more performant and also avoids potential negative numbers when dealing with unsigned numbers.

Bugfix: Content is incorrectly attempted to be processed even though it does not exist.

There is happening due to a missing check to see if the Content array is empty.

Update: Always ensure content size is 0 when content is not found.

Update: Redesign behavior of pipe, allowing it to run properly inside software like Gitlabs CI or Githubs CI.

I believe both of the CI systems (Github and Gitlab) use Docker.

These systems will place a new line in the input pipe before starting the programs being called.
This is bad behavior but I cannot do anything about it.

The previous design of Featureless Make is to use only the input pipe if it is specified.
This results in the Featureless Make operations to fail.

This redesigns the pipe handling behavior of Featurleess Make rather than try to submit a bug report to a team that is likely to completely ignore me.

The new behavior is as follows:
  - If a pipe is specified, treat the pipe is prepended to the buffer that will be used for processing the file.
  - This works for both "build" operations and "make" operations.
  - The input pipe is treated as a "fakefile" when using the "make" operation.
  - The input pipe is treated as a "settings" file when using the "build" operation.
  - The input pipe may have an error bit so always clear the error.
  - The "build" and "make" operations can be called within the "make" operation, recursively, so the pipe must only be processed by the outermost fakefile.
  - The operation needs to be detected and identified as "default" to better determine how to handle missing files when a pipe is present and when a pipe is not present.
  - Avoid resetting the buffer on every load so that the input pipe can be prepended without being reset.

Some of the code is cleaned up and simplified in regards to files.

Only perform the pre-process cleanup checks when there are more than two operations.

Update: Next micro version (0.6.1).

Update: Enable gitlab test support.

The gitlab can be designed to work the same as github.
Change the name of the relevant code from "github" to "ci" and have both gitlab and github modes call the ci functions.

For the time being using github as the source code repository is fine.
I should eventually clone the respective repos in gitlab and then conditionally use the URLs based off of the given build mode (github or gitlab).

Bugfix: Block is incorrectly being reset when an else condition precedes an if condition.

There is a logic mistake where the "else" is not being considered when determining when to reset the block.
This results in the block states being reset when the previous operation is an "else" condition.
This results in the second else condition potentially running even if the prior condition already ran.

This was discovered when investigating Github actions test failures that pass locally.
The Github actions tests use a special test argument that I had not tested locally with.