19-02-2012

============================
SDL_Clown Script Interpreter
============================

The use of SDL_clown is exhaustively explained in the file "Manual", 
however, here is a quick overview:

SDL_clown is a script interpreter experiment by young noob programmer.
It is written in C, has somewhat C-like syntax, and can do the 
following:

 - Arithmetic
 - Assignment
 - Built-in functions (sqrt/sin/cos/tan/floor)
 - Control flow (if and while)
 - Drawing colored rectangles
 - Expressions
 - Frame rate control
 - Floating-point variables
 - Floating-point variable arrays
 - Floating-point variable input
 - Interactive mode
 - Mouse coordinates
 - On-the-fly variable creation (without declaration)
 - Output of text mixed with expression or variable values
 - Parentheses
 - Program arguments
 - Relational operators
 - Shebang

SDL_clown *cannot* do the following important things:

 - Custom functions / procedures / subroutines
 - Operator precedence (proper order of operations)
 - String variables and operations

SDL_clown was not written by a programmer with great knowledge of
proper compiler design methods: I wrote much of it in complete
ignorance of stacks, grammars, etc.

In many parts of the source, rather than using existing
efficient algorithms and approaches (which I didn't know),
I tried to "reinvent the wheel" and improvised.

SDL_clown works by compiling scripts to bytecode and by running this
bytecode in a custom-made register-based VM.

-- Bl0ckeduser

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                  864    3887  22.2% -lh5- fda5 Feb 19  1980 sdlclown-20120219/Makefile
[generic]                 2723    6722  40.5% -lh5- 9583 Feb 19  1980 sdlclown-20120219/Manual
[generic]                   54      55  98.2% -lh5- 1988 Feb 19  1980 sdlclown-20120219/note.txt
[generic]                  886    1725  51.4% -lh5- a92a Feb 19  1980 sdlclown-20120219/README
[generic]                50757 16157504   0.3% -lh5- c888 Jun 18  1980 sdlclown-20120219/sdlclown
[generic]                  915    1744  52.5% -lh5- cde1 Jun 18  1980 sdlclown-20120219/sdlclown-mos.readme
[generic]                  462     782  59.1% -lh5- abfa Mar 24  1980 sdlclown-20120219/src/AssemblyOutputTable.h
[generic]                  462    1484  31.1% -lh5- 645e Feb 19  1980 sdlclown-20120219/src/Clown_Args.c
[generic]                  195     354  55.1% -lh5- 1830 Mar 24  1980 sdlclown-20120219/src/Clown_Args.h
[generic]                  477    1243  38.4% -lh5- d4b0 Mar 24  1980 sdlclown-20120219/src/Clown_HEADERS.h
[generic]                  254     422  60.2% -lh5- 566f Mar 24  1980 sdlclown-20120219/src/Clown_InteractiveFile.c
[generic]                  140     171  81.9% -lh5- c378 Mar 24  1980 sdlclown-20120219/src/Clown_InteractiveFile.h
[generic]                 1311    4487  29.2% -lh5- 66ef Feb 19  1980 sdlclown-20120219/src/Clown_main.c
[generic]                  145     180  80.6% -lh5- 2ae4 Mar 24  1980 sdlclown-20120219/src/Clown_main.h
[generic]                  209     375  55.7% -lh5- 3b1b Mar 24  1980 sdlclown-20120219/src/Clown_state.h
[generic]                  507     988  51.3% -lh5- bd57 Mar 24  1980 sdlclown-20120219/src/Clown_TypeSystem.c
[generic]                  274     529  51.8% -lh5- e915 Mar 24  1980 sdlclown-20120219/src/Clown_TypeSystem.h
[generic]                  572    1427  40.1% -lh5- d10f Mar 24  1980 sdlclown-20120219/src/Compiler_AssemblyOutput.c
[generic]                  152     187  81.3% -lh5- 200e Mar 24  1980 sdlclown-20120219/src/Compiler_AssemblyOutput.h
[generic]                 1139    3388  33.6% -lh5- e99a Mar 24  1980 sdlclown-20120219/src/Compiler_BinaryOutput.c
[generic]                  203     355  57.2% -lh5- 46dd Mar 24  1980 sdlclown-20120219/src/Compiler_BinaryOutput.h
[generic]                  312     533  58.5% -lh5- 04d9 Mar 24  1980 sdlclown-20120219/src/Compiler_Compiler.h
[generic]                  406     770  52.7% -lh5- 91d5 Mar 24  1980 sdlclown-20120219/src/Compiler_Debug.h
[generic]                 1255    4174  30.1% -lh5- 4bec Mar 24  1980 sdlclown-20120219/src/Compiler_Dictionary.c
[generic]                  314     711  44.2% -lh5- e44b Mar 24  1980 sdlclown-20120219/src/Compiler_Dictionary.h
[generic]                  517    1168  44.3% -lh5- 160f Mar 24  1980 sdlclown-20120219/src/Compiler_DynamicArrayExp.c
[generic]                  230     471  48.8% -lh5- 9164 Mar 24  1980 sdlclown-20120219/src/Compiler_DynamicArrayExp.h
[generic]                 2633   12142  21.7% -lh5- 6d2b Mar 24  1980 sdlclown-20120219/src/Compiler_Formatter.c
[generic]                  182     257  70.8% -lh5- 9ba2 Mar 24  1980 sdlclown-20120219/src/Compiler_Formatter.h
[generic]                  315     463  68.0% -lh5- 0634 Mar 24  1980 sdlclown-20120219/src/Compiler_Global.h
[generic]                  224     295  75.9% -lh5- 02ee Mar 24  1980 sdlclown-20120219/src/Compiler_Logic.h
[generic]                 7101   45563  15.6% -lh5- dacf Feb 19  1980 sdlclown-20120219/src/Compiler_main.c
[generic]                  612    1833  33.4% -lh5- 9d56 Feb 19  1980 sdlclown-20120219/src/Compiler_TypicalBinaryOp.h
[generic]                  609    1930  31.6% -lh5- 6be2 Feb 19  1980 sdlclown-20120219/src/Compiler_TypicalSubExp.h
[generic]                 1406    4833  29.1% -lh5- 5a3e Mar 24  1980 sdlclown-20120219/src/Compiler_Utilities.c
[generic]                  288     626  46.0% -lh5- bc1f Mar 24  1980 sdlclown-20120219/src/Compiler_Utilities.h
[generic]                  316     535  59.1% -lh5- eab4 Feb 19  1980 sdlclown-20120219/src/Compiler_Version.h
[generic]                  862    2880  29.9% -lh5- 725a Mar 24  1980 sdlclown-20120219/src/Compiler_WeighLines.c
[generic]                  221     364  60.7% -lh5- 1afe Mar 24  1980 sdlclown-20120219/src/Compiler_WeighLines.h
[generic]                 2104   12376  17.0% -lh5- 5d7c Feb 19  1980 sdlclown-20120219/src/fastVM.c
[generic]                  145     241  60.2% -lh5- 42d9 Mar 24  1980 sdlclown-20120219/src/framerate.c
[generic]                   73      80  91.2% -lh5- 4ddf Mar 24  1980 sdlclown-20120219/src/framerate.h
[generic]                  159     295  53.9% -lh5- 6feb Mar 24  1980 sdlclown-20120219/src/mouse.h
[generic]                  954    3004  31.8% -lh5- 0db1 Mar 24  1980 sdlclown-20120219/src/ParentheseSolverV2.c
[generic]                  198     316  62.7% -lh5- 3cb2 Mar 24  1980 sdlclown-20120219/src/ParentheseSolverV2.h
[generic]                   63      74  85.1% -lh5- b661 Mar 24  1980 sdlclown-20120219/src/SDLHeaders.h
[generic]                  362     837  43.2% -lh5- 4dc1 Mar 24  1980 sdlclown-20120219/src/SDL_events.c
[generic]                  181     239  75.7% -lh5- d73b Mar 24  1980 sdlclown-20120219/src/SDL_events.h
[generic]                  480     995  48.2% -lh5- 1b3c Feb 19  1980 sdlclown-20120219/src/SDL_GraphicsMgr.c
[generic]                  187     335  55.8% -lh5- c095 Mar 24  1980 sdlclown-20120219/src/SDL_GraphicsMgr.h
[generic]                  384     674  57.0% -lh5- 3197 Mar 24  1980 sdlclown-20120219/src/SDL_utils.c
[generic]                  204     284  71.8% -lh5- 8790 Mar 24  1980 sdlclown-20120219/src/SDL_utils.h
[generic]                  222     352  63.1% -lh5- d7c0 Feb 19  1980 sdlclown-20120219/src/VM_Binary.h
[generic]                  474     744  63.7% -lh5- a47b Mar 24  1980 sdlclown-20120219/src/VM_Opcodes.h
[generic]                  524    1392  37.6% -lh5- 7041 Mar 24  1980 sdlclown-20120219/src/VM_ProgramFile.c
[generic]                  258     517  49.9% -lh5- f2ad Mar 24  1980 sdlclown-20120219/src/VM_ProgramFile.h
[generic]                  449    1146  39.2% -lh5- c92b Mar 24  1980 sdlclown-20120219/test/BouncingBall
[generic]                  272     469  58.0% -lh5- 8591 Mar 24  1980 sdlclown-20120219/test/Circle
[generic]                  203     332  61.1% -lh5- 9268 Mar 24  1980 sdlclown-20120219/test/Colors
[generic]                  868    2031  42.7% -lh5- 3eb4 Mar 24  1980 sdlclown-20120219/test/CompleteGraph
[generic]                  154     201  76.6% -lh5- 58c4 Mar 24  1980 sdlclown-20120219/test/Gradient
[generic]                  132     166  79.5% -lh5- a5a6 Mar 24  1980 sdlclown-20120219/test/Graph
[generic]                  466    1018  45.8% -lh5- 5238 Oct  9  1980 sdlclown-20120219/test/Pentagon
[generic]                  527    1573  33.5% -lh5- 449c Mar 24  1980 sdlclown-20120219/test/PongClone
[generic]                  573    1406  40.8% -lh5- cb77 Oct  9  1980 sdlclown-20120219/test/RotatingNGon
[generic]                  329     712  46.2% -lh5- 0b89 Feb 19  1980 sdlclown-20120219/test/Spiral
[generic]                  211     346  61.0% -lh5- a51a Mar 24  1980 sdlclown-20120219/test/SqGradient
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        67 files   91660 16299712   0.6%            Jun 18 21:25