The Panini Programming Guide
Table of Contents
- Programming Guide Overview
- Getting Started with Panini
- Capsule-oriented Design
- Panini Language
- Implicit Parallelism
- Installing and Running the Panini compiler
- Downloading the Compiler
- Structure of Panini Distribution
- Requirements for Running Panini Compiler
- Running the Panini Compiler
- Running the Panini Compiler from Command-Line
- Unix-specific Instructions for Command-line
- Compiling Examples from Command-Line
- Ruuning the Panini Compiler from Within Ant
- Acknowledgments and Licensing
- Profiling Panini Programs
- Technical Publications
The Panini compiler can be obtained in the following forms:
- Pre-built binaries: From the Panini download page
- Source code: From sourceforge.net by the URL http://sourceforge.net/projects/paninij
For starting out, we would recommend the pre-built binaries that account for all dependencies. The following instructions assume the use of the pre-built package.
The archive file contains the following:
- bin: Executable versions of the Panini compiler for both *nix and WIN environments.
- lib: Jars files for panini.
- examples: Some small examples of new Panini features.
- license: License agreements under with the Panini Compiler and associated tools are available.
- README: A textual version of this page.
- Java Runtime Environment(JRE) 1.6 or greater.
- Apache Ant is also recommended.
The Panini compiler can be used in two ways:
- like javac from the command-line
- as a replacement builder for javac in the javac ant task.
The following sections describe usage.
The bin folder in this distribution contains scripts that can be used to run the Panini compiler and to start compiled Panini programs.
- bin/panc and bin/panini : the command-line interfaces for *nix systems.
- bin/panc.bat and bin/panini.bat : the command-line interface for WIN systems.
panc.bat scripts have an interface like
panini.bat have an interface like regular
Examples of some small Panini programs are located in the examples folder. To compile an example, navigate to its directory and use Panini compiler just like javac.
For example, to manually compile the Dining Philosophers example, navigate to the examples directory and type ../bin/panc Philosophers.java.
Running compiled Panini programs requires the panini runtime be
on the jvm classpath. The required runtime classes are in
panini script, packaged
in the bin directory, automatically starts a jvm with the correct library
on the classpath.
$PANC_HOME/bin/panini AppEntry to run
The panini compiler can be used in an ant build script by replacing the jar
file used by the
javac task. See the OpenJDK notes in the
Ant manual for
The Panini compiler builds on the OpenJDK java compiler.
All necessary licenses are included in the license directory.
The Panini compiler is licensed under the Mozilla Public License version 1.1 (MPL 1.1) license. You may obtain a copy of the license at http://www.mozilla.org/MPL/.
Page last modified on $Date: 2013/08/03 14:04:23 $