Kevin Day [Thu, 9 Jul 2020 03:33:46 +0000 (22:33 -0500)]
Bugfix: risky macro definition caused counter problems.
Macros should be used sparingly, if at all.
When macros are used, they should be used carefully.
In this case, I was defining a variable "i".
The substituted data also included an "i", which caused a non-obvious problem.
Use a more unique counter variable name "_macro__i" to help avoid these problems in the future.
Kevin Day [Mon, 6 Jul 2020 04:58:10 +0000 (23:58 -0500)]
Revert: keep fss.h
Not having fss.h goes against some of the basic design.
Keep fss.h, but do not provide fss.c.
Kevin Day [Mon, 6 Jul 2020 04:45:28 +0000 (23:45 -0500)]
Cleanup: remove empty fss.c and fss.h, add missing dependency
Removing this exposed a missing dependency to f_file.
Kevin Day [Mon, 6 Jul 2020 03:49:56 +0000 (22:49 -0500)]
Progress: featureless make.
Update appropriate f_utf_ functions.
Implement "define" and "parameter" IKI variables as per IKI-0002.
These variables will be substituted with settings value if found or removed if not found.
This expansion will happen before performing operation.
rename fake_make_load_setting() to fake_make_load_fakefile() to be more explicit.
Minor cleanups.
Kevin Day [Mon, 6 Jul 2020 03:48:43 +0000 (22:48 -0500)]
Feature: add additional string comparison functions.
Comparing a string range to a non-string range can be messy.
Provide new functions to help alleviate this mess.
Kevin Day [Sun, 5 Jul 2020 23:59:09 +0000 (18:59 -0500)]
Update: Unicode related specification adjustments, also perform minor fixes and cleanups.
The Unicode includes some characters that violate some of the expectations of the FSS and IKI standards.
To that end, provide non-strict modes to allow for the FLL based adjustments of these standards.
There are some vertical line like characters that act as punctuation connectors.
Because they connect vertically instead of horizontally, they violate part of the inteded design of FSS and IKI where everything is on a per-line basis.
These Unicode vertical line like punctuation connectors are not to be considered punctuation connectors for the purposes of FSS and IKI processing.
There are some non-printing characters, such as invisible plus.
This is a punctuation character that is also a zero-width character.
For the purposes of FSS and IKI, these characters must not be considered punctuation characters.
Any other zero-width characters are to be considered zero-width and are not to be used for syntax and similar.
(Combining characters are a different beast to be addessed at a later time.)
Further clarify how certain Unicode characters are to be handled, in general.
Unicode dash characters are now being limited in being interpreted as a dash for the purposes of connecting words.
To this end, only the Unicode hpyhens are the allowed dash-like characters (with the ASCII dash being allowed as well for that matter).
Use const where possible.
Fix some wording in some documentation comments.
Kevin Day [Sun, 5 Jul 2020 22:33:03 +0000 (17:33 -0500)]
Update: improve IKI syntax rules.
This is a relaxation on the specification where previously only whitespace was required to exist before a valid variable name.
This allows punctuation to exist before the variable name.
Content such as 'A:"b"' may now be specified where A is the variable name (notice the single-quote before A which would previously prevent A from being recognized as a variable name).
Kevin Day [Sun, 5 Jul 2020 22:30:19 +0000 (17:30 -0500)]
Cleanup: change order of variables.
Kevin Day [Fri, 3 Jul 2020 03:58:27 +0000 (22:58 -0500)]
Bugfix: FSS-0000 and FSS-0001 are handling not explicitly follow standard for quote delimit requirements.
In the case where a quote is provided that could potentially be a valid quote, that quote should only be considered a quote (including for delimited purposes) if a valid whitespace, end of string, or end of line is reached.
The code needs to check after the closing quote to confirm that it is actually a valid closing quote before acting on it.
Update the FSS specification to make this behavior more explicitly clear.
Kevin Day [Fri, 3 Jul 2020 03:57:55 +0000 (22:57 -0500)]
Cleanup: add note to todo
Kevin Day [Thu, 2 Jul 2020 03:36:33 +0000 (22:36 -0500)]
Progress: UTF-8
More UTF-8 improvements.
The Punctuation is complete as far as the "Other" punctuation category is concerned.
(Apparently, there are more groups/sets to do!)
Create a new whitespace functions (is_whitespace_other()) to handle non-whitespace whitespace.
So far, this is only a single character: Ogham space mark ( ).
This Ogham space mark is not a whitespace, it is a graph character that is considered a whitespace.
Add some @todos.
Remove invalid whitespace character().
Add is_digit() vs is_numeric().
The traditional alnum() is referring to alphabet and digit.
With UTF-8 there are non-digit numbers, which can be classified as "numeric".
Therefore, the is_digit() functions are added and intended to be used for the traditional behavior.
The is_numeric() are intended to handle any numeric character.
The is_word() tests are for digits and not for numeric.
Kevin Day [Wed, 1 Jul 2020 05:07:33 +0000 (00:07 -0500)]
Update: UTF-8
Add more punctuation tests (there are still many more to go).
Fix an incomplete if condition in private_f_utf_character_is_whitespace().
Use width and byte_first more.
Kevin Day [Tue, 30 Jun 2020 00:59:12 +0000 (19:59 -0500)]
Progress: more UTF-8 work
Complete more encodings.
From the look of things, most emojis are part of symbols, so no need to check for emojis when already checking for symbols.
Add phonetic.
Progress on emojis will be slow and piecemeal.
Symbols will likely be as bad as emoji.
Kevin Day [Mon, 29 Jun 2020 04:25:14 +0000 (23:25 -0500)]
Bugfix: IKI Read should not always print content on substitution in whole mode.
When printing in whole mode, it is only printing the content, even when --literal is passed.
What should happen is that when --literal is passed, the entire variable should be printed, even when substitution is used.
The substitution will still occur.
Kevin Day [Mon, 29 Jun 2020 03:00:15 +0000 (22:00 -0500)]
Bugfix: f_utf_is_whitespace_modifier() is incomplete.
Remove "@see iscntrl()" which appears all over the place, incorrectly.
Make sure appropriate "@see" uses exist.
Remove unnecessary "== F_true" tests.
Implement is_punctuation and is_symbol discovery for ASCII characters.
Some function declarations are missing.
Some function implementations are missing.
Remove duplicate declaration of f_utf_character_is_word().
There are no whitespace modifiers in ASCII to my knowledge, and isdigit() is clearly from a copy and paste that was never completed.
Add notes about phonetic whitespaces and improve handling.
Kevin Day [Mon, 29 Jun 2020 02:59:36 +0000 (21:59 -0500)]
Update: U+102E0 is essentually a comma and not a number.
Kevin Day [Mon, 29 Jun 2020 00:09:25 +0000 (19:09 -0500)]
Update: finish implementing IKI Read program.
The resulting design made --expand redundant, so it is removed.
Substitution is implemented and works independent of the --name parameter.
Added a new macro to the FLL project called f_macro_memory_structure_macro_increment().
Too often do I have to create those structures, so here is a macro to perform the increment.
I started to update the rest of the project and then decided not to spend time on that right now.
This, therefore, primarily focuses on getting the macro working in IKI.
IKI Read is now considered usable, except for the UTF-8 support.
The UTF-8 support is dependent on updating a ton of UTF-8 codes.
This will be done at a later time.
The IKI Read program will eventually need to be reviewed for mistakes and cleanups.
Kevin Day [Sat, 27 Jun 2020 23:22:52 +0000 (18:22 -0500)]
Cleanup: add todo notes.
Kevin Day [Sat, 27 Jun 2020 23:17:45 +0000 (18:17 -0500)]
Bugfix: when --line is used, lengths passed buffer size aren't handled.
data->line is not a position, do not use it as a position (if (data->line < data->buffer.used) { is doing this).
If the line is exceeds the buffer, return f_data_not and properly handle that return case.
For --total, this means print 0.
For just about everything else, print nothing.
Kevin Day [Sat, 27 Jun 2020 23:03:46 +0000 (18:03 -0500)]
Bugfix: delimit placeholder not being applied in all cases
The final exist should apply any delimits.
When determining the remaining width, make sure that the range or buffer has not yet been exceeded.
Not doing this resulted in an exit with an F_parameter error, further resulting in no delimits being applied.
Kevin Day [Sat, 27 Jun 2020 21:38:26 +0000 (16:38 -0500)]
Progress: Iki Read.
Rename raw mode to whole mode.
I believe the meaning of the word 'whole' is more correct than the word 'raw'.
Implement 'whole' mode.
Kevin Day [Sat, 27 Jun 2020 04:33:04 +0000 (23:33 -0500)]
Progress: IKI Read.
Implement the basics of raw mode.
Raw mode should instead work in conjunction with the content, literal, and object modes so redesign accordingly.
Add some additional documentation to the help section.
Expand and Substitute are mostly ignored thus far and will be implemented at a later time.
The substitution will be copied from the argv as-is, so plan on using static strings instead of dynamic strings.
There will be function argument cleaning to do once I determine how Expand and Substitute will be implemented.
Until then, the arguments are fine as-is.
Kevin Day [Fri, 26 Jun 2020 05:01:32 +0000 (00:01 -0500)]
Progress: IKI Read
Continue work on implementing iki_read.
Kevin Day [Fri, 26 Jun 2020 05:00:00 +0000 (00:00 -0500)]
Cleanup: clarify IKI specification.
Any character, not just printing characters, is supported within the content of IKI.
Kevin Day [Fri, 26 Jun 2020 02:54:12 +0000 (21:54 -0500)]
Bugfix: read overflows the per character scanning
There is a logic mistake where the buffer is incremented too many times before the next loop.
This results in skipping some of the characters in the file and if those skipped characters are part of a vocabulary and content, then it will not be detected.
Kevin Day [Fri, 26 Jun 2020 02:51:59 +0000 (21:51 -0500)]
Cleanup: reserve IKI-0000 and update documentation
The standard IKI-0000 is now to be used to represent anything that follows the IKI standard without explicitly descrribing what its vocabulary is.
All other IKI standards (IKI-0001 and greater) are to be used to represent a specific set of vocabulary terms.
Kevin Day [Thu, 25 Jun 2020 04:00:41 +0000 (23:00 -0500)]
Update: dependencies changes, project level changes, and includes changes.
Review the current dependencies and fix them.
There are some cases where some dependencies are not necessary, such as f_utf.
There are some cases where some dependencies are missing (or newly added).
f_conversion split into f_conversion and fl_conversion.
Update dependencies accordingly.
For simplicity, include the core level_0 project headers, except in a small number of cases.
Add fss header comment in dependencies files.
Add comments in *_array.h headers for level_0 core projects.
Add missing header in f_string.
Replace _di_level_0_parameter_checking_ with _di_level_1_parameter_checking_ where incorrect.
The fl_fss identify functions should instead be in the fll_fss project.
Make sure the IKI projects are in the bootstrap example script.
Remove the fl_console_parameter_to_number_unsigned() and similar functions.
These are just wrappers to another call and is therefore a waste.
Instead, just call the fl_conversion_string_to_number_unsigned() and similar functions.
Kevin Day [Thu, 25 Jun 2020 03:49:39 +0000 (22:49 -0500)]
Bugfix: settings files are stored in 'data/settings/' not 'data/build/settings/'.
Kevin Day [Thu, 25 Jun 2020 03:35:04 +0000 (22:35 -0500)]
Bugfix: The setting is called 'build_sources_setting' and not 'build_sources_settings'.
Kevin Day [Thu, 25 Jun 2020 03:33:31 +0000 (22:33 -0500)]
Bugfix: completely ignore comments in dependencies file
Kevin Day [Wed, 24 Jun 2020 05:19:31 +0000 (00:19 -0500)]
Progress: IKI Read
Begin the process of adding the IKI Read program.
Kevin Day [Wed, 24 Jun 2020 05:19:05 +0000 (00:19 -0500)]
Cleanup: capitalize IKI
Kevin Day [Wed, 24 Jun 2020 05:18:41 +0000 (00:18 -0500)]
Update: todo notes added
Kevin Day [Wed, 24 Jun 2020 05:16:10 +0000 (00:16 -0500)]
Update: print formatting, closing file, and returning
The print formatting for status should be %llu in the event that the entire status (error bits, etc..) is printed.
There were some cases where the file is not being closed.
There were some cases where the program is missing the return statement.
Kevin Day [Wed, 24 Jun 2020 05:15:28 +0000 (00:15 -0500)]
Update: add f_macro_file_clear() and f_macro_file_reset()
Kevin Day [Wed, 24 Jun 2020 05:14:04 +0000 (00:14 -0500)]
Bugfix: conversion needs to properly handle '0x' and similar
Invalid Parameter happens when there is no following number after the x in '0x'.
This is because the start and stop range were not being checked after applying the offset.
Kevin Day [Tue, 23 Jun 2020 03:54:54 +0000 (22:54 -0500)]
Progress: Featureless Make.
Begin working on integrating IKI into Fake.
I took advantage of the current code to do some testing with IKI and left some of the testing code for now.
In addition to IKI, I am thinking that I need to add another project for exploding a string into separate arguments with support for escapable single and double quotes.
Kevin Day [Tue, 23 Jun 2020 02:25:27 +0000 (21:25 -0500)]
Bugfix: iki didn't handle all cases
I forgot to review the delimit cases and when I did I found the implementation a bit sloppy.
I also found some ways to improve the code.
The content slash total should start at 0 and not 1 because it increments it later on.
The fl_ik_read() needs to check the range.
Kevin Day [Mon, 22 Jun 2020 03:01:52 +0000 (22:01 -0500)]
Feature: add fl_iki project.
This provides fl_iki_read, a function for identifying all iki within a given range.
Whereas the f_iki_read function will only identify the first valid iki variable found within the given range.
Kevin Day [Mon, 22 Jun 2020 02:58:21 +0000 (21:58 -0500)]
Update: add missing dependencies, changes to iki
In a previous commit I seem to have forgotten to include the build settings changes.
Fix some minor mistakes in iki.
In particular, I forgot to increment the range->start after identifying where content would begin (which prevented it from working at all).
Add f_iki_variable to store the range for the entire variable.
This will allow for easy removal when substituting (which is one of the design intentions, so I need to cover this use case!).
Kevin Day [Sun, 21 Jun 2020 23:47:25 +0000 (18:47 -0500)]
Progress: Featureless Make and IKI.
Continue work progressing Featureless Make 'make' and the newly implemented 'Iki' standard.
Kevin Day [Sun, 21 Jun 2020 23:43:01 +0000 (18:43 -0500)]
Update: UTF-8 improvements
Move some FSS UTF-8 processing code into UTF-8 as it should be more generic.
Add more UTF-8 functions (or at least the stubs).
Begin adding emoji, which is all over the place.
Staring at so many codes, it will be easy to make a mistake.
After all of the UTF-8 functions are believed to be fully implemented an extensive review needs to happen.
Kevin Day [Sun, 21 Jun 2020 23:42:09 +0000 (18:42 -0500)]
Cleanup: fix comments
Kevin Day [Sun, 21 Jun 2020 01:03:42 +0000 (20:03 -0500)]
Progress: organize headers, simplify fss structures, initial IKI support
Move more headers into the secondary structures to simplify the main header, which will now more often be just for function definitions.
The FSS structures can use a more common base to better allow integration with separate projects that utilize the same basic design.
This is important for IKI project.
Casting to/from fss objects and contents to their respective ranges should now be possible.
Begin adding the IKI support, which is a new FSS standard focused on a simpler/smaller Wiki design.
The goal is not to handle presentation but instead to provide very simple context on certain text blocks based on some vocabulary.
A very common example would be sending a plain text e-mail with a URL in it, the URL could be encapsulated in an IKI vocabulary object to tell both the human and the computer that this is a URL.
For a URL, this is very useful in that no part of the URL need be escaped, except for the closing quote and its respective delimiter.
Example iki URL: url:"http://www.example.com/this does not exist/".
As opposed to http://www.example.com/this%20does%20not%20exist/.
The first case is easier for a human while still remaining simple enough for a machine.
The IKI syntax, at least in its most basic form, is not meant to be a full WIKI formatter.
While this may be accomplished with a sufficiently large enough vocabulary, this seems unnecessary at this time.
The IKI syntax standard itself is yet to be ironed out and ill be updated overtime until I am satisfied.
Kevin Day [Sat, 20 Jun 2020 19:08:03 +0000 (14:08 -0500)]
Bugfix: revert slash improvements in FSS object read
Oops.
When relocating this I completely forgot that an object starting with something other than a double quote or single quote can never be a quoted object.
Therefore only the first slash needs to be delimited.
I need to update the FSS documentation to avoid this oops again.
This will be tacked on to the todo list for when I do my extensive review of the FSS processing code.
Kevin Day [Sat, 20 Jun 2020 16:55:45 +0000 (11:55 -0500)]
Progress: featureless make
Continue current development, saving work to reduce any changes of accidental losses.
Kevin Day [Sat, 20 Jun 2020 16:55:21 +0000 (11:55 -0500)]
Cleanup: improve fss documentation
Kevin Day [Sat, 20 Jun 2020 16:46:24 +0000 (11:46 -0500)]
Progress: update FSS code, including zero-width updates
Update FSS to consider the recent zero-width improvements.
Making the changes reminded me on how I still need to go through and clean the FSS code up.
As noted in previous commits, the changes into supporting UTF really put the code into an unideal and not well tested state.
This needs extensive review and fixes.
To that end, I felt compelled to fix problems and perform cleanups that I observed.
At least to a small extent.
The basic and extended object reads are identical so move the code into a shared private function.
One behavioral change is to better support fail-through practice.
For FSS Extended, the contents are always terminated by a newline.
However, if there is an unterminated quote, then the entire process would previously fail.
This time, do no accept content for that line and continue on to next content.
Kevin Day [Sat, 20 Jun 2020 16:42:45 +0000 (11:42 -0500)]
Update: relocate utf.h code into utf-common.h and improve zero-width support
There is too much in utf.h.
Move the defines and other common things into utf-common.h.
There actually are zero-width ASCII characters (such as bell).
Fix this inaccuracy and handle all of the zero-width ASCII characters.
Newlines, tabs, and otherwise space that prints something, including vertical tabs however odd, are not to be considered zero-width.
Kevin Day [Fri, 19 Jun 2020 20:37:16 +0000 (15:37 -0500)]
Update: add additional f_fss functions and update documentation
Add line counting functions.
Remove unnecessary checks against negative values for unsigned numbers.
(They are theoretically necessary in that if the type was overwritten to a signed type, but for now just ignore that case.)
Finish adding or updating the *_together functions.
Review and update the documentation.
Kevin Day [Fri, 19 Jun 2020 20:34:06 +0000 (15:34 -0500)]
Feature: add F_recurse status code
The recurse status code is intended to be used for situations involving recursive operations.
Kevin Day [Thu, 18 Jun 2020 05:27:01 +0000 (00:27 -0500)]
Progress: featureless make
Continue development in featureless make, implementing support for "make" operation.
This expands the f_string project to support additional structures.
This expands the fll_fss project to utilize these additional structures.
I have reviewed and redesigned some of the fll_fss project functions.
The fll_fss project function redesign is incomplete and not fully tested as of this commit.
(I plan on reviewing and updating the *_together functions.)
The current fakefile is a stub/example for testing and will be updated to a correct default fakefile once the "make" operation is complete.
The plan is to have the fakefile provide an example for building th featureless make project using the fakefile.
This would mean that the featuereless make project can be built by the featureless make project using either the "build" or the "make" operation.
Kevin Day [Thu, 18 Jun 2020 05:24:29 +0000 (00:24 -0500)]
Update: package.sh clean should operate like build
The clean operation should respect the mode parameters in the same way build does.
Kevin Day [Tue, 16 Jun 2020 03:08:16 +0000 (22:08 -0500)]
Bugfix: invalid memory management in fll_fss_snatch_apart() and fll_fss_snatch_mash_apart().
Not sure what I was doing, but the logic is just plain wrong.
Kevin Day [Mon, 15 Jun 2020 05:00:29 +0000 (00:00 -0500)]
Cleanup: use the not status macro instead of the status macro with !
Kevin Day [Mon, 15 Jun 2020 04:58:02 +0000 (23:58 -0500)]
Feature: add fss_named and fss_set structures and re-organize the fss headers
Provide fss_named and fss_set structures (and their respective array structures).
These are useful when using FSS types nested within another set (not to be confused with fss_nest which is for a single type with recursion).
There are just too many things in fss.h.
Break it out into multiple headers that are auto-included.
Kevin Day [Mon, 15 Jun 2020 04:54:58 +0000 (23:54 -0500)]
Feature: add macro initializers for static string and string ranges
Creating defines with present lengths and them using these in static strings, sometimes with ranges, has become more common.
Provide the macros to make this simpler and ever be more usable for creating constant static strings and constant string ranges.
Kevin Day [Sat, 13 Jun 2020 23:27:07 +0000 (18:27 -0500)]
Update: ignore comment lines when processing package dependencies
Kevin Day [Sat, 13 Jun 2020 21:37:55 +0000 (16:37 -0500)]
Bugfix: incorrect invalid parameter check for file write for used to size comparison
The used may equal size, do not trigger an error.
Change un-reallocated dynamic strings to static strings.
Kevin Day [Sat, 13 Jun 2020 04:47:06 +0000 (23:47 -0500)]
Progess: begin working on featureless make 'make' operation
This adds my initial draft of the header.
Kevin Day [Fri, 12 Jun 2020 23:28:52 +0000 (18:28 -0500)]
Update: finish updating comment documentation and fixing any observed issues
This completes my maintenance pass that needed to be done following the significant changes introduced after developing the fake build process.
Kevin Day [Fri, 12 Jun 2020 03:10:12 +0000 (22:10 -0500)]
Update: only print depedencies list in verbose mode
Kevin Day [Fri, 12 Jun 2020 03:06:11 +0000 (22:06 -0500)]
Cleanup: remove stale fll_directory project
This project is no longer used and is empty.
Kevin Day [Fri, 12 Jun 2020 02:49:46 +0000 (21:49 -0500)]
Progress: UTF-8 file write should handle case where expanded character is larger than write max
When the 4-byte wide UTF-8 character is expanded into potentally 4 1-byte wide UTF-8 characters, the available bytes being expanded need to fit in the output buffer.
Kevin Day [Fri, 12 Jun 2020 02:46:49 +0000 (21:46 -0500)]
Update: Improve verbiage in package.sh and output current project being built in bootstrap.sh
The package.sh script should instead say "Packaging Project".
The bootstrap.sh script should output that it is building or cleaning a project and display the current project name and version if available.
Kevin Day [Fri, 12 Jun 2020 02:09:00 +0000 (21:09 -0500)]
Update: add support for ++quiet and ++verbose in the scripts
Kevin Day [Thu, 11 Jun 2020 04:19:16 +0000 (23:19 -0500)]
Progess: continue work in cleaning up UTF-8 and strings
Work relating to UTF-8 file related functions.
I also noticed that the *_delete_simple() and *_destroy_simple() macros are missing for the UTF-8 dynamic strings.
Kevin Day [Thu, 11 Jun 2020 01:24:06 +0000 (20:24 -0500)]
Progress: continue work in update UTF-8 functions and string functions
The UTF-8 functions have become out of date.
This is part of a series of commits to get it up to date and fix problems.
Fix problems with the string functions observed while performing this update.
Kevin Day [Tue, 9 Jun 2020 03:41:59 +0000 (22:41 -0500)]
Cleanup: Conditionally print color based on verbosity mode in certain messages in Fake.
Kevin Day [Tue, 9 Jun 2020 03:23:06 +0000 (22:23 -0500)]
Update: Move common fl_fss functions to f_fss where possible, also add private-fss.{c,h}.
Some of the fl_fss functions can be moved to f_fss, now that f_utf is considered an exception-case core library.
Some of the fl_fss functions are being used within itself.
Use private functions to do this.
Kevin Day [Mon, 8 Jun 2020 23:29:15 +0000 (18:29 -0500)]
Update: fl_serialized to f_serialize, renaming f_serialized to f_serialize
There is nothing forcing the current functions in fl_serialized from being in f_serialize.
Renamed f_serialized to f_serialize to be more consistent with the function names.
To that end, I have renamed the functions like f_unserialize* to f_serialize_un.
I have been unable to come up with a better name that is also reasonably short.
Kevin Day [Mon, 8 Jun 2020 23:06:30 +0000 (18:06 -0500)]
Update: move fl_socket to f_socket
There is nothing forcing the current functions in fl_socket from being in f_socket.
Kevin Day [Mon, 8 Jun 2020 21:53:27 +0000 (16:53 -0500)]
Progress: continue cleaning up comment documentation, fixing discovered problems
In particular, the fl_socket (which needs to be reviewed for being moved into f_socket) needed to be documented and had some issues to resolve.
Kevin Day [Mon, 8 Jun 2020 20:18:52 +0000 (15:18 -0500)]
Bugfix: individual bootstrap example does not handle errors properly
Double-Ampersand before a for loop does not work well in bash.
Instead, return result to detect error before attempting to operate for loop.
Kevin Day [Mon, 8 Jun 2020 16:09:47 +0000 (11:09 -0500)]
Progress: remove fl_file, more comment documentation cleanup and fixes
The fl_file project has been empty for some time, fully remove it.
Continue the work on updating the comment documentation.
Fix any observed problems.
Begin using the "Errors from .." style to simplify comment documentation maintainability.
Update the bootstrap-example.sh script, adding support for building the fake project as an example.
Kevin Day [Mon, 8 Jun 2020 14:09:43 +0000 (09:09 -0500)]
Cleanup: add .txt extension to documentation
This will make it convenient as well as consistent as the other documentation that also uses the .txt extension.
Kevin Day [Mon, 8 Jun 2020 04:41:05 +0000 (23:41 -0500)]
Update: allow multiple modes to be specified in the package.sh script
Kevin Day [Mon, 8 Jun 2020 04:34:49 +0000 (23:34 -0500)]
Update: documentation cleanups, fix observed problems, retun F_data_not without error bit
Organize the return codes.
Fix any probles in the commend documentation that I happened to notice.
This is not complete, there will be follow up commits to address more cleanups.
I noticed that there were some public directory functions incorrectly have 'private_' in their name.
The conversion functions should no longer consider no data an error.
Just report that there was nothing to do.
Kevin Day [Mon, 8 Jun 2020 02:16:51 +0000 (21:16 -0500)]
Update: documentation, also use fss-0002
Fix the documentation to clarify that the --work paramter is, in fact, more different than --prefix parameter.
Update the tree examples to show both the build directory tree and work directory tree.
Switch to using the fss-0002 format for all of the documentation files and specification files.
Kevin Day [Mon, 8 Jun 2020 01:15:51 +0000 (20:15 -0500)]
Update: main readme documentation.
This documentation is in an FSS format.
The other documentation files will likely be converted to the same FSS format in the near future.
Kevin Day [Sun, 7 Jun 2020 22:04:09 +0000 (17:04 -0500)]
Bugfix: build directory should be created if needed and not pre-required in all cases
Don't optionally required the build directory.
Always create it when needed, so do not require it.
Kevin Day [Sun, 7 Jun 2020 21:40:24 +0000 (16:40 -0500)]
Update: implement --process parameter
Looks like I forgot to implement this.
The --process parameter is a process name that is prepended to stage file names for the purpose of granting the caller additional flexibility.
Kevin Day [Sun, 7 Jun 2020 21:11:50 +0000 (16:11 -0500)]
Update: add Featureless Make documentation and specifications
This is a good starting point for the documentation.
I may or may not add more at a later time.
Kevin Day [Sun, 7 Jun 2020 21:11:28 +0000 (16:11 -0500)]
Cleanup: fix ordering of path_language
Kevin Day [Sun, 7 Jun 2020 19:59:08 +0000 (14:59 -0500)]
Cleanup: remove project_level setting
Remove this stale code.
This was mostly removed already in previous commits from the settings.
This was replaced by the path_headers setting.
Kevin Day [Sun, 7 Jun 2020 19:41:14 +0000 (14:41 -0500)]
Bugfix: mispelling in search_exclusive
Kevin Day [Sun, 7 Jun 2020 19:05:29 +0000 (14:05 -0500)]
Update: bootstrap dependency functionality, fix missing dependencies, also ensure level and monolithic
It seems I wrote a dependency generator to make my life easier and then I went and forgot about it.
Update this to work with the more recent changes to the build settings structure.
While I am at it, generate all of the dependencies and save the generated dependencies.
This exposed a typoe in the dependencies file, now fixed.
Might as well make sure the level and monolithic dependencies are generated as well.
Kevin Day [Sun, 7 Jun 2020 15:31:36 +0000 (10:31 -0500)]
Update: add documentation note about the bootstrap-example.sh script
Kevin Day [Sun, 7 Jun 2020 15:27:27 +0000 (10:27 -0500)]
Cleanup: rename generate.sh to bootstrap.sh
The generate.sh is a bootstrap for each individual project.
Officially calling it the bootstrap just makes sense.
Kevin Day [Sun, 7 Jun 2020 15:27:02 +0000 (10:27 -0500)]
Cleanup: rename bootstrap.sh to boostrap-example.sh
Kevin Day [Sun, 7 Jun 2020 15:24:48 +0000 (10:24 -0500)]
Cleanup: rename generate to bootstrap
The generate script is now officially a bootstrap script.
Kevin Day [Sun, 7 Jun 2020 15:19:36 +0000 (10:19 -0500)]
Update: add new documentation, improve existing documentation
Kevin Day [Sun, 7 Jun 2020 14:35:57 +0000 (09:35 -0500)]
Cleanup: rename work_directory to work
This makes the parameter consistent with the generate.sh script.
Kevin Day [Sun, 7 Jun 2020 14:35:23 +0000 (09:35 -0500)]
Update: rename readme to readme.bootstrap
Kevin Day [Sun, 7 Jun 2020 14:11:55 +0000 (09:11 -0500)]
Cleanup: ordering of function names and add spaces before function instantiation open brace
Kevin Day [Sun, 7 Jun 2020 14:07:06 +0000 (09:07 -0500)]
Update: support copying documents, licenses, and specifications per project and do some cleanups
Individual projects, specifically programs (level_3), may have custom documentation, licenses, and specifications.
(With custom licenses being least likely because this project in its entirety is under lgpl.)
Add support to all projects just for good practice.
Cleanup ordering of function names and add spaces before function instantiation open brace.
Kevin Day [Sun, 7 Jun 2020 03:30:17 +0000 (22:30 -0500)]
Update: Featureless Make needs to handle the -d/--define parameter
Rename the parameter from defines to define, because it acts on only a single parameter at a time.
The -d must be specified multiple times to get multiple defines.
When -d/--define is specified, the defines provided by the settings file get ignored.
Continue to pass the defines from the console parameters to the process scripts.
Kevin Day [Sun, 7 Jun 2020 02:45:35 +0000 (21:45 -0500)]
Update: add missing handling of defines_all, defines_shared, and defines_static
Kevin Day [Sun, 7 Jun 2020 02:32:27 +0000 (21:32 -0500)]
Bugfix: shared library link names are incorrect
The standard link names are:
libfake.so -> libfake.so.0
libfake.so.0 -> libfake.so.0.5.0
Instead, I had:
libfake.so.0 -> libfake.so.0.5
libfake.so.0.5 -> libfake.so.0.5.0
While I am at it, make these links reflect the version_target setting.
If target is major, then standard link names above are followed.
If target is minor, then:
libfake.so -> libfake.so.0.5
libfake.so.0.5 -> libfake.so.0.5.0
If target is micro, then:
libfake.so -> libfake.so.0.5.0
Kevin Day [Sun, 7 Jun 2020 01:58:27 +0000 (20:58 -0500)]
Cleanup: add build_language setting
This defaults to C, so there is no issue if it is not defined.
Still, it should be provided as the default in the FLL project.