14 | Table of contents15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | |
35 |
36 | Author: Randy Maxwell 37 | |
forGL welcomes You!
17 | 18 | 24 | 25 | 36 | 37 | 41 | 42 | 46 | 47 | 48 | 49 | 50 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug report 3 | about: Create a report to help us improve forGL 4 | title: "[Defect] Problem with " 5 | labels: '' 6 | assignees: RMax2015 7 | 8 | --- 9 | 10 | **Describe the bug** 11 | A clear and concise description of what the bug is. 12 | 13 | **Did you try to find more information in the Docs directory or elsewhere ?** 14 | If not, then please help the forGL Team to help you! 15 | 16 | Part of **learning how to do computer programming is:** 17 | **looking through information already provided to save you some time and effort.** 18 | 19 | forGL project tries to make learning computer programming as rewarding as possible for you. 20 | 21 | You also should try to learn good habits when programming. 22 | **Strong Suggestion: Please read from the Docs directory and other places.** 23 | This will help you going forward. 24 | 25 | **Did you find any information you thought was related to the bug ?** 26 | If so, please suggest how the information may be improved. 27 | 28 | **Did you try to do other steps to work around the bug ?** 29 | Please describe what other steps you tried. 30 | 31 | If you did not try other steps: 32 | forGL Team is always looking for ways to improve forGL and your help is needed. 33 | Please let us know a little about why you did not try other ways. 34 | 35 | **To Reproduce** 36 | Steps to reproduce the behavior: 37 | 1. Go to '...' 38 | 2. Click on '....' 39 | 3. Scroll down to '....' 40 | 4. See error 41 | 42 | **Expected behavior** 43 | A clear and concise description of what you expected to happen. 44 | 45 | **Screenshots** 46 | If applicable, add screenshots to help explain your problem. 47 | You do not need to do a screenshot if the forGL text describes the problem, so you should have included the forGL text above when you described the problem (bug). 48 | 49 | **Desktop (please complete the following information):** 50 | - OS: [e.g. iOS] 51 | - Browser [e.g. chrome, safari] 52 | - Version [e.g. 22] 53 | 54 | **Smartphone (please complete the following information):** 55 | - Device: [e.g. iPhone6] 56 | - OS: [e.g. iOS8.1] 57 | - Browser [e.g. stock browser, safari] 58 | - Version [e.g. 22] 59 | 60 | **Additional context** 61 | Add any other context about the problem here. 62 | -------------------------------------------------------------------------------- /Docs/Maintainers/Software_Karaoke__forGL__Question.txt: -------------------------------------------------------------------------------- 1 | forGL ... Software Karaoke ? ! . 2 | 3 | A forGL musical answer to the question: Why even use forGL? 4 | 5 | This is a light hearted attempt at some humor using Karaoke, 6 | with some changes to help give insights about 4GL and computer programming. 7 | 8 | 9 | Why Can't This Be Code ? 10 | 11 | Music and (mostly) Original Lyrics (as scrolling text) 12 | https://www.youtube.com/watch?v=YH1ilVfhjbU 13 | 14 | Below is suggested lyrics to sing when viewing above video. 15 | Have Fun ! 16 | 17 | All the underlined text below was a substitute for original song lyrics. 18 | 19 | 20 | Oh here it comes 21 | That funny feeling again winding me up inside 22 | Every time we touch 23 | Hey I don't know 24 | Oh, tell me where to begin cause I never ever 25 | Saw so much 26 | --- 27 | And I can't recall any code at all 28 | ---- 29 | 30 | Baby this shows another way. 31 | ----------------- 32 | 33 | It's got what it takes 34 | So tell me why can't this be code? 35 | ---- 36 | Straight from my mind 37 | ---- 38 | 39 | Oh, tell me why can't this be code? 40 | ---- 41 | I tell myself 42 | Hey not just fools rush in and only time will tell 43 | -------- 44 | If we stand the test of time 45 | All I know 46 | You've got to run code to win and so this can 47 | ---- ----------- 48 | be much more than just fine. 49 | --------------------------- 50 | 51 | Hey 52 | No I can't recall any code at all 53 | ---- 54 | Oh baby this shows another way. 55 | ----------------- 56 | Woo 57 | It's got what it takes 58 | So tell me why can't this be code? 59 | ---- 60 | You want it straight from my mind 61 | ------- 62 | 63 | Oh tell me why can't this be code? 64 | ---- 65 | It's got what it takes 66 | So tell me why can't this be code? 67 | ---- 68 | Straight from my mind 69 | ---- 70 | 71 | Oh, tell me why can't this be code? 72 | ---- 73 | Baby why can't this be code? 74 | ---- 75 | Got to know why can't this be code? 76 | ---- 77 | I wanna know why can't this be code? 78 | ---- 79 | 80 | Original Song ... Why Can't This Be Love by Van Halen 81 | Songwriters: Alex Van Halen / Edward Van Halen / Sammy Hagar / Michael Anthony 82 | Why Can't This Be Love lyrics © Warner/Chappell Music, Inc -------------------------------------------------------------------------------- /Docs/Maintainers/References_Programming Languages & Browsers.txt: -------------------------------------------------------------------------------- 1 | References_Programming Languages & Browsers 2 | 3 | 4 | Data & Design 5 | Fusing data and design to supercharge innovation—in products and processes 6 | 7 | architect Eliel Saarinen’s advice to 8 | “always design a thing by considering it in its next larger context— 9 | a chair in a room, a room in a house, a house in an environment, an environment in a city plan” 10 | 11 | https://www.mckinsey.com/business-functions/mckinsey-analytics/our-insights/fusing-data-and-design-to-supercharge-innovation-in-products-and-processes?utm_medium=email&utm_source=topic+optin&utm_campaign=awareness&utm_content=20190424+data+nl&mkt_tok=eyJpIjoiWVRKbFlqaGhOV0l3WXpGaCIsInQiOiJVUU1ROVwvTld2RHU0Y3I1K2VxbDZhOWxobWx2QktMVWpsYU41ajBrc0xvakhNa2Vnc2JqZ2g5dXU5TjJIdllHR1ZPM2UxOWtNYitTZ2F3QUVXbXJvOXRsOFNhQndrdklhN1pZdWx4NEFxcE1pM3lcL1c3c0NBQ3Jydzh5c0lnMEsrIn0%3D 12 | 13 | 14 | Programming Languages & Browsers 15 | ============================================================================== 16 | 17 | Browsers: Lin Clark (Code Cartoonist and Mozilla developer) 18 | The future of Web Browsers is Parallel. 19 | Coarse Grained Parallelism, Fine Grained Parallelism, 20 | Faster App code using: Web Workers, Better JavaScript engines, WebAssembly 21 | Rust as implementation language merged into newer FireFox browsers. 22 | https://www.youtube.com/watch?v=xCBWS8G5Cm0&ab_channel=JSKongress 23 | 24 | 25 | Anders Hejlsberg 26 | talks about programming and compilers ... 27 | Algol -> Pascal subset -> Pascal -> Marketed as Turbo Pascal -> Visual J++ 6.0 -> .Net and C# -> TypeScript 28 | "... don't accept the dogma." 29 | Keep an open mind. 30 | ~13 minutes 31 | https://www.youtube.com/watch?v=tmOmFfcA9us 32 | 33 | 34 | Anders Hejlsberg 35 | on Modern Compiler Construction 36 | 37 | "...using Functional programming ideas within modern compilers..." 38 | 39 | https://www.youtube.com/watch?v=wSdV1M7n4gQ 40 | 41 | 42 | Guido van Rossum: BDFL Python 3 retrospective 43 | 44 | 45 | 46 | https://www.youtube.com/watch?v=Oiw23yfqQy8 47 | 48 | 49 | Go language Authors Panel 50 | 51 | Go can compile to WebAssembly 52 | 53 | Goals: 54 | Concurrency easy to do 55 | Compactness 56 | Readability and Ease of Understanding 57 | Designed for Programming in the Large 58 | 59 | Problems: 60 | Int is 32 or 64 bits. 61 | Should have had explicit Int32 and Int64 62 | 63 | Context feature 64 | 65 | https://www.youtube.com/watch?v=3yghHvvZQmA&feature=youtu.be&utm_medium=email&utm_source=topic+optin&utm_campaign=awareness&utm_content=20190420+prog+nl&mkt_tok=eyJpIjoiTUdRNFlqSm1aRFEzWTJJMyIsInQiOiJ1anlZT3hpTkVWMnA4XC9GMWg4MndURmQwUktKOEtaOFlvMk4zRjNmRXRSRHZMU3pJN1FYZjY3R1lpaWwwTUs0bTUzNWxzSXZxXC9yZ3RkUWRxVVROZzVJTHpET0JTK3hTT0RyN0N4NU9PYkprRXVCTnQwWGZuUnBYSXY1enZTMEFOIn0%3D 66 | 67 | 68 | 69 | Anders Hejlsberg 70 | 71 | FiveThings Why TypeScript is for You 72 | 73 | Useful if you are now doing JavaScript or want to do JavaScript 74 | 75 | 1) Static Types 76 | Types are good to find Errors Statically instead of at Run time. 77 | Refactoring 78 | 79 | 2) 80 | can down level back to older versions of JavaScript 81 | 82 | TypeScript written in JavaScript ! ! ! 83 | (Huge advantage over Haxe) 84 | 85 | 86 | 4) What about if you want to stop using TypeScript ? 87 | 88 | Comments in TypeScript compiled to JavaScript (and style is preserved) 89 | 90 | 5) 91 | 92 | https://www.youtube.com/watch?v=wYgSiFaYSSo 93 | 94 | -------------------------------------------------------------------------------- /CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Covenant Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | In the interest of fostering an open and welcoming environment, we as 6 | contributors and maintainers pledge to making participation in our project and 7 | our community a harassment-free experience for everyone, regardless of age, body 8 | size, disability, ethnicity, sex characteristics, gender identity and expression, 9 | level of experience, education, socio-economic status, nationality, personal 10 | appearance, race, religion, or sexual identity and orientation. 11 | 12 | ## Our Standards 13 | 14 | Examples of behavior that contributes to creating a positive environment 15 | include: 16 | 17 | * Using welcoming and inclusive language 18 | * Being respectful of differing viewpoints and experiences 19 | * Gracefully accepting constructive criticism 20 | * Focusing on what is best for the community 21 | * Showing empathy towards other community members 22 | 23 | Examples of unacceptable behavior by participants include: 24 | 25 | * The use of sexualized language or imagery and unwelcome sexual attention or 26 | advances 27 | * Trolling, insulting/derogatory comments, and personal or political attacks 28 | * Public or private harassment 29 | * Publishing others' private information, such as a physical or electronic 30 | address, without explicit permission 31 | * Other conduct which could reasonably be considered inappropriate in a 32 | professional setting 33 | 34 | ## Our Responsibilities 35 | 36 | Project maintainers are responsible for clarifying the standards of acceptable 37 | behavior and are expected to take appropriate and fair corrective action in 38 | response to any instances of unacceptable behavior. 39 | 40 | Project maintainers have the right and responsibility to remove, edit, or 41 | reject comments, commits, code, wiki edits, issues, and other contributions 42 | that are not aligned to this Code of Conduct, or to ban temporarily or 43 | permanently any contributor for other behaviors that they deem inappropriate, 44 | threatening, offensive, or harmful. 45 | 46 | ## Scope 47 | 48 | This Code of Conduct applies both within project spaces and in public spaces 49 | when an individual is representing the project or its community. Examples of 50 | representing a project or community include using an official project e-mail 51 | address, posting via an official social media account, or acting as an appointed 52 | representative at an online or offline event. Representation of a project may be 53 | further defined and clarified by project maintainers. 54 | 55 | ## Enforcement 56 | 57 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 58 | reported by contacting the project team at RMax2015@github.com. All 59 | complaints will be reviewed and investigated and will result in a response that 60 | is deemed necessary and appropriate to the circumstances. The project team is 61 | obligated to maintain confidentiality with regard to the reporter of an incident. 62 | Further details of specific enforcement policies may be posted separately. 63 | 64 | Project maintainers who do not follow or enforce the Code of Conduct in good 65 | faith may face temporary or permanent repercussions as determined by other 66 | members of the project's leadership. 67 | 68 | ## Attribution 69 | 70 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, 71 | available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 72 | 73 | [homepage]: https://www.contributor-covenant.org 74 | 75 | For answers to common questions about this code of conduct, see 76 | https://www.contributor-covenant.org/faq 77 | -------------------------------------------------------------------------------- /Docs/Maintainers/Haxe Multi Target Language Page.txt: -------------------------------------------------------------------------------- 1 | Email Suggest Haxe Multi Target Language Page Be Created 2 | 3 | I have a Use Case in mind: 4 | 5 | forGL is going to introduce A LOT of new programmers (perhaps with little 6 | prior experience) to Haxe. 7 | Also I expect that a significant fraction (over 50%) may have little or no 8 | command of English. 9 | 10 | For my part, I will put in place documents, tips, FAQs, translated messages 11 | in the code, and so on to help support those new programmers. I will be 12 | relying on the Open Source community spirit of sharing that will prompt 13 | others with skills about various languages to help with translations. 14 | 15 | I will also in the forGL side of docs do my best to help programmers with a 16 | fairly wide range of experience to use the somewhat unique capabilities of 17 | forGL as best as they may. 18 | 19 | I do not automatically favor choosing simplicity over a better description 20 | that includes high level ideas as well as low level details. And the forGL 21 | doc set will apply this use of multiple view points as well. 22 | 23 | *But here we are trying to improve the experience of programmers using Haxe 24 | from a wide variety of levels of backgrounds. They may be very experienced 25 | in a few of the target languages but have little experience with working 26 | with multiple languages at once. From a past interview with Amazon I know 27 | that they are very heavily (almost exclusively) into Java for example 28 | (around 2011).* 29 | 30 | In the past the most useful programs that I have found were those that gave 31 | the User a choice about what level of detail to work with. Ex: there would 32 | be a menu item that would show all menu items to approach all details or 33 | just the most commonly used menu items. Now it seems for quite a few 34 | programmings IDEs to allow the User/Programmer to customize what even gets 35 | shown (which I and many others appreciate). 36 | 37 | So the principle is: 38 | Having intelligent *Choices *is a GOOD THING. 39 | 40 | *A simple example is good.* 41 | 42 | *Also a somewhat realistic example of medium to complicated where 43 | intelligent choices were made to handle the extra complexity I believe even 44 | better.* 45 | 46 | So my strong suggestion is to have a short explanation about both the 47 | simple and the more involved examples. 48 | 49 | *Another factor to keep in mind is that these language setup pages need to 50 | treat unique aspects of Haxe programming well.* So either having both 51 | simple examples *and *more involved 52 | OR 53 | *Creating another page specifically to address tips about managing a Haxe 54 | project that uses multiple target languages would be the right thing for 55 | even very experienced programmers as well as those just learning.* 56 | 57 | 58 | If you decide to create a page about considerations of Haxe projects with 59 | multiple target languages, I would strongly suggest to not just limit to 60 | talking about examples of more complicated directories but rather talk 61 | about trade offs like: 62 | Which IDEs Editors support both editing Haxe AND the target language(s) 63 | Which IDEs Debuggers support Debugging in a target language that also has a 64 | source view of original Haxe while Debugging 65 | 66 | and so on. I am sure you can add a lot more to this list. 67 | 68 | I think if there is a new page created to help guide choices of Haxe and 69 | multiple target languages, going through (at least with links or SOME 70 | bullet points) of the various activities of a full SDLC would also help to 71 | bring important high level ideas that Haxe uniquely provides as a 72 | constructive background. 73 | 74 | Sorry I can't provide more help now but my "Hobby" is beginning to take up 75 | more of my time. 76 | Hope this helps! 77 | Randy Maxwell -------------------------------------------------------------------------------- /_forGL_Getting_Started_READ_ME_NOW.txt: -------------------------------------------------------------------------------- 1 | forGL Getting Started 2 | 3 | April 2020 4 | 5 | Please consider these directories 6 | Applications 7 | Dictionaries 8 | Docs 9 | 10 | If you want to USE forGL: 11 | ======================== 12 | 13 | Please: 14 | Create a new directory (folder). 15 | 16 | Copy at least 1 file from the Dictionaries directory (folder). 17 | 18 | Go to the Applications directory and READ the READ_ME.txt file. 19 | 20 | Copy the forGL application you selected to the new directory. 21 | 22 | Copy from the Dictionaries directory. 23 | 24 | Create a simple Windows .bat file or a shell script file. 25 | 26 | You can also run forGL from the command line without a .bat or script. 27 | 28 | 29 | 30 | If you want to BUILD and run forGL: 31 | ================================== 32 | 33 | Please consider trying out the USE section above first. 34 | 35 | forGL is mostly Haxe sources. 36 | Now building as a Command Line Interface text style application. 37 | Later this year as native GUI apps. 38 | Hopefully soon as mostly working Browser app (instead of poorly working now). 39 | 40 | Build 41 | ----- 42 | directory has sample Windows .bat files I use to: 43 | Run Haxe transpiler to build all or 1 at a time. 44 | Run 5 different generated programming languages, all or 1 at a time. 45 | 46 | forGL Builds with Haxe 4.0 and up Releases 47 | forGL was built with Haxe 3.4.x and 4.0 up to 4.0 rc2 48 | 49 | forGL currently uses Haxe to generate: 50 | C++, C#, Java, Python and JavaScript (a Browser Web Worker) 51 | 52 | I also generate CppIA but am not testing with it yet. 53 | 54 | 1) Choose a Haxe Toolkit version and Install Haxe compiler + tools 55 | or you can choose a nightly 4.0 build from Haxe github site. 56 | 57 | See: 58 | https://haxe.org 59 | and 60 | https://community.haxe.org 61 | 62 | 2) Choose and Install language support: 63 | You do NOT have to install all of these. 64 | You can choose practically any 1 of these 65 | for Haxe to generate and then you can run. 66 | 67 | C++, hxcpp (includes CppIA) 68 | C#, hxcs 69 | Java hxjava 70 | 71 | There are pages on the Haxe site to help you start with the above languages. 72 | 73 | Python and JavaScript support are included as part of Haxe Toolkit. 74 | 75 | I installed all of the above on my Windows laptops. 76 | The reasons are: 77 | C++ for performance and cross platform 78 | C# for Windows centric (also easy to Debug on my old laptop) 79 | Java for cross platform OK performance 80 | Python for cross platform 81 | JavaScript for Browser app 82 | 83 | 3) Install haxe-strings library 84 | This provides better UTF8 support (especially if building with Haxe 3.4) 85 | and ANSI Escape sequences to do text Colors and Cursor moves. 86 | 87 | Python 88 | ------ 89 | After Python is built open in an editor of your choice. 90 | I use Notepad++ on Windows. 91 | 92 | Searh & Replace 93 | __python__(" 94 | 95 | with nothing. 96 | 97 | The the Python code can be run. 98 | This fixes a minor defect in how Haxe generates Python comments 99 | in a macro from the Comments.hx file. 100 | 101 | 102 | Comments ! ! ! 103 | forGL uses a Comments.hx source file that embeds Comments in Haxe generated sources. 104 | Having Comments has helped me a lot finding my way around when Debugging forGL. 105 | 106 | Comments ALSO are KEY to enabling anyone using forGL to better understand 107 | their own code (Verbs) when Exported to Haxe and then transpiled to whatever. 108 | 109 | If you are running on Windows (like I do) 110 | please see the Read ME files in the Applications directory (ansicon.exe and chcp 65001). 111 | 112 | Thanks to Haxe Community Forum members and Haxe Team ! 113 | 114 | Hope this helps. 115 | Thanks for your support! 116 | Randy Maxwell 117 | -------------------------------------------------------------------------------- /Docs/Maintainers/Syntax Ideas and Programming Paradigms.txt: -------------------------------------------------------------------------------- 1 | Syntax Ideas and Programming Paradigms 2 | 3 | NOW April 2019 4 | 5 | forGL NOW (April 2019) has 6 | fairly good working Concatenative 7 | & very limited Imperative choice & Declarative syntax / notation. 8 | 9 | Concatenative 10 | ============= 11 | forGL allows a wide variety of combinations of the parts of a statement: 12 | Nouns Name of and Value given to: a person, place or thing 13 | Verbs Choose the terms you want to describe either the Problem or Solution or both 14 | Operators Imperative in effect, some help with not being too close to HW 15 | Verbs that are Built In Declarative ... sat WHAT you want and it will be done 16 | Punctuation some way to see that there is an end of a statement 17 | 18 | Imperative Notation 19 | =================== 20 | These are ideas that express HOW to do something. 21 | Math operators 22 | 23 | Math functions 24 | You can point out that Math functions are Declarative typically. 25 | 26 | Choice based on a Bool comparison. true or false 27 | If true a reading (and execution) path through the Verb is chosen. 28 | If false the reading path for the true comparison is skipped over. 29 | 30 | 31 | Examples: 32 | 33 | 34 | 35 | 36 | 37 | 38 | Declarative Notation NOW April 2019 39 | ==================== 40 | 41 | WHAT you want and it will be done 42 | 43 | Show a Value from the Data stack is displayed in the User Interface 44 | 45 | Repeat will use a Data stack value as a beginning Repeat Count to do. 46 | Repeat Count value should be a positive Integer (1 or more). 47 | 48 | 49 | Error Handling 50 | ============== 51 | 52 | If show has no value then this is a Problem: 53 | 1) This is a logical error in the Verb OR a Verb that ran before this Verb. 54 | Display the fact that no Data value is available and stop. 55 | 56 | OR 57 | 2) This is a logical error in the Verb OR a Verb that ran before this Verb. 58 | Instead add an entry to the Run log and run the next word. 59 | 60 | OR 61 | 3) This is a logical error in the Verb OR a Verb that ran before this Verb. 62 | Do nothing about Problem that show has and run the next word. 63 | 64 | 1) is done now 65 | 2) needs Logging to be implemented and then you allow Logging 66 | 3) is the most dangerous because the Problem is ignored (see Defects NOTE) 67 | 68 | Reapeat has similar Error Handling needs 69 | 70 | 71 | 72 | forGL Defects NOTE 73 | ================== 74 | Because forGL is a prototype with various Defects that are Known 75 | and other Defects not found yet: 76 | The forGL application will make statements 77 | about what seems to be likely reasons for a Problem. 78 | 79 | forGL may actually have an Internal Defect that caused the Problem such as: 80 | Not doing an Assignment to the correct Noun. 81 | Not creating a Data value correctly. 82 | Not putting a Data value on the Data stack correctly. 83 | 84 | The above Defects have been fixed in some combinations that were tested but: 85 | MUCH more testing is needed. 86 | Need Automated tests to detect old fixed Defects that happen again. 87 | 88 | 89 | 90 | Procedure Call Notation SOON April to May 2019 91 | ======================= 92 | 93 | It is important you understand Procedure calls and their very wide use in programming languages. 94 | Working examples of Procedure calls from your selected forGL Verb(s) are part of Export As Code. 95 | 96 | Instead of the Concatenative notation that forGL supports 97 | you may use a style that MANY programming languages use. 98 | 99 | concatenative: 100 | "Hello there!" show. 101 | 102 | procedure call: 103 | show( "Hello there!" ). 104 | 105 | concatenative: 106 | 45 radians sin into x. x show. 107 | or even 108 | 45 radians sin show. 109 | 110 | sin called like a procedure but the argument within ( ) is concatenative: 111 | sin(45 radians) into x. x show. 112 | 113 | all procedural and have Assignment in Math style that most programming languages use. 114 | x = sin(radians(45)). show(x). 115 | or even 116 | show(sin(radians(45))). 117 | 118 | 119 | 120 | SOON April to May 2019 121 | forGL will support 0 or 1 Procedure arguments. 122 | 123 | examples: 124 | show( 7 ). 125 | 126 | show(). The Data value that show( ) needs is not given as an argument. 127 | This is likely an error when typing this statement. 128 | Error Handling as given above for show. 129 | Also 130 | Because the Procedural is in addition to the Concatenative style: 131 | If statement was like: 132 | 7 show(). 133 | It could be changed to: 134 | show(7). That is correct and as intended by the Verb definition. 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | Declarative Notation SOON April to May 2019 145 | ==================== 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | -------------------------------------------------------------------------------- /Docs/Maintainers/forGL_References.txt: -------------------------------------------------------------------------------- 1 | forGL_References 2 | 3 | April 2019 4 | 5 | REALLY IMPORTANT forGL IDEAS 6 | ============================ 7 | forGL is an application and not a programming language. 8 | 9 | forGL does: 10 | allow you to try out a simplified Natural Language of your choice to program a computer ... 11 | allow you to learn a few ideas about computer programming ... 12 | allow you to Export As Code the simplified Natural Language Verbs and Nouns 13 | to various computer programming languages to enable more learning... 14 | 15 | forGL does not: 16 | try to get you to adopt a "purest" viewpoint about programming language theory ... 17 | try to encourage or even force you to do something the "forGL way". There is no "forGL way" ... 18 | 19 | forGL uses ideas from Natural Language and various programming languages 20 | and a few small contributions of my own. 21 | 22 | If you are worried about Slow forGL Performance: 23 | forGL application provides an Interpreter, a User Interface, and (on some platforms) file input / output. 24 | forGL Interpreter is designed to support very flexible combinations of Verbs, Operators, Nouns. 25 | The flexible combinations (syntax) are to support the simplified Natural Languages of the world. 26 | forGL Interpreter uses Data, Operator and Noun stacks (and some others). 27 | Because of the stack based Interpreter, forGL is not as fast as other approaches. 28 | Because of the ability for you to Export As Code your forGL Verbs: 29 | other programming languages may be used to run the same logic you defined. 30 | These other programming languages have many years of effort to not give up performance. 31 | 32 | 33 | Limitation: No Network programming. 34 | If you want to do programming using Networks: 35 | forGL does not directly support you programming using various Networking APIs. 36 | This is a forGL Design Choice. 37 | The reason is that using Networking APIs can lead to subjects and problems 38 | that are much more advanced than working with programming a single computer platform. 39 | 40 | Limitation: No File system programming. 41 | If you want to do programming using the File system of a platform: 42 | forGL does not directly support you programming using various File system APIs. 43 | This is a forGL Design Choice. 44 | The reason is that using File system APIs can be used to do destructive actions on the platform 45 | even when the intention of the code is not to be destructive. 46 | 47 | THE ABOVE LIMITATIONS are chosen to help avoid several problems in the areas of forGL Security and Safety. 48 | 49 | 50 | 51 | Here is a list of some References that guided my thinking. 52 | 53 | Really Important Ideas 54 | ====================== 55 | 56 | If you don't read anything else please consider these: 57 | 58 | Gödel's Theorem (Kurt Gödel) 59 | ----------------------------- 60 | Proved for Mathematics systems using Symbolic Logic. 61 | 62 | My paraphrase: 63 | You can't learn everything about a system from within that system. 64 | You need to go outside the system to learn more. 65 | 66 | My Assertion: 67 | Gödel's Theorem applies to much more than just Mathematics. 68 | 69 | 70 | Thinking by Contract 71 | -------------------- 72 | Extending Design by Contract idea to other activities. 73 | 74 | also see 75 | Thinking_by_Contract.doc 76 | 77 | So I applied Thinking by Contract and Gödel's Theorem ideas together on forGL. 78 | 79 | I had some previous experience with about a dozen programming languages. 80 | I wanted to enable people to do computer programming like my experience at 81 | Amber Software / Cyware. 82 | 83 | Practically all of the most used programming languages 84 | require (as a Pre Condition) some knowledge of English. 85 | 86 | I wanted to remove English as a requirement (Pre Condition) 87 | for learning computer programming, 88 | as Amber allowed European languages to be used. 89 | 90 | 91 | 92 | 93 | Programming Languages 94 | ===================== 95 | 96 | Programming language creators talk: 97 | Guido van Rossum (Python) 98 | James Gosling (Java) 99 | Anders Hejlsberg (TurboPascal, Delphi, C#, TypeScript) 100 | Larry Wall (a Linguist. Perl, Perl6) 101 | Carol Willy (Moderator, Jupyter, Jupyter notebooks) 102 | https://www.youtube.com/watch?v=csL8DLXGNlU&t=48m30s&utm_medium=email&utm_source=topic+optin&utm_campaign=awareness&utm_content=20190406+prog+nl&mkt_tok=eyJpIjoiTVRJMVpUWXdNbUUxT1dRMSIsInQiOiJWUmJqNVoyNzhmUWNNMlVHb1FSNHdYejJKUFU0MytrTVwvN3B1YUtXU0MwUXBUdExoeUtBUElVb2pUZGFoaHg1Ym1cL1VOV0ZHTjRWREZoYmZGTmhDcWk2cUZnelcyTEFvUUFiOE5lVVMwT3pSV0hORHhGd21NbVRubFNydE5IdWxLIn0%3D 103 | 104 | 105 | 106 | 107 | Repository Related 108 | ================== 109 | 110 | Guidelines to providers and users of public Software Repositories 111 | https://softwareengineeringdaily.com/2019/04/04/project-health-assessing-open-source-projects-with-more-context/ 112 | 113 | 114 | 115 | 116 | Hope this helps! 117 | Randy Maxwell -------------------------------------------------------------------------------- /src/forGL/js/forGL_Load_Run.js: -------------------------------------------------------------------------------- 1 | /** forGL_Load_Run.js This runs in Browser to support forGL with a HTML GUI 2 | * 3 | * @author Randy Maxwell 4 | */ 5 | 6 | (function() { 7 | 8 | var is_running = false; 9 | 10 | var oscpu = window.navigator.oscpu; 11 | // console.log( "oscpu :" + oscpu ); 12 | 13 | var verbose_console_log = true; 14 | 15 | // Set up to use various UI pieces 16 | var dict_name_element = document.getElementById( "dictionaryNameId" ); 17 | var dict_text_element = document.getElementById( "dictionaryTextId" ); 18 | 19 | var status_text_element = document.getElementById( "statusId" ); 20 | 21 | var run_stop_button = document.getElementById( "runButtonId" ); 22 | var user_verb_element = document.getElementById( "userVerbId" ); 23 | 24 | var verb_colored_element = document.getElementById( "verbColoredTokensId" ); 25 | 26 | var data_stack_element = document.getElementById( "dataStackId" ); 27 | var op_stack_element = document.getElementById( "opStackId" ); 28 | var noun_stack_element = document.getElementById( "nounStackId" ); 29 | 30 | var verb_output_element = document.getElementById( "verbOutputId" ); 31 | 32 | var messages_element = document.getElementById( "messagesId" ); 33 | 34 | var forGL_Worker = document.HTMLElement; 35 | 36 | // Create a Web Worker (separate thread from Browser) 37 | var using_web_worker = false; 38 | if ( window.Worker ) 39 | { 40 | forGL_Worker = new Worker( 'forGL_WebWorker.js' ); 41 | using_web_worker = true; 42 | alert( "using_web_worker !" ); 43 | } 44 | else 45 | { 46 | // Change this to load forGL as JavaScript (but not a Web Worker) 47 | // 48 | 49 | var msg = 'INTERNAL ERROR: No Web Worker from Browser available. Need to refactor forGL. Stopping.'; 50 | status_text_element.textContent = msg; 51 | console.log( msg ); 52 | alert( msg ); 53 | document.close(); 54 | return; 55 | } 56 | 57 | if ( verbose_console_log ) 58 | { 59 | // Set the Check Box 60 | 61 | 62 | } 63 | 64 | var sendRequest = function( request_str, data_str ) 65 | { 66 | if ( using_web_worker ) 67 | { 68 | // Send Request and other Data as Array of 2 Strings 69 | forGL_Worker.postMessage( [ request_str, data_str ] ); 70 | } 71 | else 72 | { 73 | // Put the Request into the queue 74 | 75 | } 76 | 77 | if ( verbose_console_log ) 78 | { 79 | var log_msg = 'Message to forGL: '+ request_str + ' data: ' + data_str; 80 | console.log( log_msg ); 81 | } 82 | }; 83 | 84 | 85 | var msg_result = ''; 86 | var msg_data = ''; 87 | 88 | forGL_Worker.onmessage = function( msg_back ) 89 | { 90 | msg_result = msg_back.data[ 0 ]; 91 | msg_data = msg_back.data[ 1 ]; 92 | /* 93 | if ( verbose_console_log ) 94 | { 95 | var log_msg = 'forGL Result: '+ msg_result + ' Data: ' + msg_data; 96 | console.log( log_msg ); 97 | } 98 | */ 99 | 100 | // Save message details as needed into appropriate variables 101 | switch ( msg_result ) 102 | { 103 | case "data_stack": 104 | data_stack_element.textContent = msg_data; 105 | break; 106 | 107 | case "error": 108 | messages_element.textContent += msg_data; 109 | status_text_element.textContent = msg_data; 110 | alert( msg_data ); 111 | break; 112 | 113 | case "information": 114 | messages_element.textContent += msg_data; 115 | break; 116 | 117 | case "message": 118 | messages_element.textContent += msg_data; 119 | break; 120 | 121 | case "noun_stack": 122 | noun_stack_element.textContent = msg_data; 123 | break; 124 | 125 | case "op_stack": 126 | op_stack_element.textContent = msg_data; 127 | break; 128 | 129 | case "status": 130 | status_text_element.textContent = msg_data; 131 | break; 132 | 133 | case "verb_output": 134 | verb_output_element.value += msg_data; 135 | break; 136 | 137 | case "verb_tokens": 138 | verb_colored_element.value = msg_data; 139 | break; 140 | 141 | case "warning": 142 | messages_element.textContent += msg_data; 143 | break; 144 | 145 | default: 146 | //if ( ! verbose_console_log ) 147 | //{ 148 | var log_msg = 'forGL Result: ' + msg_result + 'NOT handled. Data: ' + msg_data; 149 | console.log( log_msg ); 150 | //} 151 | 152 | break; 153 | } 154 | return; 155 | }; 156 | 157 | 158 | 159 | 160 | 161 | var sendDictionary = function( ) 162 | { 163 | var dict_text = dict_text_element.srcdoc; 164 | console.log( dict_text ); 165 | sendRequest( "dictionary", dict_text ); 166 | return; 167 | }; 168 | 169 | 170 | 171 | run_stop_button.onclick = function( e ) 172 | { 173 | if ( is_running ) 174 | { 175 | var log_msg = 'STOP Running !'; 176 | console.log( log_msg ); 177 | isRunning = false; 178 | run_stop_button.textContent = "RUN"; 179 | sendRequest( 'stop', '' ); 180 | } 181 | else 182 | { 183 | var user_verb = user_verb_element.value; 184 | var log_msg = 'Run User Verb: ' + user_verb; 185 | console.log( log_msg ); 186 | isRunning = true; 187 | run_stop_button.textContent = "STOP"; 188 | sendRequest( 'run', user_verb ); 189 | } 190 | return; 191 | }; 192 | 193 | verbose_console_log = false; 194 | sendRequest( "using_web_worker", using_web_worker ); // Help initialize forGL as Web Worker or not 195 | sendRequest( "oscpu", oscpu ); 196 | 197 | 198 | sendDictionary(); 199 | 200 | verbose_console_log = true; 201 | 202 | 203 | 204 | })(); -------------------------------------------------------------------------------- /Docs/_forGL_Docs_Read_Me_First.txt: -------------------------------------------------------------------------------- 1 | forGL R E A D M E F I R S T 2 | 3 | revised: July, 2025 4 | by: Randy Maxwell 5 | 6 | Summary 7 | =============== 8 | forGL enables you to begin learning about computer programming. 9 | forGL allows you to run your programs in several different ways. 10 | 11 | forGL is an application that sometimes acts like a programming language. 12 | When using forGL you may use your own language and not just English. 13 | 14 | forGL allows your programs to be saved to various programming languages, 15 | when the Export feature is implemented and tested. 16 | 17 | Key Ideas 18 | ----------------- 19 | No prior experience with programming is needed. 20 | Thinking about Problems/Solutions logically helps. 21 | Some experience with a calculator or calculator program helps. 22 | User/Programmer edits definitions of Words in a Dictionary. 23 | Words may be in any language and not limited to English. 24 | 25 | Word types are: 26 | Nouns (data) integers, floats, bools, strings 27 | Local Nouns Nouns that get added and removed while running and not saved in the Dictionary. 28 | Verbs (code) any combination of word types you may edit 29 | Verbs Built In (code) utility Verbs to do a specific task Show is an example. 30 | Operators (ex: Math or Logic, Punctuation) + - / * exp, log, trig, etc. 31 | 32 | The order of Nouns, Verbs and so on is not fixed. Nearly any order will work. 33 | Punctuation is the characters ; , . : Punctuation is used naturally to show the end of a phrase or sentence. 34 | European style simplified Natural Languages of course have a period . at the end of each sentence. 35 | 36 | A Verb may have any mix of Languages within; Ex: English, German, Spanish, Math, Logic, Vulcan, whatever. 37 | Different colors are used to show different Word types. 38 | 39 | 40 | Setup (there is no install program) 41 | ==================================== 42 | 43 | Create a directory and copy some files. 44 | 45 | Windows OS users need to do a few more steps as below. 46 | 47 | Please see the Operations section below after you finish setup. 48 | 49 | 50 | Setup for any OS (except Windows) 51 | ---------------- 52 | Create a directory. 53 | 54 | Place the files in the new directory. 55 | 56 | Run forGL by: 57 | IF you have Python 3.x installed 58 | python forGL.py dictionary_file 59 | 60 | //// Commented out, does not work with latest Java versions 61 | //// IF you have Java 6 or higher installed (Java 8 or higher recommended) 62 | //// java -jar forGL.jar dictionary_file 63 | 64 | Now you are ready to try various forGL features. 65 | Please see the Operations section below for more information. 66 | 67 | 68 | Windows setup 69 | ------------- 70 | Create a directory. 71 | 72 | Place the files in the new directory. 73 | 74 | ansicon.exe is needed to support Color Syntax Highlighting on Windows. 75 | If you are using another OS you can skip this part. 76 | 77 | For running on Windows, download ansicon 78 | This is the page of the version I use. 79 | http://adoxa.altervista.org/ansicon/ 80 | 81 | This is the link for ANSICON v1.87 82 | http://adoxa.altervista.org/ansicon/dl.php?f=ansicon 83 | 84 | Put the 2 DLL files (ANSI32 and ANSI64) and ansicon.exe in the same directory as you created. 85 | 86 | Start a Windows Cmd window. 87 | 88 | cd (to the directory you just created) 89 | 90 | type 91 | ansicon 92 | 93 | and you will see the title change to 94 | Cmd - ansicon 95 | 96 | Now if ANSI Escape sequences are sent by forGL 97 | the cursor will move and colored text will be seen. 98 | 99 | also type 100 | chcp 65001 101 | 102 | This changes the Windows text Code Page to UTF8 103 | You only need to do this 1 time 104 | but because I create / destroy Cmd.exe window instances often 105 | I suggest you create a .bat file with the following contents: 106 | 107 | @echo off 108 | chcp 65001 109 | python forGL.py 110 | 111 | Now if you do a dir command you should see: 112 | ANSI32.dll 113 | ANSI64.dll 114 | ansicon.exe 115 | forGL.jar (you may not have this, Python works as well) 116 | forGL.py 117 | forGL_Dictionary_Prototype.toml 118 | 119 | and the name of your new .bat file. 120 | 121 | 122 | 123 | 124 | Operations Quick Start 125 | ============================================================================== 126 | forGL has been tested on Windows 7 and 10 127 | 128 | but really : 129 | you can run forGL.py on any platform with Python 3.x installed 130 | 131 | 132 | forGL Dictionary (in memory and added to from a file) 133 | ------------------------------------------------------- 134 | forGL builds a default dictionary in memory of English words when starting. 135 | 136 | A (optional) dictionary file (such as forGL_Test.toml) 137 | can be used to add more words to the dictionary in memory. 138 | This allows you to add and run your own defintions of what forGL is to do. 139 | 140 | forGL tries to find a dictionary file named: forGL_Dictionary_Prototype.toml 141 | OR 142 | You can add the path and name of the dictionary file you want to use. 143 | 144 | 145 | Dictionary words in languages other than English 146 | ------------------------------------------------ 147 | forGL_Dictionary_Prototype.toml has examples of words in various languages. 148 | 149 | There is limited support (now) for non English languages: 150 | forGL messages are (now built in) in English. 151 | 152 | 153 | Dictionary file used by forGL 154 | ----------------------------- 155 | This is how you may add a command line argument for a dictionary file. 156 | (Python example) 157 | python forGL.py forGL_Test_Dictionary.toml 158 | 159 | Dictionary file use is optional but it is very nice to have and recommended. 160 | forGL has a minimum Dictionary that is built in. 161 | The minimum Dictionary is enough to run forGL and access all the features. 162 | 163 | 164 | 165 | ... Under Construction ... 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | -------------------------------------------------------------------------------- /src/forGL/Export.hx: -------------------------------------------------------------------------------- 1 | /* Export.hx forGL Export to a persistent Dictionary 2 | * 3 | * Prototype (VERY Experimental) of forGL application 4 | * 5 | * NOTES: 6 | * 7 | * Exporting from the Dictionary in memory to the Data layer 8 | * to allow persistent Dictionary changes. 9 | * 10 | * ... 11 | * @author Randy Maxwell 12 | */ 13 | 14 | package forGL; 15 | 16 | 17 | // Improved UTF8 support 18 | using hx.strings.Strings; 19 | using hx.strings.String8; 20 | 21 | using forGL.Parse.Parse; 22 | using forGL.Parse.NLToken; 23 | 24 | using forGL.NLTypes; 25 | import forGL.NLTypes.NLTypeAs.resolveType as resolveType; 26 | 27 | import forGL.Meanings.OpMeanings; 28 | import forGL.Meanings.MeansWhat.opMeanAsStr as opMeanAsStr; 29 | import forGL.Meanings.MeansWhat.returnMeanAsStr as returnMeanAsStr; 30 | 31 | import forGL.data.Data.ForGL_data; 32 | 33 | // import forGL.Dictionary.DictWord; 34 | import forGL.Dictionary.NLDictionary; 35 | 36 | import forGL.Meanings.ReturnMeanings; 37 | 38 | import forGL.UI.ForGL_ui.msg as msg; 39 | import forGL.UI.ForGL_ui.status as status; 40 | 41 | // Have Comments in Haxe generated output programming languages sources 42 | import forGL.Comments.comment as comment; 43 | 44 | using forGL.Export.NLExport; 45 | 46 | 47 | enum 48 | abstract ExportTypes(Int) { 49 | 50 | var EXPORT_TYPE_UNKNOWN = 0; 51 | 52 | var EXPORT_TYPE_DICTIONARY = 1; // 53 | 54 | } 55 | 56 | 57 | // 58 | // Import support for Dictionaries (or Library Vocabularies?) 59 | // 60 | class NLExport 61 | { 62 | 63 | public function new() 64 | { 65 | 66 | } 67 | 68 | 69 | public function init() 70 | { 71 | 72 | 73 | 74 | 75 | 76 | 77 | } 78 | 79 | 80 | 81 | public function cleanUp() 82 | { 83 | 84 | 85 | 86 | } 87 | 88 | 89 | // Export the in memory Dictionary to a file. 90 | // 91 | public var exportWords_msgs : String8 = ""; 92 | 93 | public var exportWords_replaced = 0; 94 | public var exportWords_added = 0; 95 | 96 | public function exportWords( dict : NLDictionary, dict_path_file : String8, data : ForGL_data, ?export_type = EXPORT_TYPE_DICTIONARY ) : ReturnMeanings 97 | { 98 | comment( "", "Export the in memory Dictionary to a file.", "" ); 99 | 100 | var result = RET_IS_OK; 101 | 102 | exportWords_msgs = ""; 103 | exportWords_replaced = 0; 104 | exportWords_added = 0; 105 | 106 | var words_replaced = new Array