Progress: Continue memory array related changes.

I noticed that I could also implement f_memory_array_append() and f_memory_array_append_all() methods if I used memcpy() and a multiplication over the type size.

This:
    const f_status_t status = f_memory_array_increase_by(source.used, sizeof(f_socket_t), (void **) &destination->array, &destination->used, &destination->size);
    if (F_status_is_error(status)) return status;

    for (f_number_unsigned_t i = 0; i < source.used; ++i) {
      destination->array[destination->used++] = source.array[i];
    } // for

    return F_none;

Could instead become:

    const f_status_t status = f_memory_array_increase_by(source.used, sizeof(f_socket_t), (void **) &destination->array, &destination->used, &destination->size);
    if (F_status_is_error(status)) return status;

    memcpy(destination->array, source.array, sizeof(f_socket_t) * source.used);

    return F_none;

This could then be logic could then be moved into something like f_memory_array_append_all(), further simplifying the code into:
    return f_memory_array_append(source.array, source.used, sizeof(f_socket_t), (void **) &destination->array, &destination->used, &destination->size);

I need to think of the function structure that I want and so I only decided to comment in this commit.
Such a change is not implemented yet but may be done at some later time.

Progress: Continue memory array related changes.

Progress: Continue memory array related changes.

This converts a lot of the projects to use the f_memory_array_*() functions.

Break the f_thread private functions into their own files.

Progress: Continue memory array related changes, replacing the f_memory_structure entirely.

The f_memory_array set of functions now fully replaces the f_memory_structure functions and related macros.
I think those structure macros are nifty but they are not in use enough anymore and the f_memory_array structure is what I am going forward with.

There is still an enormouse amount of changes to do.

Progress: Add memory array allocation functionality and begin to use it where possible.

The pattern for handling the standard array structure is now well established.
Provide a memory array functionality for handling the most basic form.

This should reduce repeated code where possible.
It would be interesting if this reduces the size of the resulting binary but with inline optimizations it may be possible that this actually increases the size of the resulting binary.

Update the comments and tests.

There are a lot of files that will need to be updated to use these new functions.
Most of these are in the f_type_array project.

Update: Add FSS Simple Packet related functionality and remove delimit and comment types.

The FSS Simple Packet functionality is added, to provide for processing of the FSS Simple Packet.
The f_fss_simple_packet_ranges_t represents a set of ranges for designating where/how the packet is defined within some string.

The delimit and comment types are just helper type definitions for existing number types.
Simplify the design by getting rid of those, replacing them with the type that they effectively represent.
A lot of code is updated to reflect this change.

Feature: Add specification FSS-0010 "Encrypted Simple Packet".

This is an encrypted variation of the FSS-000F "Simple Packet" specification.
The third control bit (from the left) represents that the Simple Packet is encrypted.

The requirements for the format of the actual contents of Payload Block is further relaxed due encrypted data needing to be private (for what should be obvious reasons).

Update: FSS-000f specification, adding reasoning and improve the wording.

Add a simple paragraph about the reason why the size bit includes the Control Block and the Size Block in its size representation.

Fix a mistake in the words where the standard has "...of that that...".
The back to back use of "that" is confusing and probably a typo.

Cleanup: Remove extra space in documentation comment of the standard.

This does not alter the standard itself and so the version date is left unchanged.

Cleanup: Documentation comments regarding structures.

Add "Properties: " and related styling to the documentation comments for type definition structures.

Fix capitalization and other formatting issues that I noticed.

I did not focus on any of the programs.
However, some program related files happened to be open and so I updated those out of convenience.
A follow up commit will be needed to address the programs and any other files in which I may have missed in this pass.

Update: Specifications, adding explicit version date and change license line format.

Add a version, which contains the date of the last change to each of the specifications.
There will eventually be a specification version number such as "1.2.3".

The license line in the comments at the top of each specification is of this form: "license: ".
Remove the colon so that the comment, if extracted, could be processed as something simple like FSS-0000.

Update: Specifications, replacing "emphasis" with "italic".

Update: FSS-000F (Simple Packet) Specification.

I have decided that the endianness bit must be first.
The String/Binary bit is now the second bit.
The remaining 6 Control bits are left undefined.

Do some cleanup up in the text.
Improve the language.
Make sure "italic" is used instead of "emphasis".

Feature: Add fll_program_print_error_parameter_integer_less_than() and fll_program_print_error_parameter_integer_more_than().

The less than and more than (greater than) are likely a common enough check to create standard functions for.

Update: Conversion should return F_number_positive and F_number_negative without error bit and do some clean up.

Do not treat F_number_positive and F_number_negative as an error.
The "unsigned" concept should be internal to the function and not whether or not the user input has a sign.

If F_number_negative is returned, the value can still be of type f_number_unsigned_t.
This is because the return status designates the effective sign.
The caller can then decide whether or not this is an error.

Update: Use status_signal instead of status_thread.

The status_thread is being used specifically for the signal thread.
Change the standard practice to have this renamed to status_signal.

This then helps make other status names make more sense.
Rather than have status_thread, status_thread_a, and status_thread_b, instead have status_signal, status_a, and status_b.

Cleanup: Use present tense in documentation comments regarding F_interrupt.

Update: The build disable files and stand alone setting files.

Update: Add poll enumerations for f_poll_t.

This also includes a few enumerations based on GNU poll flags.

Cleanup: Fix socket documentation comment, where type is the actual socket type.

The socket.type is not the address type, it is the socket type.

The socket type is something like SOCK_STREAM or f_socket_type_stream_e.

Update: Network additions and improvements, minor documentation comment clean ups.

Add f_network_is_ip_address() along with appropriate unit tests.
The unit test are not as thorough as they could be.
I did not fully review the IPv6 standard, which has a rather absurd design.
There are likely things that I do not yet know about that are not supported.
Specifically do not support port number on any IPv6 address without brackets.
(The IPv6 address notation standard is horribly written.)

Update: Add F_network_version_four, F_network_version_four_not, F_network_version_six, and F_network_version_six_not status codes.

The IPv4 and IPv6 situation is common enough to merit explicit status codes.

Cleanup: Conversion header comments.

Cleanup: Documentation comments regarding "This alters setting.status" in programs.

In such programs, this is comment is no longer accurate.

Update: Socket bind functions, socket address family enumeration, and rename max_backlog.

Change the f_socket_bind_local() bind function to not call memset() and use the new address structure.
Add f_socket_bind_inet4() and f_socket_bind_inet6() bind functions in a similar way to f_socket_bind_local().

Update the appropriate documentation.
Add the appropriate unit tests.

The name max_backlog for f_socket_listen() is better named backlog_max as per the FLL style practices.

Update: The f_socket enumerations and comments, the f_socket_t structure, the f_socket build settings, and the f_socket unit tests.

The _di_f_socket_protocol_e_ enumerations are missing the trailing "_e" in the name.

As stated in a previous commit (90d0f47999fd5615f2f3550d688f63d49e590482), update the documentation comments for the f_socket_protocol_family_e enumerations.

Change the ordering of properties in the f_socket_t to have length property after the address property.

Set the default string for the name property to be f_string_static_t_initialize instead of f_string_empty_s.

Disable the braces warning in f_console.
The brace usage here is correct, and so the warning is disabled.

Fix the unit tests as they were not updated after changes in the previous commit (90d0f47999fd5615f2f3550d688f63d49e590482) and in this commit.

Cleanup: Use the signal check functions in progams.

There already are signal check programs here.
Use those instead of manually performing the signal check actions.

Update: Socket improvements regarding structure and styling.

The f_socket_t structure has "struct sockaddr" as a pointer.
This means mass allocation becomes less practical due to needing to create the actual "struct sockaddr" as needed.
Implement an f_socket_address_t union that accepts the cost of less memory efficiency to improve the usability.

This now allows for mixed types to be stored in the array without needing complicated code to manage different arrays.
The caller will have to be responsible for properly setting the appropriate structure as needed.

Organize the code styling to be more consistent with alphabetical ordering.
I likely have some of the comments to update as well (a follow up commit will be necessary).

Update: Socket file settings, use enumerations rather than defines, and add family enumerations.

This expands the socket family and makes their use more correct and consistent with existing ones.

The socket domain is renamed where possible to be protocol family or address family.

Bring in a lot of the existing family type codes (both protocol family and address family).

Update: Add missing fakefiles for stand alone builds.

Update: The defines in cygwin.txt documentation are out of date.

Cleanup: Add "write" to the open modes involving write.

The "append" and "truncate" are not verbose enough.
Prepend "write_" to each of these to make the purpose and intent more obvious.

Update: The stand alone Featureless Make config.h.

Re-synchronize this file with all of the latest changes.
The stand alone build should now compile again.

Cleanup: There is no f_print_except_dynamic_in_safely() anymore.

There are no existing references to f_print_except_dynamic_in_safely() so remove the disable macro.

I don't remember removing f_print_except_dynamic_in_safely() so hopefully it is intentionally removed.

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.