koi-lang 0.0.2 → 0.0.3

data/README.rdoc

@@ -1,6 +1,10 @@
 = Koi
 
-Koi is a small programming language that is designed to be easy to use, easy to understand and easy to implement. Koi is an imperative, dynamic, weakly-typed language with first-class functions. Koi's syntax is influenced by JavaScript, Lua and Ruby, but works very hard to be unambiguous so that it is easy to write parsers for (in stark contrast with Ruby).
+Koi is a small programming language that is designed to be easy to use, easy to understand and easy to implement. 
+
+Koi is an imperative, dynamic, weakly-typed language with first-class functions. Koi's syntax and features were influenced by JavaScript, Lua and Ruby. Koi makes a point of working very hard to be unambiguous in it's syntax so that it is easy to write parsers for.
+
+Koi's main goal is to be a useful language that teaches the basics of language implementation. The project was started because I wanted to learn more about how languages work 'under the hood' and Koi is my way of sharing what I've learnt with as many people as possible.
 
 === Example
 
@@ -24,7 +28,7 @@ This is an old-school 'Blast Off!' program written in Koi:
 
 === Installation
 
-For ease of installation the default installation of Koi is packaged as a RubyGem. Providing you have Ruby and RubyGems installed installing Koi is as easy as entering the following command in a terminal:
+For ease of use the default installation of Koi is packaged as a RubyGem. Providing you already have Ruby and RubyGems installing Koi is as easy as entering the following command in a terminal:
 
   gem install koi-lang
   
@@ -55,22 +59,22 @@ Koi features a full set of basic and compound data types including:
 Koi currently only implements a minimal set of flow control operators:
 
   if( expression )
-    call( do_work )
-  endif
+    do_work
+  end
   
   unless( expression )
-    call( do_other_work )
-  endunless
+    do_other_work
+  end
   
 === Built-in functions
 
-print( string )::   Writes a string to STDOUT.
-gets()::    Fetches a newline delimited string from STDIN.
-call( identifier [, parameter])::   Calls the function that is stored in 'identifier'.
-tailcall( identifier[, parameter])::  Performs a 'tailcall' to the function stored in 'identifier'. This type of call is used when recursing heavily to improve performance and to facilitate the use of functions as iterators.
-return( [value] ):: Return a value from a function.
-to_string( value/identifier ):: Converts the given value to a representative string.
-type_of( value ):: Returns a string representing the type of the value given, eg: "integer".
+[print( string )]                     Writes a string to STDOUT.
+[gets()]                              Fetches a newline delimited string from STDIN.
+[call( identifier [, parameter])]     Calls the function that is stored in 'identifier'.
+[tailcall( identifier [, parameter])] Performs a 'tailcall' to the function stored in 'identifier'. This type of call is used when recursing heavily to improve performance and to facilitate the use of functions as iterators. {More information on tailcalls.}[http://en.wikipedia.org/wiki/Tail_call]
+[return([ value ])]                   Return a value from a function.
+[to_string( value )]                  Converts the given value to a representative string.
+[type_of( value )]                    Returns a string representing the type of the value given, eg: "integer".
 
 === Reserved words
 
@@ -84,7 +88,7 @@ The default installation of Koi consists of the following discrete components:
 * The reference compiler: {koi-reference-compiler}[http://github.com/aarongough/koi-reference-compiler]
 * The standard Virtual Machine: {koi-vm-ruby}[http://github.com/aarongough/koi-vm-ruby]
 
-Each of these components are completely stand-alone and are specifically designed to be as simple as possible. I strongly encourage pulling them apart to see how they tick, and changing them if you see fit! Just make sure if to contribute any improvements back to the main repository!
+Each of these components are completely stand-alone and are specifically designed to be as simple as possible. I strongly encourage pulling them apart to see how they tick, and changing them if you see fit! Just make sure to contribute any improvements back to the main repository!
 
 ==== Hope you enjoy Koi!
 

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Aaron Gough
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-31 00:00:00 -04:00
+date: 2010-09-01 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency