Usage hints - 

$ export PATH=$PATH:`pwd`
$ ./pugs -B perl5

$ ./pugs -B perl5 -Iperl5/PIL-Run/lib6 t/builtins/hex.t
$ ./pugs -B perl5 -Iperl5/PIL-Run/lib6 t/builtins/*.t
$ ./pugs -B perl5 -Iperl5/PIL-Run/lib6 t/builtins/hex.t --repl
$ ./pugs -B perl5 -Iperl5/PIL-Run/lib6
p5ugs> :l t/builtins/hex.t

$ ./pugs -B perl5
p5ugs> say "this is p6 code"
p5ugs> $x = 3
p5ugs> :5 print "this is p5 code\n"
p5ugs> :5 $scalar_x
p5ugs> :5 p6_to_n($scalar_x)
p5ugs> :v
# toggle on verbosity
p5ugs> f(5)
# pil in -C perl5 form
# pil in yaml form
# generated p5 code
p5ugs> :v
# toggle off verbosity


Todo:
 - Perl6-Value and Perl6-Container need an overhaul.
 - PIL-Run needs an overhaul.  (putter did most of a rewrite,
   but it hasn't been checked in - feel free to contact him).

Plan:
 - Await someone with interest and "tuits".
   Or progress on Perl6-Value/Container or PIL2.


Smoke notes:

make smoke-perl5 is currently buggy.
Some tests non-terminate or exhaust memory.
To run make smoke-perl5 on linux, 
 $ ulimit -v 750000   # 750 MB.  Or whatever. May not be needed anymore.
 $ export PUGS_HACK_TIMEOUT=1000
 $ rm t/builtins/control_flow/die.t t/operators/repeat.t t/statements/next.t t/subroutines/recurse.t t/builtins/arrays_and_hashes/kv.t
 $ make smoke-perl5 > log 2>&1
But first, run
 $ ./pugs -B perl5 -e 'say "ok"'
just to make sure your PATH is configured.
Takes about 2 hours at 1GHz.