nqp(1) [debian man page]

nqp(1)							User Contributed Perl Documentation						    nqp(1)

NAME

       nqp - Not Quite Perl Compiler

SYNOPSIS

	nqp [switches] [--] [programfile] [arguments]

DESCRIPTION

       With no arguments, enters a REPL. With a "[programfile]" or the "-e" option, compiles the given program and by default also executes the
       compiled code.

	 -c		      check syntax only (runs BEGIN and CHECK blocks)
	 -e program	      one line of program
	 -h, --help	      display this help text
	 --target=[stage]     specify compilation stage to emit
	 -t, --trace=[flags]  enable trace flags, see 'parrot --help-debug'
	 --encoding=[mode]    specify string encoding mode
	 -o, --output=[name]  specify name of output file
	 -v, --version	      display version information
	 --stagestats	      display time spent in the compilation stages
	 --ll-backtrace       display a low level backtrace on errors

       Note that only boolean single-letter options may be bundled

       Supported stages for --target are:

	parse past post pir evalpmc

       where

	parse = a representation of the parse tree
	past  = an intermediate format representing the parrot abstract syntax tree
	post  = an intermediate format representing the parrot opcode syntax tree
	pir   = the parrot intermediate representation

PARROT OPTIONS

       To specify options to the underlying parrot VM, you must explicitly run parrot; you cannot specify these options by using the "perl6"
       executable.

	parrot [parrot switches] perl6.pbc [switches] [--] [programfile] [arguments]

       See "parrot --help" for a list of valid parrot options.

AUTHORS

       Written by the NQP contributors, see the CREDITS file.

       This manual page was written by Alessandro Ghedini for the Debian project, and may be used by others.

perl v5.14.2							    2012-04-24								    nqp(1)

MAIN.C(1)						      Debian GNU/Linux manual							 MAIN.C(1)

NAME

       pbc_disassemble - parrot bytecode disassembler

SYNOPSIS

       pbc_disassemble [-bh?] [--bare|--header-only] [-o outfile] [file.pbc]

DESCRIPTION

       "pbc_disassemble" translates Parrot bytecode ("PBC") into Parrot assembly language ("PASM").

       "file.pbc" is the bytecode file to disassemble. If a file is not specified, the bytecode will be read from "stdin". Additionally, if the
       "-o" switch is not given, the output is displayed to "stdout".

OPTIONS

       -?, --help
	   Displays usage and help information.

       -b, --bare
	   Displays bare PASM without the header and left column.

       -h, --header-only
	   Displays only the constants table header.

       -o filename, --output filename
	   Writes output to "filename".

STATIC FUNCTIONS

       "int main(int argc, const char *argv[])"
	   Execution entry point. Starts up an interpreter, loads the bytecode from the command-line, and disassembles it.

       "static void help(void)"
	   Prints out the user help information and exits.

       "static void show_last_error_and_exit(Parrot_PMC interp)"
	   Prints out the "interp"'s last error and exits.

SEE ALSO

       src/embed.c and src/debug.c.

HISTORY

       Initial version by Daniel Grunblatt on 2002.5.26.

       Florian Ragwitz: Moved POD documentation that's not necessary to know how to actually run the disassembler to normal C comments (Wed, 16
       Nov 2005).

       Reini Urban: Renamed from disassemble to pbc_disassemble (2008-07-03).
		    Add options: help, -h, -o, --debug, --bare (2009-01-29)
		    Force option 1 for passing version check (2009-03-07)

       Kevin Polulak (soh_cah_toa): Updated to use embedding API, moved source file
				    to frontend/pbc_disassemble, and cleaned up
				    source code and perldoc. (2011-06-19)

Debian Project							    2011-10-29								 MAIN.C(1)