perl6-p(1) · carta

Usage

perl6 [switches] [--] [programfile] [arguments]

Overview

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)
  --doc                extract documentation and print it as text
  -e program           one line of program
  -h, --help           display this help text
  -n                   run program once for each line of input
  -p                   same as -n, but also print $_ at the end of lines
  --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-exception       display a low level backtrace on errors
  --profile            print profile information to standard error

Note that only boolean single-letter options may be bundled

Output from "--profile" can be visualized by "kcachegrind".

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

List of env vars used in Rakudo

"RAKUDOLIB", "PERL6LIB" (src/core/terms.pm): Appends a delimited list of paths to @INC. "RAKUDOLIB" is evaluated first.

"RAKUDO_MODULE_DEBUG" (src/Perl6/ModuleLoader.pm): If set to a non-false value, causes the module loader to print debugging information to standard error.

"RAKUDO_ERROR_COLOR" (src/core/Exception.pm): Controls whether to emit ANSI codes for error highlighting. Defaults to true if unset, except on Win32.

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.