# Getting Started

## Installation

Download binaries and find documentation at [perl.petamem.com](https://perl.petamem.com/).

## First Script

```perl
#!/usr/bin/env pperl
print "Hello from PetaPerl!\n";
```

## Command Line Options

| Option | Description |
|--------|-------------|
| `-e 'code'` | Execute one-liner |
| `-E 'code'` | Like `-e`, with all optional features enabled (`say`, ...) |
| `-I dir` | Prepend `dir` to the module search path `@INC` |
| `-c` | Check syntax only |
| `-w` | Enable warnings |
| `-v` | Show version |
| `-V` | Show configuration, `%ENV` and `@INC` |
| `--no-jit` | Disable JIT compilation |
| `--no-parallel` | Disable auto-parallelization |

See [CLI options](cli_options.md) for the full option list.

## Notes

- Defaults match perl: modern features (`say`, `state` and friends) are
  enabled by `use v5.42;` in scripts or `-E` for one-liners
- XS modules are not supported; native Rust reimplementations are provided for common modules
- Module search paths work as in perl: `-I` and the `PERL5LIB`
  environment variable are honored; `PPERL5LIB` additionally provides
  pperl-only paths (see [CLI options](cli_options.md))