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`.

Update: Use F_file_descriptor_not instead of F_file_descriptor for invalid file descriptors.

The "_not" suffixes were added later in in the project after some of these status codes were established.
This begins the process of using the "_not" suffixes for representing invalid states, variables, etc...

The `F_file_descriptor` should instead be `F_file_descriptor_not` for invalid file descriptor errors.

Update: Make more socket error codes more granular, add additional status codes, rename some others.

This particularly adds an underscore between file and system to be more proper.

Update: Make more socket error codes more granular, add additional status codes, rename some others.

Update: Make some socket error codes more granular and add additional status codes.

Some of the socket status codes should be more granular given the specific behavior relating to networking.
Add error printing associated with this.
I anticipate more changes like this based around networking.

Add clock status codes.

Update: FLL Error should handle more standard network error codes.

Also add additional text "occurred" when an unhandled error gets printed by FLL Error.

Cleanup: Abstruse documentation comments.

Ensure the details on what is and is not de-allocated is described in the documentation comments.
Also alphabetize this list.

Bugfix: The asctime_r() function appends a new line.

Ensure that the new line is not counted as part of the date string.

Bugfix: The fss_write is missing the recently added debug mode.

This causes the build system to fail to compile when using the default build modes.
My standard build process did not catch this because I was using explicitly specified build modes.

Bugfix: Incorrect index usages in f_console_parameter_process().

Switch to use a pointer called `current` to simplify the code a little.

The unicode charater processing is accessing index `i` out of scope.

The process short list is accessing index `i` out of scope.

Utilize the `current` pointer to help better manage avoiding accessing index `i` out of scope.

Cleanup: Add missing documentation on wrap_up_stop.

Cleanup: Add additional comment for f_console_result_found_d documentation.

Feature: Additional status codes, F_case, F_match, F_miss, and F_word.

Along with their inverses:
- F_case_not
- F_match_not
- F_miss_not
- F_word_not

Bugfix: Add missing f_string_format_sentence_end_basic_s definition.

Update: Remove firewall program.

The firewall program is being moved into the kevux-tools repository or in its own repository.
It will not be in the 0.8.x releases of the FLL project.

Update: Next minor and micro version (0.8.0).

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\.7\.3|0.8.0|g' -e 's|^version_micro 3|version_micro 0|g' -e 's|^version_minor 7|version_minor 8|g' '{}' ';'
  # find level_3/ -name *.h -exec sed -i -e 's|_program_version_micro_s F_string_ascii_3_s|_program_version_micro_s F_string_ascii_0_s|g' -e 's|_program_version_micro_s_length F_string_ascii_3_s_length|_program_version_micro_s_length F_string_ascii_0_s_length|g' '{}' ';'
  # find level_3/ -name *.h -exec sed -i -e 's|_program_version_minor_s F_string_ascii_7_s|_program_version_minor_s F_string_ascii_8_s|g' -e 's|_program_version_minor_s_length F_string_ascii_7_s_length|_program_version_minor_s_length F_string_ascii_8_s_length|g' '{}' ';'
  # find level_3/ -name *.h -exec sed -i -e 's|API Version: 0.7|API Version: 0.8|g' '{}' ';'
  # find level_3/ -type f  -name *.1  -exec sed -i -e 's|April 2025|November 2025|g' '{}' ';'
  # find level_3/ -type f  -name *.5  -exec sed -i -e 's|April 2025|November 2025|g' '{}' ';'
  # sed -i -e 's|version_micro 3|version_micro 0|g' build/*/settings build/stand_alone/*.settings level_*/*/data/build/*settings*
  # sed -i -e 's|version_minor 7|version_minor 8|g' build/*/settings build/stand_alone/*.settings level_*/*/data/build/*settings*

Update: The FLL tags file with the latest code.

Update: Utilize the F_status_debug_source_d for handling the errors.

This simplifies some of the logic and code.

However, there are some disadvantages of doing this.
One such disadvantage is losing the specific function that has failed.
The location in the source file should be sufficient, if not ideal.

Address issues where the `debug` mode is not being specified in some programs.

Update: Utilize the debug mode, changing the error printing functions.

The `function` parameter is now replaced with `debug`.
There are several changes to the error printing functions to accommodate this.

A new function `fll_error_print_debug()` is added for handling the printing of this debug parameter.

Update the programs to ensure that they compile with these changes.
A follow up commit is required to fully and properly utilize this debug parameter.

The Featureless Make had to be updated further to get it to compile.
This fixes incorrect documentation that I observed.
The debug and function conversions are only enough to get things to compile.
This will still need a follow up commit to properly change everything.

Update: Add the debug mode to the build settings.

Feature: Additional status codes, F_pretty, F_ugly, etc...

These status codes are added:
  - F_backward
  - F_backward_fast
  - F_backward_not
  - F_backward_slow
  - F_forward
  - F_forward_fast
  - F_forward_not
  - F_forward_slow
  - F_mute
  - F_mute_not
  - F_pretty
  - F_pretty_not
  - F_ugly
  - F_ugly_not

The pretty and ugly ones are based on the idea of prettify and uglify code concepts (such as prettify JSON or uglify JSON).

Feature: Support generating debug souce and line as well as debug mode.

Prrovide a new build mode called `debug`.
Apply it consistently across all build settings files.

Update the build settings file to be more consistent in regards to modes and related comments.

Provide new debug option called `F_status_debug_source_d`.
This provides a way to get the current source file, line, and possibly function.
This should help with debugging.
This was first implemented in the controller program and I liked it enough to bring it in here.

The error printing functions are currently not updated.
I will have to decide if I want to get rid of the old way of using the hard-coded and mapped function names.
The `_en_status_debug_` allows for enabling the debug printing (passing `-D_en_status_debug_` to a compiler).
The `_di_f_status_debug_d_` is also available for providing the standard define wrapper.

Update: Have thread condition wait functions return F_condition on success.

This provides a more accurate status code.

Update: Provide more granular error status codes in the thread full functions.

The LIBC pthread implementations fail to provide a way to truly verify that thread data is properly allocated or not.

The full thread types have two different thread related memory freeing functions.
If the first function fails, then the second structure is still allocated.

The previous behavior provided no way to distinguish between the two different failures.
These more granular status codes allow for such distinction now.

This allows the caller to manually try to de-allocate other parts even if the first de-allocation failed.

Feature: Add additional status codes, F_read_write codes.

- F_read_write
- F_read_write_execute
- F_read_write_execute_not
- F_read_write_execute_only
- F_read_write_not
- F_read_write_only

Feature: Add additional status codes.

- F_attribute
- F_attribute_not
- F_barrier
- F_barrier_not
- F_bdo
- F_bdo_not
- F_combarudoo
- F_combarudoo_not
- F_condition
- F_condition_not
- F_controller
- F_controller_not
- F_disk
- F_disk_not
- F_keyboard
- F_keyboard_not
- F_mouse
- F_mouse_not
- F_mutex
- F_mutex_not
- F_semaphore
- F_semaphore_not
- F_spin
- F_spin_not
- F_touch
- F_touch_not

Feature: Add F_lock_critical, F_lock_read_write, F_lock_release, F_lock_signal, F_lock_time, and F_lock_wait.

Add additional lock related codes to standardize more options for more fine tuned status control when dealing with locking.

Update: Remove f_thread_set_t and related.

This structure is no longer planned to be used and supported.
The path that I am taking is now different and does not need this particular structure.

Cleanup: Remove redundant mutex defines.

Update: Add f_schedule disables file.

Update: The FLL tags file.

Update: Finish adding functions to f_schedule.

This adds:
  - `f_schedule_affinity_get()`
  - `f_schedule_affinity_set()`
  - `f_schedule_attribute_get()`
  - `f_schedule_attribute_set()`
  - `f_schedule_policy_robin_interval_get()`
  - `f_schedule_priority_get_max()`
  - `f_schedule_priority_get_min()`
  - `f_schedule_yield()`

Note: the `f_schedule_attribute_get()` and `f_schedule_attribute_set()` have to use `syscall()` directly due to design problems with glibc.
The `struct sched_attr` is also an incomplete/broken type in glibc.
I have declared my own type based on the kernel structure.
It is unclear on how well this will work in practice.
I am also uncertain of the best way to mock a variadic function like `syscall()`.
The mocks for these are therefore incomplete.

Progress: Add more functions to f_schedule.

This adds:
  - `f_schedule_policy_get()`
  - `f_schedule_policy_set()`
  - `f_schedule_priority_get()`
  - `f_schedule_priority_set()`
  - `f_schedule_value_get()`
  - `f_schedule_value_set()`

Progress: Begin adding f_schedule.

I distantly remembered considering this in the past.
I think that I need to do this now.

This will be adding several of the scheduling functions.
This starts with the easiest one, `nice()`.

Update: Add defines for f_thread and update appropriate build data.

Add `f_thread` `common.h` and `common.c` with the defines relating to threads.

Move the `f_thread_mutex_attribute_*_d` into these files and remove the `_attribute` from their names.

Update the build disable headers.

Update: Add specific source design documentation.

I have described this in one manner or another since the start of the FLL project.
This explicitly states the behavior that the FLL project (and related projects) have always followed.

Cleanup: Style spacing in initialize define.

Update: The FLL tags file with the latest code.

Geany does a pretty poor job of building the tag files.
The way I managed to get this to work is to:
  1. Generate the monolithic package.
  2. Perform `fake clean make` on that package.
  3. Create a new project that points to the package, such as: `/path/to/fll-0.7.3/build/includes`.
  4. Set `file_patterns` to `*.h`.
  5. Set `source_patterns` to `*.c`.
  6. Set `header_patterns` to `*.h`.
  7. Set `ignored_dirs_patterns` to `*;test/*`.
  8. Set `ignored_file_patterns` to `*.o;*.obj;*.a;*.lib;*.so;*.dll;*.lo;*.la;*.class;*.jar;*.pyc;*.mo;*.gmo`.
  9. Select the `project->generate tags` option.
  10. Rename the generate tags file to end in `.c.tags`.
  11. Edit that file to replace `_TAG_PROC_CWD` value with something like `/usr/local/fll/includes/` (or `/usr/include/fll` for standard UNIX FHS systems).

The `ignored_file_patterns` has a lot of defaults that geany provided that I probably do not need.
The generated tags file is unusable because geany generates it without the `.c.tags` in the name and geany requires the `.c.tags` in the name to read (which is just plain stupid).

Update: Adding missing thread functions and types; restructure files.

It has become clear to me that I didn't actual complete the thread types.
This adds the array of array types that are missing.

The `thread.c` and `thread.h` files are huge.
Break apart the functions based on existing `thread/*` files.
Doing this requires being more particular about the ordering of the header includes.

Update and add appropriate unit tests.

Much of this is done via mass replacements.
There very likely are some unimportant oversights.

Update: Settings with latest code changes and address problems.

Fix issue where `_di_f_utf_string_seek_line_back` is missing the final `_`.
Fix issue with the `_di_f_idss_destroy_callback_` being missing.
Fix issue with the `_di_f_idss_*_callback_` having a messed up structure.

Add missing defines to stand alone build settings.
  - Add explicit `#define _di_fll_error_s_a_` and `#define _di_fll_error_s_e_` to stand alone build settings.
  - Add missing `#define _di_f_void_pointer_call_t_` to stand alone build settings.
  - Add missing `#define _di_f_thread_name_get_` and `#define _di_f_thread_name_set_` to stand alone build settings.

Add the settings for the recently added thread "full" types and their related functions.

Update: Provide "full" thread types and corrects other problems encountered.

There are new types like `f_thread_barrier_full_t` created that provide a structure of both the lock and its associated attribute variable.
For whatever reason the pthread design requires the attributes to be allocated.
This makes changing settings more complex.
These "full" types are provided to help reduce the burden of managing this mess.

I noticed a lot of random inconsistencies and other minor mistakes that I decided to simply address while working on this.
There are more things that could be done but I decided to limit myself to what is done here.

Of particular note are the attribute functions.
Several of the attribute functions were checking for error codes that do not exist as per the standard.
The attribute functions simply return fewer possible error codes that the locks.
I more than likely mass copied the locks into attributes and never corrects the dependencies.
Several of the tests were also testing these invalid status codes.

Cleanup: Add missing documentation in certain thread functions.

Feature: Add F_pause and F_resume.

I decided to add F_resume despite having F_continue due to the meanings being actually different despite the strong similarity.

Feature: Add F_future, F_past, and F_present status groups.

I am updating threads and realized that I should probably have a `F_future` status code.
Futures are common asynchronous terminology.

For completeness, I added `F_past` and `F_preset`.

This includes all of the respective "_not" codes.

Feature: Add missing mutex consistent and robust mutex attribute functions.

Add the following functions:
  - `f_thread_mutex_attribute_robust_get()`
  - `f_thread_mutex_attribute_robust_set()`
  - `f_thread_mutex_consistent()`

Add the new thread mutex group:
  - `f_thread_mutex_d`

Add the following status codes:
  - `F_consistent`
  - `F_consistent_not`
  - `F_robust`
  - `F_robust_not`

Add appropriate unit tests.

Update: Add thread mutex attribute defines, update tests, and add missing error handling.

Define `_di_f_thread_mutex_attribute_d_` such that the mutex attributes like `PTHREAD_MUTEX_NORMAL` have a mapped define.

The mutex lock and try lock are no longer missing the handling of `ENOTRECOVERABLE` and `EOWNERDEAD` errors.

Feature: Add F_is and F_is_not status codes.

Cleanup: Several old status code locations (second pass).

See the first pass for more details in commit: 8dacac51142c16c8118f9de8225d28708f540684.

This relocates the following sets:
- F_access
- F_directory
- F_equal_to
- F_file
- F_filesystem
- F_instance
- F_process
- F_socket
- F_terminal
- F_than

Remove any wrapping macro defines that should no longer apply.

Cleanup: Several old status code locations (first pass).

The status code used to be broken up into separate groups, wrapped by conditional macros.
The conditional macros were removed but I had left the remaining work to be done later.
Now is later.

This relocates the following sets:
- F_array
- F_available
- F_buffer
- F_busy
- F_complete
- F_data
- F_debug
- F_end
- F_error
- F_fine
- F_network
- F_number
- F_warning

Cleanup: Fix typo of 'exit' in documentation comments.

Feature: Add F_load, F_refresh, F_reload, F_unload, F_socket_time status codes.

This includes the associated "_not" codes.

Update: The FLL tags file with the latest code.

Geany does a pretty poor job of building the tag files.
The way I managed to get this to work is to:
  1. Generate the monolithic package.
  2. Perform `fake clean make` on that package.
  3. Create a new project that points to the package, such as: `/path/to/fll-0.7.3/build/includes`.
  4. Set `file_patterns` to `*.h`.
  5. Set `source_patterns` to `*.c`.
  6. Set `header_patterns` to `*.h`.
  7. Set `ignored_dirs_patterns` to `*;test/*`.
  8. Set `ignored_file_patterns` to `*.o;*.obj;*.a;*.lib;*.so;*.dll;*.lo;*.la;*.class;*.jar;*.pyc;*.mo;*.gmo`.
  9. Select the `project->generate tags` option.
  10. Rename the generate tags file to end in `.c.tags`.
  11. Edit that file to replace `_TAG_PROC_CWD` value with something like `/usr/local/fll/includes/` (or `/usr/include/fll` for standard UNIX FHS systems).

The `ignored_file_patterns` has a lot of defaults that geany provided that I probably do not need.
The generated tags file is unusable because geany generates it without the `.c.tags` in the name and geany requires the `.c.tags` in the name to read (which is just plain stupid).

Update: Add additional documentation notes regarding threaded conditional waits.

Make it easier to remember that the mutex must be locked before and unlocked after by the caller of the function.

Update: Handle F_implement_not and F_support_not in fll_error.

The Not Implemented and Not Supported error codes should be common enough to be handled by the standard FLL error print functions.

Cleanup: Fix alphabetic ordering in mocks.