nuttx-apps/interpreters/ficl
patacongo 1d7bb0fa07 Most of the changes needed to support Windows native clean; distclean is has a problem
git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@5367 42af7a65-404d-4744-a932-0658087f49c3
2012-11-17 18:54:53 +00:00
..
src Ported Ficl to NuttX apps/ 2011-05-10 18:18:19 +00:00
configure.sh Ported Ficl to NuttX apps/ 2011-05-10 18:18:19 +00:00
Kconfig Developing a new way to handle application configurations 2012-04-14 20:01:08 +00:00
Makefile Most of the changes needed to support Windows native clean; distclean is has a problem 2012-11-17 18:54:53 +00:00
README.txt Remove executable property from source and make files 2012-09-13 18:46:10 +00:00

apps/interpreter/README.txt
===========================

Ficl is a programming language interpreter designed to be embedded into
other systems as a command, macro, and development prototyping language.
Ficl is an acronym for "Forth Inspired Command Language". See
http://ficl.sourceforge.net/

Build Instructions
------------------

Disclaimer:  This installation steps have only been exercised using Ficl
4.1.0.  With new versions you will likely have to make some adjustments
to this instructtions or to the files within this directory.  Think of this
information as "recommendations" -- not necessarily proven instructions.

1. CD to apps/interpreters/ficl

2. Download Ficl: http://sourceforge.net/projects/ficl/files/

3. Uznip the Ficl compressed file.

   For example, 'unzip ficl-4.1.0.zip' will leave the file
   apps/interpreters/ficl/ficl-4.1.0

4. Configure to build Ficl in the apps/interpreters/ficl directory using
   the configure.sh script.

   For example, './configure.sh ficl-4.1.0' will leave the Makefile
   fragment 'Make.srcs' in the ficl build directory.

5. Create your NuttX configuration.  The appconfig file should include
   (1) the path to your application code, and (2) the path to the Ficl
   build directory.  That latter would appear as the following line in
   your appconfig file:

   CONFIGURED_APPS += interpreters/ficl

 6. Configure and build NuttX.  On successful completion, the Ficl objects
    will be available in apps/libapps.a and that NuttX binary will be
    linked against that file.  Of course, Ficl will do nothing unless
    you have written some application code that uses it!