ufos 1.0.77 → 1.0.79

data/documentation/emeraldc

@@ -1,26 +1,19 @@
 The Ultimate C Preprocessor
 
-
 I'm naming this preprocessor “Emerald C.”
 
 <a href=https://cboard.cprogramming.com/c-programming/181160-hi-i-have-created-some-work-i-think-will-really-valuable-community.html?s=589b5504cd0e3c2dc90e9abd8b66906f>Link</a>
 
-
-
 Howdy!
 
 First, let me state that I am very much a perfectionist.
 
-
 C is a wonderful language. C is probably the perfect programming language. It is one of the top two most widely used languages for a reason.
 
-
 Now, there are some problems with it of course, but it's hard to think of a more elegant language than it.
 
-
 It is the language of systems, the language almost all APIs are written in.
 
-
 It is the lingua franca of the software world.
 
 People try to avoid it, but they needn't.
@@ -29,10 +22,8 @@ I think every programmer wants to find out how to do things, or use libraries th
 
 Many programmers have done programming, grown dissatisfied, and then make another language. As a result, there are thousands of different languages.
 
-
 Well, recently, I made a preprocessor for C, that makes C incredibly EASY.
 
-
 C is fast and straightforward without it, but it has many features.
 
 If one runs the command line preprocessor, with the “--features” flag, the program shows all of its features
@@ -41,7 +32,7 @@ A Better C
 
 C is a fantastic language. C compiles insanely fast, is the fastest language there is, is very clear, is native to all systems, and is useful for all purposes.
 
-Some people, e.g., Bjarne Stroustrup, consider that C is “not good enough”, and make languages like C++ or D (or thousands of others)   
+Some people, e.g., Bjarne Stroustrup, consider that C is “not good enough,” and make languages like C++ or D (or thousands of others) 
 
 This is not necessary.
 
@@ -51,44 +42,42 @@ Some functions can be used as methods
 
 Makes for an excellent “scripting language” (which is really just native C without things making it slow)
 
-
-1      String     Interpolation “String interplation like this #{foo} ” Calls the join() function (talked about below to join strings,
-delim is a static global in each module called “sep”.
-Make sure you free() the string after. The string is stored in a static global variable called “last”.
+1 String Interpolation “String interplation like this #{foo} ” Calls the join() function (talked about below to join strings,
+delim is a static global in each module called “sep.”
+Make sure you free() the string after. The string is stored in a static global variable called “last.”
 So you could do puts(...); free(last)
 
-2      ew     *i.ew “Foo”, a.ew “bar” | char* ends with another char*?
+2 ew *i.ew “Foo,” a.ew “bar” | char* ends with another char*?
 
-3      sw     *i.sw “Foo”, a.sw “bar” | char* starts with another char*?
+3 sw *i.sw “Foo,” a.sw “bar” | char* starts with another char*?
 
-4      ==     Comparison of strs, “foo” == “bar”
+4 == Comparison of strs, “foo” == “bar”
 
-5      strip     Returns pointer to string that was stripped, in place
+5 strip Returns pointer to string that was stripped, in place
 
-6      chomp     void function, chomps end of string of spaces, i.chomp or chomp(i), in place
+6 chomp void function, chomps end of string of spaces, i.chomp or chomp(i), in place
 
-7      gsub     Just like ruby, there is a gsub function.
+7 gsub Just like ruby, there is a gsub function.
 The preprocessor detects if you use and adds -lpcre2-8 to the link flags if you use it. Use $" for substitutions in argument 3 gsub(a, b, c)
 
-8      join     Joins an array of strings, to split(), use C's strtok (very fast)
+8 join Joins an array of strings, to split(), use C's strtok (very fast)
 
-9      Lightweight     regexes are added, almost 15 times as fast as C's built in regex. They are very simple, they only have bracket expressions, like [a-z].
+9 Lightweight regexes are added, almost 15 times as fast as C's built in regex. They are very simple, they only have bracket expressions, like [a-z].
 
 To use it, you need to pass a buffer of the size of the expansion of the regex. Foo[a-fA-F] would be Foo[abcdefABCDEF]. That would be stored in a buffer.
 
 From testing, 15x times faster than C's regex POST COMPILATION, if compilation keeps happening, it might be hundreds of times faster. 
 Uses static inline functions, NO HEAP MEMORY unless you malloc before().
 
-10      print     Like old python print “Hello” (fputs);
+10 print Like old python print “Hello” (fputs);
 
-11      print_int     prints a number and returns the number, can be chained
+11 print_int prints a number and returns the number, can be chained
 
-12      each_line,     Perlish, different names, by_line(s) or each_line(s), iterate over all lines, free after
+12 each_line, Perlish, different names, by_line(s) or each_line(s), iterate over all lines, free after
 
-13      NOTE     You can use open_memstream() on UNIX to easily concatenate strings.
-
-14      MISC     features || autoinclude, foo.gsub or gsub(...),no need for paren (i.chomp, i.strlen), starts_with, ends_with, --wrap, itoa, freel (frees str, sets to NULL, and frees other recent stuff)
+13 NOTE You can use open_memstream() on UNIX to easily concatenate strings.
 
+14 MISC features || autoinclude, foo.gsub or gsub(...),no need for paren (i.chomp, i.strlen), starts_with, ends_with, --wrap, itoa, freel (frees str, sets to NULL, and frees other recent stuff)
 
 asprintf() is another useful function which is UNIX-centric. open_memstream() could be an alternative to std::string.
 It works very well with each_line or by_lines (see above)
@@ -96,43 +85,34 @@ These features seem simple, but they can make C programming much, MUCH easier
 
 for example (insignificant example)
 
-
-
 int main() {
-    stdin.each_line { |line|
-        print line;
-    }
+ stdin.each_line { |line|
+ print line;
+ }
 
-    free(line);
+ free(line);
 }
 
 You can iterate over the standard input like Ruby
 
-
 The thing with this is that it has 100% speed. The resultant preprocessed program becomes a normal C program
 
-
-
 The compile and run time for a program (if you use tcc and not gcc) can be about 24 milliseconds, which is faster than Ruby to run.
 
-
 Even though the program is preprocessed, re-preprocessed, compiled, assembled, linked, turned into an executable, and then run
 
-
 Kind of like early C++, this is a preprocessor for C.
 
 But it's much faster to compile than C++. Significantly so.
 
 Is anyone else interested in this? (BSD)
 
-
 I'm realising this under the BSD license. I'm interested if anyone else else likes this work, and would like to use it, or to work with me.
 
 Best regards,
 
 Gregory
 
-
 Current program is written in Crystal (crystal-lang.org) -- it was written in ruby, it could be ported to another language.
 
 I would like to make this self-hosting, but that would take a little bit of work.
@@ -141,14 +121,11 @@ About the Name
 
 Years ago, I really, really liked Compiz
 
-
 Compiz then forked into Beryl. There was the Emerald Window Manager, which was really nice and beautiful.
 
-
 I actually made another programming language. I made 2 other programming language. One was a full compiler and assembler, that ran code in memory. It was around 16 thousand lines of code. I made a programming language that had the syntax of Python or Ruby, but transpiled into C++. I called that C += 2. I used that other language, and I created a Web Browser in it based on Chrome. I called it “Emerald Browser.” Emeralds are beautiful green gems.
 
-
-    “Emerald is a gemstone and a variety of the mineral beryl colored green by trace amounts of chromium or sometimes vanadium. Beryl has a hardness of 7.5–8 on the Mohs scale. Most emeralds are highly included, so their toughness is classified as generally poor. Emerald is a cyclosilicate.”</i> --Wikipedia
+ “Emerald is a gemstone and a variety of the mineral beryl colored green by trace amounts of chromium or sometimes vanadium. Beryl has a hardness of 7.5–8 on the Mohs scale. Most emeralds are highly included, so their toughness is classified as generally poor. Emerald is a cyclosilicate.”</i> --Wikipedia
 
 There was a browser with a terminal built in to it.
 
@@ -158,13 +135,11 @@ QUESTIONS
 
 Why not use Rust?
 
-
 $ time rustc a.rs
 real	0m0.637s
 user	0m0.502s
 sys	0m0.160s
 
-
 Rust takes 0.637 seconds to compile an empty file!
 
 That is not ideal.

data/documentation/emoji

@@ -4,9 +4,6 @@ It can also speak the output
 
 It can also copy the output to your clipboard
 
-
-
 It is very useful
 
-
-![UCA](./images/6.png)
+![UCA](./images/6.png)

data/documentation/exp

@@ -6,4 +6,4 @@ exp is an exponentiation tool
 
 (echo 2; echo 10) | exp
 
-=>  1024
+=> 1024

data/documentation/find_housing

@@ -4,4 +4,4 @@ It is a nice, simple command line tool. You enter the minimum and maximum prices
 
 This tool kind of actually helped me to find housing in real life.
 
-The default city is "Ottawa". You can easily change this.
+The default city is “Ottawa.” You can easily change this.

data/documentation/floor

@@ -1 +1 @@
-Gets the floor of numbers e.g. 21.3 -> 21
+Gets the floor of numbers e.g. 21.3 -> 21

data/documentation/g+

@@ -6,6 +6,4 @@ Example
 
 g+ a.cpp -o out
 
-
-
-See also README file & emerald-browser and its source
+See also README file & emerald-browser and its source

data/documentation/google_speak

@@ -1,7 +1,7 @@
-Google speak is really useful. It speaks a statement using the Google Translate  voice, which is probably the most authoritative and high-quality text-to-speech voice that exists.
+Google speak is really useful. It speaks a statement using the Google Translate voice, which is probably the most authoritative and high-quality text-to-speech voice that exists.
 
 It's kind of like “espeak” or similar tools, but it is much better.
 
 You need an internet connection for it to work.
 
-It is probably limited at 100 characters.
+It is probably limited at 100 characters.

data/documentation/green

@@ -1 +0,0 @@
-

data/documentation/green_bold

@@ -1 +0,0 @@
-

data/documentation/green_bold_underline

@@ -1 +0,0 @@
-

data/documentation/green_underline

@@ -1 +0,0 @@
-

data/documentation/gsub

@@ -1,17 +1,13 @@
 Gsub is very powerful.
 
-
 Usage
 
-gsub [regular expression] [replacement text]             
-
+gsub [regular expression] [replacement text] 
 
 Example
 
-
 cat text | gsub man dog
 
-cat text | gsub 'man|boy|cat|dog'    food
-
+cat text | gsub 'man|boy|cat|dog' food
 
-ls | gsub Desktop cat
+ls | gsub Desktop cat

data/documentation/gsubip

@@ -24,4 +24,4 @@ It takes exactly 3 arguments, no more, no fewer.
 
 See also
 
-gsub
+gsub

data/documentation/last_nth

@@ -1 +1 @@
-Last nth gets the last n lines from the standard input
+Last nth gets the last n lines from the standard input

data/documentation/left_right.exe

@@ -1,14 +1,9 @@
-
-
 This is a tool to bring sanity to politics.
 
 ![UCA](./images/12.png)
 
-
-
 It gets viewpoints from the person that see the good in each political side, left, right, left, right, etc.
 
 It then presents all of that.
 
-Hopefully this can make people more sane and less hyper-partisan.
-
+Hopefully this can make people more sane and less hyper-partisan.

data/documentation/lines

@@ -1,5 +1,3 @@
 Lines gets the number of files in the current folder that you are in.
 
-
-It can also act like "wc -l" if you pipe data into it.
-
+It can also act like “wc -l” if you pipe data into it.

data/documentation/magenta

@@ -1 +0,0 @@
-

data/documentation/magenta_bold

@@ -1 +0,0 @@
-

data/documentation/magenta_bold_underline

@@ -1 +0,0 @@
-

data/documentation/magenta_underline

@@ -1 +0,0 @@
-

data/documentation/mul

@@ -1,5 +1,4 @@
-Multiply   numbers
-
+Multiply numbers
 
 echo 1 > file
 echo 2 >> file
@@ -9,5 +8,4 @@ echo 5 >> file
 
 cat file | mul
 
-
-=>   120
+=> 120

data/documentation/nth

@@ -1 +1 @@
-Nth gets the nth line from the input
+Nth gets the nth line from the input

data/documentation/open

@@ -1,50 +1,31 @@
 “open” is a very efficient program that searches a query from google, and then opens it in Emerald Browser.
 
-
-If you ever want something to “just open”, you can use it.
-
-
+If you ever want something to “just open,” you can use it.
 
 Example
 
 open “cats”
 
-
-
 An earlier version of open worked like this
 
-open [site1] [site2] [site3]    N
-
-
+open [site1] [site2] [site3] N
 
 site1, site2, and site3 would all be opened, and the top N queries were all shown in different panes
 
-
-
 An even earlier version of this program used Chrome to open the sites.
 
-
-
-
-
-                                          The current version can open one or more sites.
-
+ The current version can open one or more sites.
 
 Example
 
-
 open “cats” “dogs” “frogs”
 
-
 All of those queries would open in Emerald Browser.
 
 Just make sure it is compiled in multipane mode if you want to open multiple new sites at the same time.
 
-
 See also
 
-
-
 emerald-browser
 
-close
+close

data/documentation/prepend

@@ -1,25 +1,7 @@
-prepend prepends          input taken from the standard input to a file
+prepend prepends input taken from the standard input to a file
 
 Usage
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
 prepend [file]
 
-This is text to be prepended
+This is text to be prepended

data/documentation/processes

@@ -1,15 +1,11 @@
 Processes lists all processes with a certain name
 
-
 For example
 
-
 processes sh
 
 processes bash
 
-
 processes ruby
 
-
-processes gsub
+processes gsub

data/documentation/red

@@ -1 +0,0 @@
-

data/documentation/red_bold

@@ -1 +0,0 @@
-

data/documentation/red_bold_underline

@@ -1 +0,0 @@
-

data/documentation/red_underline

@@ -1 +0,0 @@
-

data/documentation/rgsub

@@ -8,7 +8,6 @@ Example
 
 rgsub my_email@site.com my_second_email@site.com
 
-
 Would replace an email recursively in a directory.
 
 It tries to skip non-text files and hidden files.
@@ -16,20 +15,16 @@ It tries to skip non-text files and hidden files.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 <pre><code>
-		Usage: rgsub <find> <replace> [optional list of files instead of recursive search]
-
-		If a file is "-" or stdin, read from stdin and output to stdout.
-		Options
-
-
-		    -r, rename files instead of replacing contents of files.
-		    	find and replace in file and dir names instead
-
+	Usage: rgsub <find> <replace> [optional list of files instead of recursive search]
 
-		    -v, verbose mode
+	If a file is “-” or stdin, read from stdin and output to stdout.
+	Options
 
+	-r, rename files instead of replacing contents of files.
+	find and replace in file and dir names instead
 
-		    -- Indicate end of options.
+	-v, verbose mode
 
-</pre></code>
+	-- Indicate end of options.
 
+</pre></code>

data/documentation/rhyme

@@ -1,12 +1,9 @@
-
-
 A very powerful music generator program that doesn't use AI.
 
 <a href="https://www.youtube.com/@LawrenceStevensMusic">See this channel as an example of potential usage of this public domain content</a>
 
 https://www.youtube.com/@LawrenceStevensMusic
 
-
 The music industry is plagued with very foundational problems.
 
 For starters, the quality of the discourse in music is very low, and has been from the start of the popularization of modern music, as well as during the era in which classical music was popular and before.
@@ -17,13 +14,12 @@ One of the greatest problems in the current world is the mainstream scientific e
 
 To indicate what is already obvious, it exists in the context of a legacy of <em>authoritarianism</em> and a <em>lack of understanding of dynamism.</em>
 
-It is not dynamic or forceful, the "results" of it don't change the foundation of society. True free discourse is not supported, especially in regards to the human mind and human well-being and human freedom.
+It is not dynamic or forceful, the “results” of it don't change the foundation of society. True free discourse is not supported, especially in regards to the human mind and human well-being and human freedom.
 
 These problems should be opposed and fought, it is self-evident that this would be the best use of ones time, for it would lead to true freedom.
 
 One excellent way to combat this would be to use the generated songs generated by a computer program called Rhyme, available at <a href='https://www.github.com/gregoryc/democracy'>https://www.github.com/gregoryc/democracy</a> in the SONGS folder.
 
-
 These are public domain songs generated by non-Artificial Intelligence, just a program
 that introduces variance, and these hit-home against the status quo and the current
 state of the mainstream scientific establishment. Taking these songs and making actual
@@ -38,19 +34,16 @@ Accountability must always be brought about.
 
 Is music good and desired? For sure.
 
-
 USAGE OF PROGRAM
 
 Enter basename to make songs folder in (folder/songs, num songs = 13000)
 
-Usage rhyme [folder] (processes files "1.json" and "21.json" by default)
+Usage rhyme [folder] (processes files “1.json” and “21.json” by default)
 
 Example output of a song
 
-
 ![UCA](./images/7.png)
 
-
 (NO COPYRIGHT RESTRICTIONS ON THIS CONTENT WHATSOEVER. FULLY PUBLIC DOMAIN)
 Name the song or poem as you wish, resell it, but please positively influence culture
 
@@ -168,7 +161,7 @@ They don't have decency, they automatically disregard
 They're a complete failure, they only neglect
 They don't speak the language of the people or their dialect
 This is not right, this is completely incorrect
-The only focus on “responses”, they just want to deflect
+The only focus on “responses,” they just want to deflect
 The lies are put forth, the lies they erect
 
 CHORUS
@@ -214,4 +207,4 @@ Any progress is fleeting with them, they revert
 Disingenuous to the extreme, the society they subvert
 The society is the ones who hurt
 
----
+---

data/documentation/rip

@@ -2,7 +2,6 @@ Replace In Place
 
 rip tool replaces a string, not a regular expression, with another string
 
-
 Example
 
-rip        cat dog       file
+rip cat dog file

data/documentation/rnip

@@ -4,7 +4,7 @@ This is like gsub, but for strings, not for regular expressions
 
 Example
 
-echo ..........   | rnip foo bar
+echo .......... | rnip foo bar
 
 See also
 

data/documentation/selectlines

@@ -1,17 +1,11 @@
 selectlines shows all nonblank lines from the input
 
-
 Example
 
-
 cat file | selectlines
 
-
-
 (echo 2; echo; echo; echo) | selectlines
 
-
 => 2
 
-
-The result would be 2, with no blank lines after that
+The result would be 2, with no blank lines after that

data/documentation/speakcat

@@ -1,7 +1,7 @@
-Speak cat is a tool like “cat”, which shows the content of files (technically, it combines the content of files).
+Speak cat is a tool like “cat,” which shows the content of files (technically, it combines the content of files).
 
 But speak cat also speaks the text.
 
 Which could be useful in some circumstances.
 
-It's kind of like “tee” to your ear.
+It's kind of like “tee” to your ear.

data/documentation/squeeze

@@ -10,5 +10,4 @@ squeeze 5 3
 
 This would omit the first 5 lines and the last 3 lines
 
-
 squeeze 2 2 [file] also works, it outputs text to file

data/documentation/sub

@@ -18,9 +18,8 @@ Result =>
 
 Example
 
-  (echo  5; echo 2) | sub
+ (echo 5; echo 2) | sub
 
 Result =>
 
-
-3
+3

data/documentation/swap

@@ -1,7 +1,5 @@
 Swaps two files
 
-
 Example
 
-
 swap text1 text2