docs/parrot.pod - Parrot
The Parrot Virtual Machine is a language-agnostic common bytecode format and an interpreter for dynamic languages.
The Parrot documentation is spread across a wide range of files. Good starting points are:
- intro.pod An introductory article on what Parrot is and how to do some interesting things with it.
- overview.pod An overview of the Parrot architecture and design.
- running.pod Brief descriptions of the different executables and how to run them.
- faq.pod The Parrot FAQ.
- glossary.pod A guide to some of the jargon that crops up repeatedly in Parrot development (and in the documentation...)
More detailed information on the design and implementation of Parrot can be found in:
- pdds/ This subdirectory contains all of the current Parrot Design Documents (PDDs). These are intended to be detailed guides to the design of the various Parrot subsystems; for instance, pdd03_calling_conventions.pod specifies Parrot's inter-routine calling conventions.
- pmc/ This subdirectory contains documentation on several of the PMC types available to Parrot. Currently only a few of the available PMCs have been documented. (Patches welcome!)
- dev/ This subdirectory contains a number of files discussing various implementation decisions made during the course of the development of Parrot. The intent is to keep discussion of implementation-specific issues separate from the basic design issues discussed in the PDDs.
- vtables.pod A brief introduction to the vtable at the heart of all PMCs, and how to implement your own PMC type.
- embed.pod Describes the embedding subsystem in excruciating detail.
- memory_internals.pod An introduction to the Parrot GC subsystem
- parrotbyte.pod The Parrot bytecode format.
- tests.pod Hints on writing tests for the Parrot interpreter.
- debug.pod A beginner's guide to debugging the Parrot executable.
- debugger.pod Documentation for
parrot_debugger, the Parrot debugger.
Parrot compiles and runs on a large number of platforms, including all common ones. The Parrot team is committed to supporting the following combinations as "core platforms": Linux (x86), Win32 (x86), OS X (x86 and PPC), Cygwin, FreeBSD (x86), NetBSD, OpenBSD, Solaris. Here x86 includes the x86_64 architecture. x86 describes that Parrot is supported to run on a 32-bit and 64-bit (AMD64 and Intel 64) CPU.
Parrot is developed and maintained by the members of the
email@example.com mailing list.
The list is archived at: http://groups.google.com/group/parrot-dev/ Many people have contributed their time and expertise to the Parrot project; see the CREDITS file for details.
for more information.