Merge branch 'master' into fastbasic-fp

Author: dmsc

Makefile

@@ -111,7 +111,7 @@ disk/%: %
 	tr '\n' '\233' < $< > $@
 
 disk/%.txt: %.md
-	sed -e 's/`\(.*\)`/\1/g' < $< | tr '\n' '\233' > $@
+	LC_ALL=C awk 'BEGIN{for(n=0;n<127;n++)chg[sprintf("%c",n)]=128+n} {l=length($$0);for(i=1;i<=l;i++){c=substr($$0,i,1);if(c=="`"){x=1-x;if(x)c="\002";else c="\026";}else if(x)c=chg[c];printf "%c",c;}printf "\233";}' < $< > $@
 
 # Copy ".XEX" as ".COM"
 disk/fb.com: $(PROG)

README.md

@@ -5,13 +5,14 @@ This is a fast interpreter for the BASIC language on the Atari 8-bit computers.
 
 The current features are:
 - Support for 16bit integer variables;
-- Small size (currently less than 6k);
+- Small size (currently the IDE is less than 10k, and the runtime is less than 3k);
 - Fast execution (currently, about 15% faster than compiled TurboBasicXL in the "sieve.bas" benchmark, 3.5 times faster than OSS Integer Basic);
 - Modern syntax (no line numbers, many control structures);
-- Feels "alike" TurboBasicXL.
+- Feels "alike" TurboBasicXL, with many of the extended statements.
+- Integrated editor and compiler.
 
 For more support, see the AtariAge thread at:
-http://atariage.com/forums/topic/267197-preview-new-integer-basic-interpreter/
+http://atariage.com/forums/topic/267929-fastbasic-beta-version-available/
 
 Manual
 ------
@@ -24,6 +25,25 @@ Sample files
 In the "tests" folder there are some samples of the language.
 
 
+License
+-------
+
+FastBasic is free software under the terms of the GNU General Public License,
+either version 2 or lather, see the file [LICENSE](LICENSE) for the full text.
+
+The runtime is also under the following linking exception:
+
+> In addition to the permissions in the GNU General Public License, the authors
+> give you unlimited permission to link the compiled version of this file into
+> combinations with other programs, and to distribute those combinations without
+> any restriction coming from the use of this file. (The General Public License
+> restrictions do apply in other respects; for example, they cover modification
+> of the file, and distribution when not linked into a combine executable.)
+
+This means that you can distribute the compiled result of any program written
+by you under any license of your choosing, either proprietary or copyleft.
+
+
 Compiling the sources
 ---------------------
 

help.txt

@@ -1,5 +1,5 @@
 '
-'    FastBasic  -  (c) 2017 dmsc
+'   FastBasic FP -  (c) 2017 dmsc
 '
 ' Editor Help
 ' -----------
@@ -13,6 +13,7 @@
 '   Ctrl-L : Load file
 '   Ctrl-N : New file
 '   Ctrl-R : Parse and run program
+'   Ctrl-W : Compile to binary file
 '
 '�������������̭Π����à������
 

manual.md

@@ -35,6 +35,7 @@ Currently, FastBasic support:
 - Minimal string support.
 - Arrays with "word" and "byte" types.
 - User defined procedures.
+- Compilation to binary loadable files.
 
 
 First Steps
@@ -46,20 +47,21 @@ prompt. This will load the IDE and
 present you with a little help text:
 
     --D:HELP.TXT-------------------0--
-    '    FastBasic  -  (c) 2017 dmsc
+    '  FastBasic FP -  (c) 2017 dmsc
     '
     ' Editor Help
     ' -----------
-    '   Ctrl-A : Move to beg of line
-    '   Ctrl-E : Move to end of line
-    '   Ctrl-U : Page up
-    '   Ctrl-V : Page down
-    '   Ctrl-Z : Undo (only curr line)
-    '   Ctrl-Q : Exit to DOS
-    '   Ctrl-S : Save file
-    '   Ctrl-L : Load file
-    '   Ctrl-N : New file
-    '   Ctrl-R : Parse and run program
+    '  Ctrl-A : Move to beg of line
+    '  Ctrl-E : Move to end of line
+    '  Ctrl-U : Page up
+    '  Ctrl-V : Page down
+    '  Ctrl-Z : Undo (only curr line)
+    '  Ctrl-Q : Exit to DOS
+    '  Ctrl-S : Save file
+    '  Ctrl-L : Load file
+    '  Ctrl-N : New file
+    '  Ctrl-R : Parse and run program
+    '  Ctrl-W : Compile to binary file
     '
     '- Press CONTROL-N + ESC to begin -
 
@@ -77,11 +79,12 @@ first column of the first line of the
 file being edited.
 
 As the help text says, just press the
-`CONTROL` key and the letter N (at the
-same time) to begin editing a new file.
-The editor asks if you want to save the
-current file (the help text) to disk,
-to skip saving simply type `ESC`.
+`CONTROL` key and the letter `N` (at
+the same time) to begin editing a new
+file.  The editor asks if you want to
+save the current file (the help text)
+to disk, to skip saving simply type
+`ESC`.
 
 Now, you can start writing your BASIC
 program. Try the following example,
@@ -117,6 +120,35 @@ instead of running the cursor will be
 moved to the line and column of the
 error so you can correct it and retry.
 
+Remember to save often, pressing the
+`CONTROL` and `S` keys, you need to
+supply a filename. Delete the old file
+with `BACKSPACE` and type the name of
+your new program, and `ENTER` to save.
+As with any prompt, you can press `ESC`
+to cancel the save operation.
+
+
+Compiling the program to disk
+=============================
+
+One of the After you are satisfied with
+your program, you can compile to a disk
+file, producing a program that can be
+run directly from DOS.
+
+Press the `CONTROL` and `W` key, and
+type a name for your compiled program.
+It is common practice to name your
+compiled programs with an extension of
+".COM" or ".XEX", also with ".COM"
+files you don't need to type the
+extension in some DOS.
+
+Compiled programs include the full
+runtime, so you can distribute them
+alone without the IDE.
+
 
 About the syntax
 ================