Progress: Continue program related work, focusing on

The interrupt function behavior changed and the ampersand should not be passed now.
This is causing a double reference bug.

Explicitly allocate a small amount of memory for console parameters for the default allocation step.

Rename fll_program_standard_signal_state() to fll_program_standard_signal_handle().
Update fll_program_standard_signal_handle() to follow the new handle structure.

Reduce the first and last line functions and function calls.
I've decided to make some more initial assumptions to simplify the code.
Always print the first and last line to message.
This is a behavioral change.
I do not think the first and last line should be printed to error anymore.
This change simplifies the logic significantly.

Add the first printed check flag.

Update print functions.

Update file structure.

Update file documentation comments.

The iki_read and fss_write have more work to do.
Once that is done I need to resume working on Featureless Make.

Progress: Continue program related work, focusing on utf8 and status_code.

Do more clean up in regards to utf8.
Update the first and last line printing logic.
Update the file structure.

Do the same for status_code.
I did not get to working on the first and last line printing logic.

Feature: The IKI standard now supports bracket wrapping.

I wanted to avoid this and keep IKI as simple as possible.
My recent uses have shown that I must have some sort of word-separator support.

This is the simplest implementation that I can think of at this time.
The brackets do not get escaped, instead the IKI gets escaped.
If there is no closing brracket in the correct spot, then the first bracket is not part of the variable.
The brackets other than the opening at the front and the closing bracket at the end are allowed.

The vocabulary name never includes the open and close bracket.

The following shows the heart of the problem this feature solves:

Consider:
  - helloworld:"earth".

What if "world" is the variable name and hello is not supposed to be space separated?
With this featre, now the following is possible:
  - hello[world]:"earth"

Note that the following are not valid (that is to say these are not IKI variables):
  - hello[world:"earth"
  - heloworld]:"earth"
  - hello[[world]]:"earth"

Update: Style guide documentation.

Progress: Begin updating the programs again.

This focuses mostly on utf8.
Do some file restructuring.
Perform the new f_state_t and f_status_t related changes.

Progress: Massive, but incomplete, refactor while originally focusing on Featureless Make.

Working on Featureless Make led to a need to refactor the directory recursion logic.
This led to me finally getting around to what I knew that I would eventually do.
Move the status returns into the state variable and use void returns.

I have had and continue to have mixed feelings about this.
This should, overall, be better long term for allowing more flexibility and fine-tuned control outside the project.
The switch to void returns when having a state variable is done to reduce complexity and confusion over which "status" variable is the correct one.

I would not that I also decided to move the "status" variable onto the state.
I was originally very undecided whether I should do this and had previously opted to keep the "status" and "state" separate.
Making more complicated projects has proven to me that it will be more maintainable just putting the status in the state.

These changes have a cascading effect on most of the project and its programs.
I got most of the projects done but I did not get around to fixing/updating the programs.

As always, with changes this big, look out for regressions and stupid simple mistakes.
The unit tests, once updated, will help find these problems.
The FSS and IKI processing code, however, need more unit tests to better catch problems.

These changes result in having the interrupt handler made more readily available.
Follow up changes will be needed to add more interrupt checks where long running or variable length loops are used.

The passing of "state" also reduces the number of times "f_state_t status" is needed and should reduce memory footprint to some degree.
This has a runtime costs where now in all of these cases a pointer must be resolved to get to the status.
This is to be treated as the cost of the newly provided flexibility.

There are some related file structure changes.

The recursion code has had a lot of redundancy removed.
I did not have a chance to properly review the code.
Manual testing on directory recursion operations like clone and copy will need to be performed.

Progress: Continue Featureless Make, focusing on printing.

Update the header description comments.

I thought I was almost done but I noticed that I overlooked an entire directory tree.

Progress: Continue Featureless Make, focusing on printing.

There is still more to go, but the printing changes is nearing the end.
Other minor clean ups in directory code.

Bugfix: Control group function is partially outdated and uses incorrect integer.

The F_control_group_path_system_default_s_length should not be used here when progressing the path string.
Use control_group.groups.array[i].used instead.

Progress: Continue work on Featureless Make, focusing on printing.

There might be a problem with any code that prints the error messages as non-errors with these changes.
I need to follow up once I am done with the print re-organization and make sure any non-error error printing still works.

Progress: Continue working on Featureless Make, focusing on printing.

I noticed some odd behavior during this process where the file size of the resulting binary is increasing by as little as 72 bytes per function created.
I experimentally created a "void example_print(void) { }" function and was able to get that 72 number.
Fully populating or using the example_print function did not reduce or noticeably increase the file size.

I gave up experimenting and decided to continue on.
When I got close to wrapping up the print functions in the make, the resulting binary file size suddenly dropped 10k or so at least.
Once that dropped happened the functions no longer appeared to increase file size.
I suspect that there was some sort of weird optimization going on.

Some of the generic print functions in the fake make will probably be moved into the common directory as common print functions.

Progress: Continue work on Featureless Make, focusing on printing.

Relax parameter checks on most of the print functions.
Add check to see if file.stream is set and if not return F_stream_not but not an error.
Make sue similar string checks are consistently used.
This should better allow for more flexible designs around stream and string data.
This eliminates a good amount of parameter checking.

Further simplify printing that has a common structure into more common print function.
This print function may end up being moved to a more common path as I can see printing from other directory trees in Featureless Make utilizing this.

Progress: Continue working on Featureless Make, focusing on printing.

The fll_error_print() and private_fll_error_print() functions now accepts a uint8_t flag instead of a boolean to designate options.
The fallback is still supported.
A new flag "simple" is provided to allow for printing a simpler message (helps avoid ridiculous messages like "Unable to find file, reason: file not found.").

Progress: Continue work on Featureless Make with emphasis on printing.

Add f_file_type_name_file_s string to allow for using the common use as a string.

Progress: Continue program related work, focusing on Featureless Make printing.

The console program has a bug where the found bit is not being properly preserved for value matches.
This is happening due to an incomplete refactor from value assignment to bitwise assignment.

Allocate extra space for the terminating NULL.

Print message rather than an error when termination signal is received.

More print related changes.

Progress: Continue work, primarily in Featureless Make.

Fix a bug in f_console.

Continue focusing on print changes.

For the time being just have all of the parameters be setting and print.
This may change in the future but for now it ensures consistency.

Progress: Continue work on Featureless Make.

Primary focus remains on printing.

Add a new setting flag to assist in first line printing logic.

Progress: Continue work, focusing on print related changes.

This includes recent fixes from the 0.6 branch.

Security: Invalid read or write while expanding operations.

The logic here is non-standard.
The normal logic operates on a pre-allocated basis.
That is, right before accessing the data perform the pre-allocation.

This code operates on the expectation that new variables are only added when conditionally required.
This results in a post-allocation basis where once a variable is known to expand then increment the used variable for the next pass.
The allocation checks need to happen after the increment on used.

There are some cases where this post-allocation is not happening.
This is probably a regression in the very recent bug fixes regarding expanding operations.

Be sure to ensure a clean state after the post-allocation process.

Progress: Continue work, focusing on organizing Featureless Make directory structure.

I am planning on moving all of the print functions into appropriate print source and header files.
While planning this it occurred to me that I first should restructure.

This restructures the code.
Some code has been copied into other files.
This makes the current state rather messy.

Expect follow up commits (eventually) to further clean and organize these.
Expect more files resulting from further clean up and organization.

Feature: Add Turtle Kevux path support.

This does not break API or ABI because it requires macros to be defined that would break it.
These macros, when in use, should not break API (but does extend it) but may break ABI.
The return value may have additional results and might be considered an API but not ABI breaking change.

There is already Kevux-specific code in FLL.
Temporarily continue that process as a short term solution.
In the long term, separate functions or files may be used (or an entirely separate project).

Bugfix: The bootstrap script "-d/--define" command does not match the Fake command.

This is the old way the -d/--define command was designed.
The bootstrap script simply has never been updated.

The command is now "--define" and not "--defines".

Remove the sanity check in the parameter.
This behavior is not as precise and the commands are passed to the program in whatever form they expect.

Bugfix: The content action cache, comments, and delimits are not being properly cleared.

This is a follow up to 241ef476dbba9200cf9422501a3c323136b45dd0.

There are more cases where the cache is not being cleared upon use.
This is resulting in invalid error messages.

Bugfix: Consistently use the same color context for the entry name.

Bugfix: Invalid defines, incorrect comments, missing flags, and missing dependencies.

There is an inconsistency where _di_f_color_string_s_ and _di_f_color_strings_s_ are used.
Settle on _di_f_color_string_s_ because it is defined in the header file.

Incorrect defines, such as _di_f_utf_is_contro_codel_ are removed.

The *.config.h comment example doesn't work.

Consistently add fanalyzer mode and make sure it is available in both settings and fakefile files.

Some of the define macros are missing in regards to private functions.

The controller program is missing f_limit and fl_directory dependencies.

Update: Program man pages, adding copyright, fixing help, and adding missing period.

Document the copyright parameter.
The help uses dashes rather than pluses for compatibility with common GNU behavior.

Cleanup: Fix directory structure for several man page documentation directories.

Update: Controller and Control man page documentation.

Move the specification details into man (5) pages.
This further allows for more explicit declaration of the license of the specifications.

The following are the commands used to help generated these man pages:
  fss_basic_list_read entry.txt +Q -cn "Entry Specification" | iki_read +Q -w -W code '\fB' '\fR'

  fss_basic_list_read exit.txt +Q -cn "Exit Specification" | iki_read +Q -w -W code '\fB' '\fR'

  fss_basic_list_read packet.txt +Q -cn "Packet Specification" | iki_read +Q -w -W code '\fB' '\fR'

  fss_basic_list_read rule.txt +Q -cn "Rule Specification" | iki_read +Q -w -W code '\fB' '\fR'

  fss_basic_list_read actions.txt +Q -cn "Actions Documentation" | iki_read +Q -w -W code '\fB' '\fR'

  fss_basic_list_read entry.txt +Q -cn "Entry Documentation" | iki_read +Q -r PID PID -w -W code '\fB' '\fR'

  fss_basic_list_read exit.txt +Q -cn "Exit Documentation" | iki_read +Q -r PID PID -w -W code '\fB' '\fR'

  fss_basic_list_read packet.txt +Q -cn "Packet Documentation" | iki_read +Q -w -W code '\fB' '\fR'

  fss_basic_list_read rule.txt +Q -cn "Rule Documentation" | iki_read +Q -r PID PID -w -W code '\fB' '\fR'

Update: Featureless Make man page documentation.

Move the specification details into man (5) pages.
This further allows for more explicit declaration of the license of the specifications.

The following are the commands used to help generated these man pages.
  fss_basic_list_read dependencies.txt +Q -cn "Dependencies Specification" | iki_read +Q -w -WWW code '\fB' '\fR' bold '\fB' '\fR' FLL '\fB' '\fR'

  fss_basic_list_read defines.txt +Q -cn "Defines Specification" | iki_read +Q -w -WW code '\fB' '\fR' bold '\fB' '\fR'

  fss_basic_list_read fakefile.txt +Q -cn "Fakefile Specification" | iki_read +Q -w -WW character '\fB' '\fR' code '\fB' '\fR'

  fss_basic_list_read settings.txt +Q -cn "Settings Specification" | iki_read +Q -w -WW character '\fB' '\fR' code '\fB' '\fR'

  fss_basic_list_read fakefile.txt +Q -cn "Fakefile Documentation" | iki_read +Q -w -rrr ASCII ASCII GCC GCC HTML HTML -WW character '\fB' '\fR' code '\fB' '\fR'

  fss_basic_list_read settings.txt +Q -cn "Settings Documentation" | iki_read +Q -w -rr ASCII ASCII FLL FLL -WW character '\fB' '\fR' code '\fB' '\fR'

Feature: Enable support for stand_alone packaging with 'all'.

This helps make the stand alone process easier by performing packaging on all stand alone packages.

Bugfix: The build settings 'path_sources' is incorrectly added.

The commit 79858cf386916fd25ccd3578797de53b16f5c446 fixed a problem with the sources path passed to the program.
This revealed a bug where the build setting 'path_sources' is being added twice.
This is probably why the previous bug was not noticed for so long.

Make sure to apply the passed path sources parameter when the build settings does not have 'path_sources'.

Progress: Continue program related work, focusing on Featureless Make.

The Featureless Make program appears to function at this time.
There is still a lot more work to do.

Cleanup: Fix styling in the Open Standard License file.

This is a non-functional change.
Only the styling is altered.

Update: Open Standard License to be 1.0 or later rather than just 1.0.

Update: Fakefile specification.

Progress: Continue program related work, with emphasis on Featureless Make.

The common.h and related files are now broken up a little more.
There is now a common-string.h and common-type.h (with matching source files).
This should make it easier to navigate, particularly when there are a lot of functions, strings, and types.

Lots of tedious updates to the Featureless Make.
There are still a lot of structural changes to make.
Add more parameters to Featureless Make to address the documents and the licenses directories.
There is still more work to do with those parameters.

Fix some observed mistakes in the level_0 console code.

Update: Have the program print version use first last bit argument.

I like this idea that I implemented for fll_program_print_copyright().

The version now prints a new line before and after like everything else now.
The first and last can be disabled using the appropriate parameters.

Cleanup: Simplify lines used in incrementing.

Feature: Provide program parameter for displaying copyright.

Provide copyright printing that can be slighty fine tuned using verbosity.

Provide a define (_di_detailed_copyright_) for reducing some of the string printed.

Regression: Serial example rule is not working.

Investigation revealed that the commit 002bf17595459e65173be16f983977ead99593b6 introduced a regression where the cached data is being reset incorrectly.
The data is properly processed but when there is more than a single rule the previous rules are being cleared.

Cleanup: Remove some unused variables.

Update: Add additional sanity checks.

The GCC -fanalyzer is reporting a problem that as far as I can tell is a false positive.
This program is older code practices and will eventually be rewritten anyway.

Add a few more safety checks.

Cleanup: Remove unused variables.

This is revealed by the use of GCC -fanalyzer.

There is a false positive when it comes to the ignore variable:
  warning: variable 'ignore' set but not used [-Wunused-but-set-variable]

This particular error must be ignored.

Security: NULL pointer dereference in writer due to pipe function result handling.

The GCC -fanalyzer parameter helped me discover this one.

The status_pipe is being read and processed.
There is a case where the status_pipe is being set but it is not being reset after handling.
In a later loop the pipe does not get read but the previously set state is used bringing the code into a bad state.
Then the loop doesn't do the block buffer used check and this results in the eventual NULL dereference.

Update: Add fanalyzer build mode.

I keep forgetting to run the GCC fanalyzer sanity checks to help catch problems before making a release.
Add a formal mode in all of the build settings to make this processor easier and therefore easier to remember.

Add missing -Wall to some of the files for the test mode.

Update: Use pre-existing cache rather than using a new variable.

This potentially reduces reallocations.

Bugfix: Further Fakefile processing with iki replacement space problems.

This is a follow up to commit 3713a5f0bd90d32f564afaca29f01d9ccf329cfb.

The other IKI variables still need the new lines when the context does not.

Detect when certain IKI variables expand into nothing and in these cases do not append.
When performing last line, only append if it is not by itself.

Cleanup: Reorder logic in FSS Basic Read function.

Bugfix: Fakefile processing with color context is producing extra spaces when unquoted.

Do not generate a new argument when calling fake_make_operate_expand_context().
The color context should combine with existing arguments.
This does not handle the last context argument and more work is likely needed to handle that one.

Remove the not quoted check that always generates a new argument.

Bugfix: FSS Write programs don't correctly handle multi-Content per Object situations.

The FSS Extended should support one or more Content per Object.
All others support the same number of Objects as Content (not referring to nested Content).

The error and error message when this is and is not correctly being handled.

The correct detection needs to count based on sub locations rather than locations.

Remove now pointless and misleading checks.

Progress: Continue program related work and make f_console related changes.

Work on fake and then focus on the relating console changes.

I imported the recent bugfix regarding console arguments (ccd15d4e64848f29d36823ca92ee639057f544b7).
I opted to just copy and paste and then re-convert to the latest practice.
Look out for regressions, but this is development anyway.

I've added it to the console function.
As far as how the main programs declaring and using f_state_t to pass to the console program, I'm not sure how I want to handle f_state.

Progress: Continue program related work, focusing primarily on fake and console parameter handling.

I realized that the new callback console parameter needs to be implemented.
I reviewed the drafted design and changed it accordingly.
I've been able to reduce the need to have a callback for each parameter and have a single callback for the set of parameters.

The documentation for the console parameter callback change is incomplete for this and my next progress should complete this documentation.

I updated several programs regarding the console changes and noticed a small number of bugs in the UTF8 program.
The first line is now being printed, conditionally, but future work may be needed.

Progress: Continue program related work.

Progress: Continue program related work.

This focuses on getting the Featureless Make program to compile.
The settings and functionality is not yet updated so the program is not expected to work yet.

Update: Add locale environment variable support, install, and help support in fakefiles.

Pass along the common locale-specific environment variables along when using a fakefile.

Add an "install" operation that is essentially a wrapper to the "install.sh" script.

Add a "help" operation to provide some documentation.

These are provided as a convenience and as a functional proof of concept.

Progress: Continue program related work.

Focused on Featureless Make.
Other changes made as convenient.

Update: The directory documentation comments.

Update: The directory documentation comments.

Update: Use _di_f_type_d_ instead of _di_f_type_input_output_d_.

Update: Add new standard global type, "_g".

Update: The disable header files.

Bugfix: Fix some of the outdated unit tests.

The unit tests are out of date.
Fix a few of the obvious problems.
There will be more problems to solve that are not solved in this commit.

Bugfix: Several problems with the wrapping define macros, unused private functions, and non-existent functions.

The stand alone builds revealed several problems with the wrapping define macros.
The ones that I noticed or were blocking me from compiling have been fixed.
It will be no surprise if there are still more such problems hiding in the code somewhere.

Remove stale and unused private functions.

There is are no f_file_clone_at() and f_file_copy_at() functions.
Remove references and related wrapping define macros.

Bugfix: The f_int_128_t is using incorrect size and change f_int_128_t to f_int128_t.

The wrong wrapping define macros are being used.
- Use __SIZEOF_INT128__ instead of _di_f_int_128_t_.
- Use #ifdef instead of #ifndef.

Use f_int128_t to more closely match core types like int64_t.

Cleanup: Add new lines to dependencies file in level 3 projects.

Bugfox: The type macros in type.h are missing 'f_' or have spurious '_type' in the name.

Bugfix: Incorrect define macros for private functions in f_file.

Bugfix: Incorrect macro definition _di_pthread_support_ vs _di_thread_support_.

The _di_pthread_support_ is used in the project but all of the programs have _di_thread_support_.
The project name is f_thread and not f_pthread so favor _di_thread_support_ over _di_pthread_support_.

Cleanup: Fix license confusion.

The documentation should be under the cc-by-sa-4.0 license.
However, the specification must be under the open-standard-license-1.0 license.

This file is documentation on the time specification.
If the documentation is under another license, the standard it describes must still be followed according to the open-standard-license-1.0 license.
The documentation would have to communicate that the standard it is describing is still under the open-standard-license-1.0 license even if the documentation itself is under a different license.
This creates a confusing and misleading situation.
Clarify the situation by setting the license to open-standard-license-1.0.

Setting the license explicitly to open-standard-license-1.0 should hopefully address any misunderstandings.

Cleanup: Parameters in byte_dump man page should be bold.

Update: Documentation and build settings, adding remaining man pages for programs.

This includes any updates to the existing program man pages already added.

Update: Use more proper copyright communication.

The original copyright file was added to the git repository in 2011.
The svn repository has the actual original initial date, 2007.

Cleanup: Minor IKI formatting improvements.

Cleanup: Apply IKI formatting to controller specifications and documentation.

Update: Add man page documentation for iki_read.

Update: Add man page documentation for iki_write.

Update: Add man page documentation for status_code.

More work is needed to only install the man pages for each specific program.

Cleanup: Use correct year, remove extra line, and fix version.

Update: Improve IKI Read help documentation.

Update: Improve IKI Write help documentation.

Update: Add more detailed documentation to fss_status_code and status_code.

Bugfix: Incorrectly string length causes inability to match string in fss_status_code.

Update: Restructure settings now the install.sh is installing them.

These files are moved into a sub-directory.

Update: Improve logic and design of install.sh script.

The destination directories should be created if they do not already exist.
Fail when the destination exists but is not a directory rather than fail if that directory does not exist.

Fix grammar in 'Failed to create work directories'.

The includes should be created only when work is not an empty string.
The recently added documentation needs to be created as well.
The settings is not created and needs to be created just like with documentation.

Ensure the existence of these directories allows the copy and paste to work correctly.
Ensure the normal directories get created in addition to the work directories.

I originally designed this to not have any opinions for the settings.
I've decided to relax that and apply the default settings of the 'etc/' directory.
This directory is now installed to.
If say the 'etc/' is actually needing to be the 'share/' directory, custom paths can be altered as well.

Make sure the documentation and settings can be disabled or have their destination paths altered.

Update: Add man pages for utf8 program.

Feature: Add missing documentation handling functionality to Featureless Make.

This is an oversight and should have been implemented before the first stable release.
This feature should be a core feature.

Documentation is important.
Make sure the handling of documentation is available for use.

This adds "build_sources_documentation" to the build settings to help facilitate documentation installation.
The documentation that is copied is expected to be under 'data/documentation/'.

The 'documentation' and 'documents' terminology overlaps to some degree.
The 'documentation' is a more specific thing and may not always be a 'document'.
The existing behavior around 'documents' is left unchanged.

The skeleton operation now creates the 'data/documentation/' directory.

The bootstrap.sh script now supports enabling and disabling documentation via the more common '--enable-doc' and '--disable-doc' parameters.

Cleanup: Fake program has incorrectly named variables.

The variables with 'build_sources_settings' should not have an 's' on the end.
The variables with 'build_process_post_s' and 'build_process_pre_s' should not have an '_s' on the end except for when it is a string.

Update: Add explicit note about copyrights belonging to Kevin Day and the year 2023.

Regression: A  bad refactor caused the "file" and "output" got changed into "print.to" in the utf8 program.

Cleanup: Fix grammar in utf8 program help.

Bugfix: The mode clang is missing from the UTF8 stand alone build settings.

Bugfix: Support for passing a fakefile Section incorrectly fails.

The commit 6c05c66f50719c9edaa36dea75669e03cd558ee4 added a loop around the code.
I forget to handle the return status and break out of the loop appropriately.

Move the variable declaration outside of the loop to avoid re-declaring it inside.

An error or a child signal should cause the loop to terminate.

When the string comparison is matched, do not continue processing the inner loop.

Cleanup: Use correct version in install.sh script.

I probably got lazy and copied then install.sh script from the 0.7 development branch and then forgot to update the version.

Feature: Add support for installing documentation to the install.sh script.

Cleanup: Use braces around variable names.

Do this by practice now to better avoid ZSH and other potential compatibility problems.

Bugfix: Install script still install static program sources despite being disabled.

The if condition nested is only wrapping the print block.
Move the conditional logic to the proper wrapping block.

Feature: Support passing a fakefile Section name to the main program.

This is intuitive and should have already been supported in the project to better transition from GNU Make into Featureless Make.

The unknown parameter error is to no longer be thrown.

Instead, when the make process in being followed, check to see if any Sections exist in the fakefile matching the main program Section parameters.
Fail when this happens.
If the Section exists in the fakefile then that Section is operated on.

This, for example, now allows for doing something like "fake install" in the same way "make install" works.

The "install" Section must exist in the fakefile for this to work.

Cleanup: Add missing space in fake --help output.

Update: De-couple the build settings data file from the install.sh script.

The design is originally focused around the data/build/settings file.

This file is simple enough and easy enough to use that I decided to use it beyond its intended design.

I noticed that the data/build/settings isn't required anymore.
Removing this allows me to better use in other projects, such as those that have only a fakefile or have a different directory location for the build settings data.

The install.sh script is even simpler now.

Update: The f_file_mode_from_string() replace parameter should be optional.

This change does not break ABI.
This change does not break API, except for parameter error when replace is NULL.