gered/picoc
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

add license file, update copyright holders

Browse source
This commit is contained in:
Joseph Poirier 2015-06-10 15:29:12 -05:00
parent b5207c06ae
commit cb51a77b08
2 changed files with 47 additions and 50 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
LICENSE Normal file
View file

@ -0,0 +1,29 @@
Copyright (c) 2009-2011, Zik Saleeba
Copyright (c) 2015, Joseph Poirier
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
* Neither the name of the Zik Saleeba nor the names of its
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

68
README
View file

@ -1,21 +1,19 @@
picoc picoc
----- -----
PicoC is a very small C interpreter for scripting. It was originally written PicoC is a very small C interpreter for scripting. It was originally written
as a script language for a UAV's on-board flight system. It's also very as a script language for a UAV's on-board flight system. It's also very
suitable for other robotic, embedded and non-embedded applications. suitable for other robotic, embedded and non-embedded applications.
The core C source code is around 3500 lines of code. It's not intended to be The core C source code is around 3500 lines of code. It's not intended to be
a complete implementation of ISO C but it has all the essentials. When a complete implementation of ISO C but it has all the essentials. When
compiled it only takes a few k of code space and is also very sparing of compiled it only takes a few k of code space and is also very sparing of
data space. This means it can work well in small embedded devices. It's also data space. This means it can work well in small embedded devices. It's also
a fun example of how to create a very small language implementation while a fun example of how to create a very small language implementation while
still keeping the code readable. still keeping the code readable.
picoc is now feature frozen. Since it's important that it remain small it's It's been tested on x86-32, x86-64, powerpc, arm, ultrasparc, HP-PA and blackfin
intended that no more major features will be added from now on. It's been processors and is easy to port to new targets.
tested on x86-32, x86-64, powerpc, arm, ultrasparc, HP-PA and blackfin
processors and is easy to port to new targets.
Compiling picoc Compiling picoc
@ -29,26 +27,26 @@ The test suite can be run by typing "make test".
Porting picoc Porting picoc
------------- -------------
platform.h is where you select your platform type and specify the includes platform.h is where you select your platform type and specify the includes
etc. for your platform. etc. for your platform.
platform_XXX.c contains support functions so the compiler can work on platform_XXX.c contains support functions so the compiler can work on
your platform, such as how to write characters to the console etc.. your platform, such as how to write characters to the console etc..
platform_library.c contains your library of functions you want to make platform_library.c contains your library of functions you want to make
available to user programs. available to user programs.
There's also a clibrary.c which contains user library functions like There's also a clibrary.c which contains user library functions like
printf() which are platform-independent. printf() which are platform-independent.
Porting the system will involve setting up suitable includes and defines Porting the system will involve setting up suitable includes and defines
in platform.h, writing some I/O routines in platform_XXX.c, putting in platform.h, writing some I/O routines in platform_XXX.c, putting
whatever user functions you want in platform_library.c and then changing whatever user functions you want in platform_library.c and then changing
the main program in picoc.c to whatever you need to do to get programs the main program in picoc.c to whatever you need to do to get programs
into the system. into the system.
platform.h is set to UNIX_HOST by default so tests can be easily run on platform.h is set to UNIX_HOST by default so tests can be easily run on
a UNIX system. You'll need to specify your own host setup dependent on a UNIX system. You'll need to specify your own host setup dependent on
your target platform. your target platform.
@ -59,33 +57,3 @@ picoc is published under the "New BSD License".
http://www.opensource.org/licenses/bsd-license.php http://www.opensource.org/licenses/bsd-license.php
Copyright (c) 2009-2011, Zik Saleeba
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
* Neither the name of the Zik Saleeba nor the names of its
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.