Update: Add f_sockets_t, add f_socketss_t, and other f_socket changes.

The socket.name is better as an f_string_static_t.

Fix the outdated and incorrect documentation comments for f_socket_t.

Add additional macro functions for initializing the f_socket_t.

Cleanup: Don't bother with != for existence modulus checks.

The 'X % 2' and 'X % 3' will be non-zero with they are not divisible by the given unit.
The '!= 0' check is not necessary.

Bugfix: The boostrap script should not fail if documentation directory is empty.

Instead of failing, print a warning and continue onward.

Cleanup: Minor syntax mistakes in the documentation comments.

These were randomly discovered while I was working on the 0.6 branch man pages.

Bugfix: The build scripts are not handling documentation directory.

The man pages are not being correctly copied over, if at all.

Update: Add documentation comments regarding problems observed with gethostbyaddr() and gethostbyname().

Valgrind reported still reachable memory under a Glibc system when the network is not connected while performing a DNS resolution operation.

There is nothing I can do about this other than recommending to use something other than Glibc such as musl-libc.

Cleanup: Restructure time related types and add f_date_spec_t.

Make the time based types more interchangeable by using f_time_t.

Create a new time type called f_date_spec_t that utilizes f_time_spec_t instead of f_time_t for the time property.

Update: Relax the requirement in the license to be less verbose.

Do not specifically use my name "Kevin Day".
Instead refer to the "original license owner" or some authorized party.
This will make the license more flexible.

Feature: Add f_network_from_ip_address() and f_network_from_ip_name().

These are added to provide wrappers to gethostbyaddr() and gethostbyname().

Update the unit tests.

Bugfix: FSS Identify code accidentally got insert into the UTF8 program.

Probably an accidental mass find and replace somehow made its way into this file.

Update: Add unit tests for f_files_t and f_filess_t.

I forgot to add the unit tests with the commit fc1d33e993e99e8ff34d82be7fabadf7608d9c6d.

This also addresses a define name design problem where I have two cases that _F_type_array_file_h would be defined.
For now, just rename the _F_type_array_file_h to _F_type_array__file_h for the top-level file.

Cleanup: Remove unused files.

Feature: Add f_files_t and f_filess_t.

Provide arrays of f_file_t.

Bugfix: The level and monolithic build settings files are missing the poll source and header files.

Cleanup: Remove 'data_make.' from documentation comments in projects that do not use data_make.

Bugfix: Incorrect wrapping disable macro names for main functions.

The "_data_" should not be part of the macro name when it is not in the function name.

Update: Reduce NULL parameter requirements in f_file_select() regarding timeout.

The man pages state that the read, write, and except can all be NULL if timeout is not NULL.
Change the behavior of f_file_select() to allow this.

Update: The FSS Identify program to the latest practices.

Cleanup: Documentation comments, adding missing colon and fixing word usage.

Feature: Add f_file_select() for select().

This is more of a wrapper around select() (unlike f_file_poll() which is a bit more than a wrapper around poll()).
The arguments would be more difficult than worth it to simplify and normalize in the FLL typedef style.

Cleanup: Add quotes to testfile LD_LIBRARY_PATH assignment.

Do this for consistency with the pattern of the rest of the testfile.

Feature: Add additional network and socket related functions.

Add the following:
- f_file_poll() for poll().
- f_socket_read_stream() for recv().
- f_socket_write_stream() for send().

Add f_poll_t, f_polls_t, and f_pollss_t typedefs.
This adds the appropriate array management functions.
To be consistent with type_file.h a new type_array_file.h is created to manage these.

Update the existing f_signal_read() to use the new typdef f_poll_t.

This includes unit tests as appropriate.

Cleanup: Add environment to all unit test settings files.

Feature: Add f_network_to_ip_string() and f_network_from_ip_string() functions.

Provide support for inet_ntop() and inet_pton().

String are handling in FLL via f_string_static_t and f_string_dynamic_t.
The functions f_network_to_ip_string() and f_network_from_ip_string() are written to convert to these string types.

This implements a custom f_network_family_ip_t type to pass the digit IP address.
The idea here is to help reduce how much the FLL API is locked into the "libc" or POSIX API.

The structures are allocated using "{ 0 }" to take advantage of the supposed relatively new feature that treats this as an initialize all to NULL.

Cleanup: Fix documentation comment in f_memory.

Update: Remove unneeded variable storage and explicitly check for "-1" rather than "< 0".

Update: Rebuild the "disable" build files.

This needs to be done periodically when there are changes to functions.
Following the addition of f_network is a good point in time to do this.

Feature: Add f_network level 0 project, starting with host to/from network byte order functions.

As with most such level 0 projects these are just wrappers to the standard htonl() and similar functions.

This also updates the build settings and other related files.

The f_type_array also has some problems in the level and monolithic build settings fixed.

Cleanup: Fix incorrect comment in f_limit.

Feature: Add f_file_manipulate() as a wrapper for fcntl().

This also adds the unit tests.
The unit tests includes additional fixes where several of the wrapped functions are not being setup properly.
The fact that has not triggered an error in the past is concerning.

Feature: Add F_again and F_again_not status codes.

The fcntl() function uses two forms of privilege failures.
The EPERM is already translated to F_prohibited.
Therefore, add F_again (and F_again_not) so that EAGAIN can be used for that.

Feature: Add f_socket_name_host() and f_socket_name_peer().

Add missing network socket related functions for getting the "name" of the local or remote connections.

The local name is retuned as a string.

The remote name is returned on the f_socket_t structure.
I considered doing the work necessary to better generalize this but I decided not to.
I can leave that for once I am better experience in the network programming.

Cleanup: Rename *_total_parameters_d to *_parameter_total_d.

The naming scheme for the total parameters define is out of synchronization with the practices.
Rename this to be more in line with the current practices.

Cleanup: Add missing f_thread dependency.

Feature: Add list support for directory recurse processing.

The fl_directory_do() now provides support for the callback to handle the directory list process.

Cleanup: Documentation comments in fss_read.

The F_interrupt comments are now more correct.

Bugfix: Object files are not being added for shared program.

I overlooked replacing this variable when I refactored the code some time ago.

Bugfix: Featureless Make is not operating properly due to failure to clear cache.

Handle some cases where the cache is not being cleared.

Feature: Support error file type "link".

I may add all the others in the future but for now all I need is is to add "link".

Cleanup: Remove incorrect documentation content about return type.

The comment no longer applies as the functions return void.

Update: Use present tense for implemented (now implement) status code.

The F_implemented and F_implemented_not are now F_implement and F_implement_not respectively.

Bugfix: The default standard in fss_read is not working.

The default is not completely setup.
Add the missing callbacks and set the appropriate flags.

Use a new area to contain the default for maintainability.

Update: The Open Standard License, adding stronger terminology and more clarification.

Cleanup: The level_1 utf.h does not exist anymore, do not include it.

Update: Remove f_array_length_t and related, replacing with f_number_unsigned_t and appropriate.

This simplifies the design.
Doing this comes at a cost of some flexibility and hackability.

After some consideration, I have decided that it can introduce more complicated handling when needing to process both f_array_length_t and f_number_unsigned_t during I/O.
This should keep things simple.

I decided to maintain the custom functions for managing this.
I could use an ifdef wrapper and call the appropriate calls within, but I can do that for another time if I decide to (and remember to).

Cleanup: Remove no longer needed programs.

The fss_read is mostly complete for these programs.
Additional review and testing is needed but I can do that slowly over time.
The runtime unit tests suggests that these are reasonably complete.

The Embedded List Read is not deleted because it is not complete.
There are bugs in both the 0.6.x and the 0.7.x versions.
A rewrite of that mess is needed (and has been for a long time).
I will push this off for now due to it being low priority.

Update: Finish the FSS Payload Read help message printing.

I quickly reviewed the help messages and found that FSS Payload Read is the only one needing to be updated.

Update: Rebuild runtime test expect files and add new line tests.

Bugs have been recently fixed in the 0.6.x version.
Rebuild the existing runtime test expect files using these updated 0.6.x programs.

Add additional --line parameter tests for line 6 following the line 5 tests.

Progress: Fix issues in runtime tests for fss_read not relating to Embedded List and Payload.

More runtime tests now pass.

The Extended List tests still fail in some cases.
I noticed that the Extended List line count is not handling the closing brace.
The count is inaccurate.
This is a bug in the 0.6.x branch and needs to be fixed there.
The fix is in place for this branch but the tests currently fail because they generated expect files are incorrect in this case.

There are other similar problems in different FSS read programs regarding --total and parameters like --at or --line that need to be fixed in the 0.6.x branch as well.

The Embedded List and Payload need special handling and are not addressed here.

Other things regarding fss_read not done:
- The help printing needs to be updated for each program.
- Any remaining todo and fixme.
- The pipe input and output.

There is likely a lot of room for improvement but I am going to ignore such things for now as my priorities are elsewhere.

Progress: Continue working on fss_read.

Focus on the Basic and Extended standards.
Begin working on Basic List standard.

There is already a function fss_read_process_at_line().
Cannibalize that function and turn it into a standard at line normal processor function.

Update documentation comments, clarifying the "at" parameter.

Update: Complete most of the runtime times for FSS Read program.

Note that this says "most".
I noticed a segmentation fault with FSS-0.6.x versions of fss_embedded_list_read.
This needs to be addressed but is not done so here.

This does not address the tests that fail.
A subsequent commit will follow to address these failures.
These failures are most likely due to that I have not finished migrating all of the fss_read standards.

This also adds some files with UTF-8 characters in the name.

Bugfix: The fakefiles modes are not consistent with the settings files.

Update all of the modes in all affected fakefiles to be identical to the modes in the testfiles.

Bugfix: Incorrect build settings and testfile.

The modes are incorrect.
Replace "individual-thread" with "individual_thread".

Update the testfile with the appropriate modes.

Add the "fanalyzer" settings.

Bugfix: Use arguments passed to fake when processing build with the custom build arguments.

The custom build arguments are passed when the make mode is being used to call the build mode.
The mode arguments passed to the fake program, these should be propagated into the custom build arguments for the build mode.

Bugfix: Use the custom build settings name if passed when printing current setting being used.

The message, such as:
  Building fss_read using 'settings' with modes 'monolithic', 'thread'.

Should instead be:
  Building fss_read using 'settings.main' with modes 'monolithic', 'thread'.

Use the custom settings name if the custom build arguments are passed to display the correct name.

Update: Enable testing programs, starting with fss_read, and other fixes.

The fss_read is not yet working in this due to some configuration problems with threads.

The thread settings is now "individual_thread".
The old name was replaced some time ago but this file was overlooked.

Cleanup: Add "script" parameter to fss_read testfile.

This makes it easier to switch to another scripting engine, such as ZSH.

Cleanup: Add -Wno-main to suppress warning about "main".

This warning is not relevant due to how the project is designed.

Bugfix: Incorrect variable name used in fss_read_main_process_help() callback.

Cleanup: Add quotes to testfile LD_LIBRARY_PATH assignment.

Do this for consistency with the pattern of the rest of the testfile.

Bugfix: Unit tests are not up to date.

These unit tests were not fully updated with the latest design change.

Update: Add backticks to runtime tests.

The backticks need to be tested as well.

Update: Better describe the quote requirements for the documentation comments.

This is a follow up to the commit e793c5a5b9f3c3c636e55e0b52df1a11590827cb.

Bugfix: Fix runtime tests and problems exposed by runtime tests.

Add additional runtime tests to handle more cases.

The --select functionality is now completed.
This includes using --select with --name and --total.

The quotes are not being handled properly.
This has been fixed by the previous commit (e793c5a5b9f3c3c636e55e0b52df1a11590827cb).
The fss_read tests are updated to better test and expose this potential problem (adding single and double quote usage).

I used the 0.6.x fss_*_read functions to generate the expected output.
This exposed a mistake in the fss_extended_read in the 0.6.x branch where the wrong quotes are being used.
The expecations have been manually corrected and I now need to go back and fix this bug in the 0.6.x branch.

Bugfix: Quotes in FSS read functions are not being properly handled.

At some point in time the intended behavior changed from using the literal quote character to an enumeration representing the quote character on FSS read calls.
This transition is incomplete and broken.

Finish the transition, passing the enumeration representation rather than the literal character.

Remove an unnecessary initialization on the quote because the private function being called also initializes the variable.

Relocate the f_uint8s_increase() call to be after changing the error status to ensure that the quotes array is properly incremented.

Update the documentation comments to better clarify this behavior in regards to the enumeration.

Cleanup: FSS Read testfile and related.

Add some new lines to the testfile.
Remove a redundant directory create operation in the testfile.
Remove the '=' character as it does not provide anything useful when printing the test status.

Regression: Incorrect parameter location used, breaking parameter processing.

The regression is introduced in commit 4c0ca86048e431de2025c39a3f5078b7248192eb.

I completely forgot that "location" is for the parameter location and is not the last value location.
Some part of me wanted a last value location.
Revert back to using "values.used - 1" instead of "location".

Progress: Add simple runtime testing scripts and testfile for fss_read.

This is an incredibly basic implementation.
I didn't bother to make is as flexible and portable as it could otherwise be.

Provide a way to test the runtime results of the fss_read programs.
I only got so far as to add tests for FSS Basic (FSS-0000) and FSS Extended (FSS-0001).

The tests for the FSS Extended (FSS-0001) currently has some failures.
I've noticed that I have not even implemented the --select functionality.
This is the likely cause for several of the test failures.

For now, I just cheated and used the 0.6.x version of the project to generate the expected output.
Any bugs in that output will be matched (ideally there are no bugs).
I did do a quick glance at some of these and they do look fine.

The source test files are copies of files I have used in the past but never made publicly available until now.

Bugfix: The set no EOL is misplaced on "extended" and should be on "basic_list".

The fss_read program is incorrectly settings the no EOL set function for the FSS Extended (0001) standard.
This should actually be on the FSS Basic List (0002) standard.

Bugfix: Remove extra (and invalid) processing of --select parameter.

This --select parameter is already processed and validated earlier in the settings load function.

Bugfix: Handle f_directory_not status as an invalid directory.

The status f_directory_not is returned with the path exists but is not a directory.

The fake program can fail when doing something like this:
  fake clean make -w /arbitrary_non_directory_file +V

The error message returned is not very helpful:
  ERROR: (674) when calling function f_file_stat().

This is a known file-related error and so it is now handled appropraitely.
The new error message looks like:
  ERROR: Invalid directory while trying to access directory '/arbitrary_non_directory_file'.

Bugfix: The testfile needs to handle the --build parameter and improve --work parameter handling.

Provide a new operation "build_path" to load the "--build" parameter properly.
The existing checks for the "--work" parameter is better suited checking against "work:value" rather than "work".

There may be an existing bug where the condition for "build" parameter is always returning true when it should not.
This requires further investigation and is not addressed within the scope of this commit.

Cleanup: Fix comments in settings-tests files.

Progress: Continue work on refactoring fss_*_read into fss_read, focusing on fixing issues.

Get the programs into better working state.
I found several problems resulting from the way in which I migrated and refactored the code.
I think the next thing to do is to instead start writing some runtime tests that can better find problems.

Of particular note, I found problems with the comments being printed properly (which generally means not printed).
Some parameter handling problems are also fixed.

The payload and embedded list need special handling and are very much not implemented.

Update: Make fss_read and fss_write --as consistent and fix spacing in help.

The fss_read is using -a already and instead uses -A for the --as.
Change fss_write to also use -A for consistency reasons.

Fix spacing alignment in printed help for the --as parameter.

Progress: Continue work on refactoring fss_*_read into fss_read.

Get the programs into better working state.
Now I need to next focus on ensuring that they work as expected.

The payload and embedded list need special handling and are very much not implemented.

Security: F_data_not is not being handled leading to invalid read or write.

At some point I changed the behavior to return F_data_not when the main string (usually buffer) has used set to 0.
I failed to update the FSS processing functions to handle this.

The documentation comments are also not up to date in this regard and is now updated.

Progress: Continue work on refactoring fss_*_read into fss_read.

This gets the programs compiling.
I decided not to get everything correct and instead decided to get everything compiling.

The memory allocation needs to be fixed.
There are a lot of fixme and todo comments to address.
The payload and embedded list need special handling and are very much not implemented.
Individual standard differences need to be handled (and some are stubbed out or copied over, making them invalid).

Progress: Continue work on refactoring fss_*_read into fss_read.

The primary focus is on cleaning up the state of the code.

I will at some pointer later resume migrating the code.

Progress: Continue work on refactoring fss_*_read into fss_read.

Break out the callbacks into its own type as a sibling to the program and settings structures.
Do this in both fss_read and fss_write.

Remove unused "escaped" variable from fss_write.

Progress: Continue work on refactoring fss_*_read into fss_read.

Progress: Continue work on refactoring fss_*_read into fss_read.

Progress: Continue work on refactoring fss_*_read into fss_read.

Some small progress on refactoring the settings loader, focusing on the depth processing function.

Cleanup: Remove no longer used fl_utf project.

The source files are already empty.

Progress: Continue work on fss_read, making relevant changes in other projects.

Start using "static" where it is safe to do so and easy for me to identify such cases.
I would note that a static array of const f_string_static_t does not work.

Bugfix: Fix return codes and clean up package.sh.

Fix the return code handling just like the test.sh script in commit 5ccbc0f080ca5908f77e20879988b94a4cc0c6a9.

The package.sh script is rather out of date in regards to the use of wrapping braces.

Bugfix: Incorrect return code in tests causes false failures in CI.

Recent changes of the code change the "failure" variable from being an empty string for no error to being the explicit digit of "0".
The change is incomplete and this caused the false failure by incorrectly returning "1" when instead "0" should be returned.

The Gitlab CI detected this but the Github CI failed to.

Progress: Make some progress towards getting fss_read up and running.

This mostly focuses on the print help functions.

Fix the incorrectly spelled "aplied".
Fix the help messages in the read man pages.

Add *_format_code_name_* for an upper-case human friendly name.
Add this to the fss_write as well given that the programs follow the "programs as a library" design.

Progress: Initial setup of fss_read for merging all fss_*_read programs.

This is just a copy and paste of fss_write with some very basic initial changes and refactoring.
This is not expected to work anytime soon and will be slowly converted.
Expect major changes.

I suspect that I will be working outward in to slowly add the needed functionality and to match the behavior with the fss_*_read programs.
All of the fss_*_read programs will be removed and replaced with this once this project is complete just like was done with the fss_*_write programs and fss_write.

Also fix an incorrect comment in fss_write that references "payload" when it should not.

Update: Slightly reduce recursion cost for private_fl_directory_do_recurse().

Make some constant structures static with the goal of reducing the cost of recursion.
Using static should help avoid redeclaring these variables per execution.
This should reduce memory for each recurse into the function.

Bugfix: Incorrect wrapping define usage.

Much of this is discovered in the 0.6.x branch and I ported over some changes.
There may have been something missed.

Bugfix: Fix problems exposed by unit tests.

The f_pipe_debug and f_pipe_warning are no more and there is now an f_pipe_output.

The f_print_to* functions should not use parameter checking and should instead eturn F_file_descriptor_not when the descriptor is -1.

The F_help and F_help_not to string conversion is missing.

Update: Get remaining unit tests working.

Progress: Continue fixing the unit tests.

Properly handle mock return types.

Make sure to return F_file_descriptor_not instead of F_stream_not in cases where the file descriptor is checked instead of the file stream.

Cleanup: Suppress false positive regarding missing braces.

Update: The stand alone builds should also support fakefiles.

This is an oversight from previous changes where stand alone support is implemented and where the fakefile is make more advanced (adding help etc..).

Refactor: Mass change the macro initializer functions to always have an underscore and some identity.

The macro initializer functions can be a little confusing when there is macro_f_do_something() and macro_f_do_something2().
Change the behavior to something more like macro_f_do_something_1() and macro_f_do_something_2().

Progress: Unit tests and other minor changes.

Get more of the unit tests up to date.
I did not finish working on the f_file unit tests.
I specifically stopped on the stream functions, namely the f_stream_write().

Fix the file defaults, such as _di_f_type_file_defaults_ that should be _di_f_type_file_defaults_d_.

The file flags (wrapped by _di_f_file_flag_d_) must be located with the f_type type_file.h file.

Bugfix: Fix bugs in console parameter processing exposed by unit tests.

The f_console_identify() function is incorrectly assigning the bits for short alone values.
The mistake is a missing pipe character and as a result the flags are being assigned rather than being bitwise-or appended.

The short.used and long.used string checks should skip when the string is empty.
This is not happening due to an AND comparitor in the string.
This then causes a false positive and the unit tests identify invalid data.

The process found check outside of the loop that depends on the iterator "i" should also check that i is less than the total array length.

Update: Unit tests.

Get several of the unit tests working.
These tests were not updated when their respective code was changed.