Find a file
2015-04-06 11:17:39 -04:00
docs UG update; Exceptions, plus killed lock file 2015-04-06 11:15:31 -04:00
integration The Exception class is no longer proxied. 2015-04-06 10:11:36 -04:00
lib The Exception class is no longer proxied. 2015-04-06 10:11:36 -04:00
tests Removed the superflous ForceAbort exception. 2015-02-08 19:24:54 -05:00
.gitignore Fixed .gitignore to ignore the fucking lock files! 2015-04-06 11:17:39 -04:00
.rdoc_options The Token struct and rdoc corrections. 2014-09-19 13:19:33 -04:00
demo.rb Minor demo update. 2015-01-14 21:50:07 -05:00
fOOrth.gemspec Added the in_array gem. 2015-01-11 18:24:37 -05:00
fOOrth.reek Day 1 2014-09-09 15:35:22 -04:00
Gemfile Cleanup build env more like bundler would do it. 2014-11-03 16:51:04 -05:00
license.txt Day 1 2014-09-09 15:35:22 -04:00
rakefile.rb Added some dormant options for rdoc. 2014-12-01 15:46:17 -05:00
README.md Corrected file suffix in readme example. 2015-01-30 13:37:48 -05:00
reek.txt Smell cover-up. 2015-02-05 20:46:47 -05:00
sire.rb Fixed sire.rb so it can be run outside of rake. 2015-02-15 20:10:37 -05:00
t.txt SIRE enhancements. 2014-10-15 12:27:05 -04:00
test.foorth Added the )vm method for debug. 2015-01-29 13:59:39 -05:00

The fOOrth Language gem.

This file contains the read-me for the fOOrth language gem. The fOOrth language is an experimental variant of FORTH that attempts to incorporate object oriented and functional programming concepts.

As an aside, there can be no doubt that the fOOrth project is an utter waste of anyone's time, unless one counts the insights gained into the inner workings of Ruby and meta programming.

Usage

Adding fOOrth can be as simple as:

require 'fOOrth'
XfOOrth.main

This will launch an interactive fOOrth session. Alternatively this can be done with:

rake run

Be sure to be in the folder that contains the rakefile in order for this command to work.


If, instead, a non-interactive facility is required, use:

require 'fOOrth'
XfOOrth.virtual_machine.process_string '1 2 +'

where the string is fOOrth code to be executed, or for a file of code, use:

require 'fOOrth'
XfOOrth.virtual_machine.process_file 'my_file.foorth'

Further Documentation

The fOOrth Language System is documented in The fOOrth User Guide. This is currently only available in Open Office format, and is still also very much a work in progress. Please see The_fOOrth_User_Guide.odt in the docs folder.

As each version of fOOrth is made available, expect to see portable document format versions of the guide for each released version.

Notes

  • Tested under ruby 1.9.3p484 (2013-11-22) [i386-mingw32]
  • Not sure what version broke minitest, but I'm not changing!
  • I have used rdoc 4.0.1 here. Later versions of rdoc look like crap!