Bugfix: Incomplete and invalid bootstrap.sh settings.

The build settings in `bootstrap.sh` is incomplete or invalid for various reasons.

Some of the build settings are now consistently present in the Multi value Objects array loop.

The `build_sources_script-mode` is now being loaded.

Many of the build settings are now properly being populated using the correct variable or settings names.

The `bootstrap_id()` is now being called where the `bootstrap_id()` call has been missing entirely.

Remove build settings that do not actually exist in the standard (like `defines_object_program`).

The `has-flags_library-mode` is now being properly used.

Bugfix: The bootstrap script is overwriting existing multi-valued settings.

This happens when there are multiple modes specifying the same value.
The multi-valued settings must have the value appended and not overwritten or removed.

Specifically, the setting is designated as not populated when a mode specifies a setting and then is followed by another mode that does not specify this setting.

Resolve this by adding checks if the setting is already designated as specified.
If the settings is not specified, then and only then declare it as unspecified.

Bugfix: The bootstrap script improperly loads settings resulting in incorrectly failed builds.

I suspect this situation happened due to various changes over time without a thorough review of everything that needs to be changed.

Reserve the variable index position of 0 to designate not found.
Update all checks to then check for `key` to not be 0 after calling `bootstrap_id()`.
This fixes problems where the position after the last valid index might get set and used as a value.
When the position after the last valid index is read, it could read these values even if it should report not found.

The index position checks are updated to more properly check and assign the index using the appropraite `has-*` and `has-*-mode` vs the normal value `*` and `*-mode`, respectively.

Update all index position checks to check the `has-*` and `has-*-mode` accordingly.
This change fixes the primary problem that is causing the build to fail due to incorrect variable loading.
The `has-*` and `has-*-mode` checks checks for existence.
Then and only then should the actual respective values be used.
In particular, the `*-mode` settings should only be assigned if the respective `has-*-mode` is set to `yes`.

This bug is observed in my **TKIS** script development where the `path_headers` is being treated as an empty string despite being designated as `fll`.
The **Featureless Make** program compiles properly but not this `bootstrap.sh` script.
The **TKIS** scripts are expected to be run on a system without the **FLL** project at all.
I have not observed this problem because I have been using the **Featureless Make** directly for years now.
The packaging and unit tests scripts provided by this project are coincidentally not triggering any obvious errors with the improper behavior.

If the existing scripts were working before then these changes might cause problems with those scripts.
I will follow this up and investigate and fix these issues.
Running the **Featureless Make** on these works and so these changes likely expose existing problems rather than causes regressions.

I would love to find a way to reduce the repetitive assignments to variables in a safe/sane manner.
This would require more research on my part, if it is even possible.
I don't plan on doing such research any time soon and so I am continuing to consider the bootstrap script design as tolerable.

Additional Changes:
  - Simplify logic in for loops for `bootstrap_id()` by combining all of the passes into a single pass (The actual index values are irrelevant and so restructuring/reordering caused by this is not a problem).
  - Ensure the key is an integer in all cases.
  - Remove unnecessary `key` variable assignments.
  - Remove some redundant assignments.

Bugfix: The fss_embedded_list_read and fss_embedded_list_write are missing from stand alone builds.

I apparently overlooked and completely forgot to add this.

Add the build settings and the `config.h` settings for both the read and write programs for FSS Embedded List.

Bugfix: Add missing define to private_fl_fss_list_write_object_trim().

The `fl_fss_embedded_list_object_write()` depends on `private_fl_fss_list_write_object_trim()`.

Bugfix: Out of place build settings files in stand alone builds.

The regular files are being included in the stand alone builds.
This is confusing and can lead to build failures due to selecting invalid build settings files.

Remove the build settings files that must not exist in stand alone builds.

Bugfix: Invalid seeked value on failure in f_file_seek().

The previous commit 6dc28ff5673c86d8d6042b47538c2f66e7726717 left out the `seeked` NULL check before assigning a value.

Bugfix: Invalid seeked value on failure in f_file_seek().

The `lseek()` can return a negative value.

Use a local variable to get the `lseek()` value.
This then allows for the `seeked` to be NULL.

Change the `seeked` parameter to be optional and when set to NULL then it is not assigned.
This neither breaks API nor ABI.

The `seeked` value is only assigned when the result is `-1`.
The POSIX standard is inconsistent about negative return values.
In the case of `lseek()`, only `-1` is technically an error.

Bugfix: Missing quote in error message for invalid parameter for file error.

Bugfix: Handle more cases of IPv6 addresses not being properly identified.

I learned that `::` and `::/24` addresses are valid.

Add a few more test cases.

Cleanup: Replace literal characters with defined string characters in f_network_is_ip_address().

Literal characters like `'a'` should not be used.
Instead, things like `f_string_ascii_a_s.string[0]`.

Bugfix: Invalid IPv6 addressdetection and improve IPv4 address detection in f_network_is_ip_address().

The `f_network_is_ip_address()` is not properly identifying bracketed IPv6 addresses.

Digits to the left of double colons `::` should be supported.
The forward slash `/` should be allowed after double colons `::`.
Ending in a double colon `::` is in fact valid in situations, such as with `::/0`.

Make the IPv6 logic easier to follow by adding additional comments.
Also rename `count` to `digits` to further make the code logic more understandable.

Improve IPv4 detection by checking if the number is between 0 and 255, inclusively.

Add more unit tests to better catch the newly identified and now resolved problems.
Update unit tests to use the newer `macro_f_string_static_t_initialize_2()` instead of `macro_f_string_static_t_initialize_1()`.
Add additional comments to help identify rows.

Bugfix: Incorrect documentation for f_network_from_ip_string().

The `f_network_from_ip_string()` is incorrectly referencing IPv6 bracket notation.

Make it clear that ports are not supported.

Make it clear that IPv6 bracket notation is not supported.

Clean up the `f_network_from_ip_string()`, removing unnecessary nesting.

Bugfix: Do not include private header when installing.

The `private-console.h` must not be added to the `build_sources_headers` setting.
Adding it to the `build_sources_headers` sets it up to be installed.

Cleanup: The help for -D should be printing +D instead of +D in the parenthetical comment.

Feature: Add support for debug mode in test script.

The test script should also support the debug mode.
This is not to be confused with running the build process in debug mode itself (the `+D` / `++debug` setting).

Bugfix: Static builds with '../' relative paths for objects do not build correctly.

Add new function that handles converting the relative path with '../' with one that has no '../'.
Use this to build the object paths by adding the full relative directory path for the build files.

Note that this could be a problem with possible directory structure conflicts in some situations.

Utilize a new cache `cache_relative` for the processing of the relative path.

Add additional debug reporting to improve the error reporting details with the programs, like `ar`, fail.

Add note how future FLL versions (0.9 and later) should have something like `fl_path_canonical()`.

I need to also follow this commit up with an investigation to see if any of these `../` can get outside the project root.
There is a need for a project root parameter for situations where different paths are specified, such as specifying `--sources`.
Alternatively, I might have to restrict all `../` to the sources directory and then move all of my `tests/` directory files within the `sources/` directoreis for all projects.

This also gives me reason to consider adding IKI support to enhance the build settings.
I am on the fence on actually doing this or not.

Bugfix: The fl_path_canonical() is not consistently resetting canonical.used.

The `fl_path_canonical()` is replacing the `canonical` variable rather than appending to it.
However, when `path.used` is 0, then the current path is appended without resetting `canonical.used` to 0.

Ensure that `canonical.used` is always set to 0 to enforce replacement.

Add explicit documentation comment making it clear that this function performs a replacement rather than an append.

Bugfix: Actually install man files.

I setup the man files to be used along with the `0.8.0` release.
I completely forgot to actual add the configuration to move the man files into the proper location so that they can be installed.

Add the appropriate build settings that designate the documentation file to be installed.

Feature: Add support for debug mode in bootstrap example script.

I use this script a lot for convenience.
Add support for enabling debug mode when building via the `-D` parameter.

Bugfix: Non-debug mode error printing prints incorrectly.

A character is incorrectly printed when debug mode is disabled.

If the first character in the debug string is NULL, then do not print the wrapping parenthesis.

Update: Next micro version (0.8.1).

The following are the commands that I ran to make this change:
  # find build/ level_? specifications/ documents/ licenses/ -type f -exec sed -i -e 's|0\.8\.0|0.8.1|g' -e 's|^version_micro 0|version_micro 1|g' '{}' ';'
  # find level_3/ -name *.h -exec sed -i -e 's|_program_version_micro_s F_string_ascii_0_s|_program_version_micro_s F_string_ascii_1_s|g' -e 's|_program_version_micro_s_length F_string_ascii_0_s_length|_program_version_micro_s_length F_string_ascii_1_s_length|g' '{}' ';'
  # sed -i -e 's|version_micro 0|version_micro 1|g' build/*/settings build/stand_alone/*.settings level_*/*/data/build/*settings*

Update: Use 32-bit for f_number_unsigned_t on i386, i486, i586, and i686.

This only checks the standard GNU architecture macros.
Other systems that use different means of communication architecture shall need changes.

Update: The tags file.

Bugfix: The FSS Read program is missing the f_directory dependency.

Bugfix: Error reporting has invalid syntax and some are the wrong errors.

The Access Denied error is missing the trailing quote.
The problem appears to stem from when I added the debug printing support.
I failed to place the closing quote into the correct location.

I also noticed that the static strings array is too short!
This will result in the wrong errors being printed.

Add the missing strings.

The stand alone builds must be updated because this now uses a string that wasn't used before.
Make sure `_di_f_string_format_sentence_end_basic_s_` is available in all custom builds that rely on the error printing.

Update: The f_process syscalls should return F_implement_not if not available.

The `f_process` is very new.
The syscalls might not be available.

Ensure that this doesn't break older software stacks by returning `F_implement_not` when the associated syscall is not available.

Update: Disable f_thread_mutex_priority_ceiling_get() and f_thread_mutex_priority_ceiling_set() for pinephone.

Update: Add pinephone build mode and fix build setting inconsistencies encountered.

Add a convenience build mode similar to the `android` build mode for the `pinephone`.
Just like with the `android` build mode, add a parameter to build using the `pinephone` mode to the `bootstrap-example.sh` script.
Utilize the android build variables for the script, replacing them with a more generic variable name.

I discovered and addressed some build settings inconsistencies while mass adding the `pinephone` mode.

Update: Enable f_thread_cancel() in all stand alone builds.

Update: Use regular grep rather than POSIX regex grep in package.sh build script.

Not every version of grep supports POSIX regex.
Use the uglier but better supported equivalent match strings to make the package script more portable.

Update: Provide _pthread_kill_as_pthread_cancel_ and disable thread robust functions for Android builds.

The `_pthread_kill_as_pthread_cancel_` provides an experimental work-around for Android.
Android does not support the `pthread_cancel()` (not supporting this makes Android unsafe).

Use `pthread_kill()` with the terminate signal in place of `pthread_cancel()` when this is defined.
The `f_thread_cancel_state_set()` is also replaced with a stub function that returns `F_implement_not`.

Revert "Bugfix: Cannot disable f_thread_cancel() and f_thread_cancel_state_set() on Android."

This reverts commit a4de650d1b0461a75e7c548f3a1e5fae797393a6.

The linking passed, but when I tried to run the program, it failed.
I guess I cannot enable these.

Bugfix: Cannot disable f_thread_cancel() and f_thread_cancel_state_set() on Android.

These are now required by the programs.
I also tested on Android and found that these now work.
It should be safe to enable these by default on Android.

Update: Provide THREAD_* defines if they do not exist and use the f_thread defines.

Make sure all relevant `THREAD_*` are defined and if not, then define them.

Do not directly use the `PTHEAD_*` defines.
Instead use the ones provided by `f_thread`.

Update: Ensure sockets defines for SOCKET_* and catch missing MSG_* defines.

Add `MSG_*` defines that I missed in a previous commit.

Add the `SOCKET_*` defines.

Update: Ensure sockets defines exist, add more defines, and remove redundancy.

Make sure each standard define exists.
If they do not, then create them.
This provides a new disable define called `_di_f_socket_defines_d_`.

Add a lot of missing defines.
This especially includes a lot of protocols.

The `f_socket_message_flag_e` enums are redundant, so remove them.

Update: Add -A option to example bootstrap script for android.

The Android system has a terrible interface.
Make the bootstrap process easier by allowing a single parameter to be passed to enable passing android build mode to everything being built.

Update: Add .gitignore file for common directories that should not be committed.

Update: Add man pages forr most or all FLL functions and programs.

The man page format is terrible.

The doxygen program helps automatically create these, but it is terrible at generating the man page format (on top of the man page format itself being terrible).
I found a tool from https://github.com/gsauthof/doxy2man.git that helps convert doxygen created xml files into man pages.
It works a lot better than doxygen's man page generation.

The generation from doxygen still has problems.
It doesn't understand some of the commenting structure.

This documents the process so that I do not have to try and figure this out all over again.

I have to take the generated man pages and modify them to clean up a bunch of mess.
This is a lot of work and so I am expecting to have missed something, overlooked something, or made some silly mistake.
Oh well. I can address such problems over time.

This is another reminder (like commit 63be746d22d66870ae89f9575c82db7d0b784e32 from the 0.6 branch) that I probably have to write something that provides a better documentation format.
Then I can convert that to man pages.
I imagine something using FSS + Wiki + IKI.
Using both Wiki and IKI is because IKI isn't meant to replace Wiki.

Feature: Add IKI Write stand alone programs.

Update: Build settings header ordering and config.c and config.h files.

Change the ordering to have the headers before the source files.
This seems to flow more naturally.

Move the main program and config.c files onto their own source lines, in general.

Make sure all programs have a config.c and config.h file.
I've generated these files in the past but now with the external programs it has become less consistent.
Make the files statically defined rather than generated and explicitly add them to the build settings.

The individual, level, and monolithic builds should still craete the config.h and config.c files.
However, remove the automated insertion of the config.c into the build settings files.
These are now directly added to the build settings files.

Update: Fix problems discovered in stand alone builds.

The cap defines, libraries, and flags are not needed by most of the stand alone build settings.

The example program does not need fll_print.

The fake program is now using more up to date source code files for f_iki (it was missing the eki files).

The fss_read programs were not including the correct config.h files.
This then exposed incomplete config files that are now updated.

Update: Make level 3 programs more consistent and fix problems.

The example program does not need fl_conversion or fll_print.

The iki_read program does not need fll_file.

Add missing defines and flags for several program build settings and fix inconsistencies.

Feature: Add IKI Read stand alone programs.

Feature: Add FSS Write stand alone programs.

Update: FSS Read stand alone build has unnecessary files.

Remove unnecessary files and ensure that the `f_fss_default_d` macros are available.

Bugfix: Incorrect disable defines for fll_program_print_error_parameter_cannot_use_with_xor.

Bugfix: Incorrect disable defines for fl_fss_basic_object_write.

Cleanup: Remove unused dependencies in fss_read and fss_write projects.

Bugfix: Incorrectly used f_memory_adjust() instaed of f_memory_resize() in fss_read.

Cleanup: Add missing space to endif comment.

Update: Existing stand alone builds.

Change the file structure for the fl_fss source files, breaking it up into two lines.

The status code should use `stand_alone` as the stage.
I was originally trying something different and abandoned the approach but I forgot to change the stage back to `stand_alone`.

Feature: Add FSS Read stand alone programs.

Update: Remove unnecessary level_0/parse.h include.

Feature: Add Status Code stand alone programs.

Bugfix: Multiple dependencies files, not handling all of the dependencies.

A single stand alone project is not properly getting all of the FLL sources when multiple dependency files are specified and they have different dependencies.

This now ensures that all properly named `dependencies` files are processed.

Bugfix: Incorrect destination path for the custom stand alone build config.h files.

This now uses the correct path.

Update: Bootstrap script, changing the switch to loops and fixing static object build using shared value.

Using a loop with a counter allows for avoiding the need to manually specify each count.
This makes updating easier in that regard.

The number of values would make one huge loop so break it apart into multiple loops.

The object building for static objects is incorrectly using shared variables when it should instead use static variables.

Update: Setup all defauls and provide version_file and version_target defaults.

Make sure all of the build setting defaults are assigned at the start of the load process.

The `bootstrap.sh` script needs to also set the defaults for `version_file` and `version_target`.

Refactor: Build mode gcc_13 to flex_arrays to provide a more generic name.

The `gcc_13` was a temporary mode and I don't want to have version specific modes.
Replace the mode witha more long term version unspecific name `flex_arrays`.

Cleanup: Remove unused dependencies in status code program.

I need to vet all programs and remove any unused dependencies.

Bugfix: Remove parse.h as it is not a dependency of fl_status_string.

Cleanup: Build settings, move private sources onto a separate line.

I need to vet the entire project and do this for all build settings files.

Feature: Support additional specialized stand alone build settings and config.h files in package script.

Update: Featureless Make build examples to use static and shared specific libc linkage.

Update: Make c the default build_language in Featureless Make.

Update: Make the stand alone build settings more consistent.

Bring these up to date with some minor changes in the build settings.

Feature: Add FSS Identify stand alone program.

Bugfix: The fss_identify program does not use f_directory.

Update: Remove build settings that are supplied by defaults.

Update: Copyrights in preparation for early 2026 release.

Update: The tags file.

Feature: Add f_process project.

This provides pidfd functionality that I intend to utilize in future work.

Provide `f_handle_t` for represetning `struct file_handle`.

Several of the functions being represented are not in some libc implementations.
Use `syscall()` to handle these.
Provide defines for enabling/disabling the `syscall()` behavior.
Provide stubs for mocking such functions in unit tests so as to avoid trying to mock `syscall()` itself.

Update: Use F_device_not rather than F_device for these status codes.

Cleanup: Make F_failure documentation comments more consistent.

Feature: Additional status codes, F_fresh and F_stale.

Cleanup: Reduce extra blocks in delete and destroy call backs.

Early on I was uncertain at how I should handle this.
I wanted the block design, with anticipation that there would be cases where other code might operate after the first scope ended.
This made for easy and copy and paste (as well as some level of consistency) when switching between different types.

There has been massive changes over time regarding the structure of the delete and destroy functions (which are now call backs).

Most of the blocks end right before the function ends.
Simplify the design in these cases by removing one level of block structure.

Update: Main program structures to follow consistent styling.

Update: The API version documentation comments to 0.8.

Update: Use call back class structure.

I relatively recently started putting the call backs into their own structure.

This brings the status_code project in line with that practice.

Bugfix: Make sure the bootstrap.sh provide the standard default values.

This issue is exposed by the removal of numerous values from build settings files to favor the defaults.

Cleanup: Remove stale and invalid f_utf string files.

Cleanup: Remove build settings objects that specify the default values.

Update: Add missing array types for time and date structures.

Update the build files.
Add unit tests.

Bugfix: Bootstrap example script is not returning proper error codes.

The echo commands result in `$?` being a non-error code.
Just return `1` when printing errors.

Feature: Add macro_*_t_intialize_3(array_value, length_value) macros for initializing static arrays.

The standard array type structures now have a `macro_*_t_intialize_3(array_value, length_value)` where `length_value` is the `used` value and the `size` is set to `0`.
This designates that the array (or string) is statically allocated (only when the memory address for `array` or `string` is non-NULL).

Switch to use these for static data.

Refactor: Code to use { .a = b } notation for initializers and address related problems.

Change the coding style for the initializers and macro initializers to follow the `{ .a = b }` format.

Update: Remove todo regarding delete and destroy functions for f_thread_once_t along with unused tests.

The tests are not used and there are no functions to test.

Remove the `@todo` regarding adding delete and destroy functions for `f_thread_once_t`.
Document the reasons for this in the documentation comments.

Update: Remove n longer valid *_delete_simple and *_destroy_simple macros.

Update: Avoid the use of bool, keeping it to a bare minimum.

Use `uint8_t` to both enforce a specific byte size as well as provide the ability for it to be converted into a set of bits if need be, without breaking API or ABI.

Update the tests to use `uint8_t` as well.

Update: Make *_t_clear() functionality consistent and fix existing problems.

These were being removed at one point in time, resulting in an inconsistent declaration of these macros.
The memory clear macros were also removed, but some of the uses still (incorrectly) remained.

Ensure that these `*_t_clear()` macros are encased in a brace defined block.

Do not use semi-colons at the end of the `*_t_clear()` uses.
Do use semi-colons at the end of `*_t_clear()` direct property assignments.

Refactor: Relocate the order of the size and used properties for numerous array structure types.

For further details, see: a6ab23fe1333af5f582f73144ab55d753785aaf0.

Refactor: Relocate the order of the size and used properties for string statics, staticss, dynamics, and dynamicss.

For further details, see: a6ab23fe1333af5f582f73144ab55d753785aaf0.

Refactor: Relocate the order of the size and used properties for f_string_static_t and f_string_dynamic_t.

This will be performed on all types, but I started with `f_string_static_t` and `f_string_dynamic_t` given how much they are being used.

This is done to help reduce potential security problems relating to allocation and buffer overflows.
This is not expected to stop attacks or intentional mis-uses.
This is instead expected to help reduce the attack surface area by reducing the possible harm from coding or runtime mistakes.

The basic structure is:
```pseudocode
  my_type {
    array
    used
    size
  }
```

If an array overflow write occurs, it is mostly likely to write in the `used` structure rather than the `size` (unless the compiler does something different).
This can cause the `used` to become corrupted rather than the `size`.
This essentially makes `used` act as a buffer to the `size` property.
While this is still a bad state, the memory allocation might still get preserved and allow for proper de-allocation without memory leaks.
Stack protection and similar security practices helps make larger overflow writes more likely to get caught and therefore more likely to be stopped before the `size` gets corrupted.

This, of course, does not protect against intentional mis-uses and abuses.

I was holding this off for some time due to the sheer size of the required changes.
However, once a code freeze happens, then I cannot make these API and ABI breaking changes.
Therefore, now is the time for me to make these changes.

Also begin using the `{ .property = value }` notation.

Update: Remove firewall files that were not migrated yet.

These files should now be in the separate kevux_firewall project.

Update: Add the stand alone build defines for fll_program_print_error_parameter_too_few() and fll_program_print_error_parameter_too_many().

Feature: Add fll_program_print_error_parameter_too_few() and fll_program_print_error_parameter_too_many().

Update: Remove F_file_type_not_* status codes.

Each of these already has a `_not` of the base type, such as:
  - `F_block_not`
  - `F_known_not`

Update: The directory status codes and use F_directory_descriptor_not instead of F_directory_descriptor.

Add missing "_not" status codes or the inverse.
The `F_directory_closed` is not needed now that there are the "_not" status codes.

Use `F_directory_descriptor_not` instead of `F_directory_descriptor` for invalid directory descriptors.

Replace `F_file_type_not_directory` with `F_directory_not`.