Foundational Library
                          --------------------

"Design interfaces that are easy to use correctly and hard to use
                          incorrectly."
                         -- Scott Meyers

DESCRIPTION
-----------

An alternative standard C library for some 32-bit machines. Some
advantages over the ANSI standard library:

 * Written entirely in Assembly.
 * No global variables. Functions always return errors directly.
 * No opaque structures.
 * Type definitions are used sparingly.
 * No functions with varadic arguments.
 * strcpy() and strcat() is replaced with memcpy().

New functions are implemented as needed by my other projects. Some
input and output functions are ported from Ada's standard library,
which do not use varadic arguments.

This library has been successfully built on Linux ARM (version 4) and
i386. The included specs file links libgcc but not libssp, hense why
SSP is disabled.

BUILDING
--------

To use the included script, you'll need a POSIX compatible shell. To
build, execute the script without any arguments:

  ./build.sh

To install, uninstall, or clean, pass the respective word as an
argument. Alternatively, you can perform any of these functions
manually; use the script source as a reference.

EXAMPLES
--------

The `tests` directory contains a build script to compile some simple
examples that also serve as tests. For larger examples, see my other
projects.

COPYING & CREDIT
----------------
Written by Stone Fox. This work is dedicated to the public domain. Do
with it what you please.