NAME
rperl Front-End Program
Restricted Perl, The Optimizing Perl 5 Compiler
SYNOPSIS
rperl [OPTIONS] input_program_0.pl [input_program_1.pl input_program_2.pl ...]
rperl [OPTIONS] MyClassFoo.pm [MyClassBar.pm MyClassBat.pm ...]
rperl [OPTIONS] input_program_0.pl MyClassFoo.pm [input_program_1.pl ... MyClassBar.pm ...]
OPTIONS
- --help _OR_ -h _OR_ -?
-
Print a brief help message.
- --version _OR_ -v
-
Print version number and copyright information. Lowercase 'v' not to be confused with uppercase 'V' in 'Verbose' option below.
- --dependencies _OR_ -d
- --nodependencies _OR_ -nod
-
Follow and compile dependencies, or not. Enabled by default, equivalent to '--mode dependencies=ON' option. Lowercase 'd' not to be confused with uppercase 'D' in 'Debug' option below. WARNING: Disabling dependencies will likely cause errors or undefined behavior.
- --infile=MyFile.pm _OR_ -i=MyFile.pm
-
Specify input file, may be repeated for multiple input files. Option prefix '--infile' may be entirely omitted. Option prefix MUST be omitted to specify wildcard for multiple input files.
- --outfile=MyFile _OR_ -o=MyFile
-
Specify output file prefix, may be repeated for multiple output files. RPerl *.pm input file with PERL ops will create MyFile.pmc output file. RPerl *.pl input file with PERL ops will create my_file (or my_file.exe) & my_file.pmc output files. RPerl *.pm input file with CPP ops will create MyFile.pmc, MyFile.cpp, & MyFile.h output files. RPerl *.pl input file with CPP ops will create myfile (or myfile.exe on Windows), MyFile.pmc, MyFile.cpp, & MyFile.h output files. Option may be entirely omitted, 'MyFile.*' input file will default to 'MyFile.*' out.
- --mode ops=PERL _OR_ -m ops=PERL
- --mode ops=CPP _OR_ -m ops=CPP
-
Specify operations mode, CPP by default. If set to PERL, forces types mode to PERL & compile mode to PARSE or GENERATE; test mode, does not actually compile.
- --mode types=PERL _OR_ -m types=PERL
- --mode types=CPP _OR_ -m types=CPP
- --mode types=DUAL _OR_ -m types=DUAL
-
Specify data types mode, CPP by default. DUAL mode allows generate-once-compile-many types, selected by '#define __FOO__TYPES' in lib/rperltypes_mode.h file.
- --mode check=OFF _OR_ -m check=OFF
- --mode check=ON _OR_ -m check=ON
- --mode check=TRACE _OR_ -m check=TRACE
-
Specify data type checking mode, TRACE by default.
- --mode dependencies=OFF _OR_ -m dependencies=OFF
- --mode dependencies=ON _OR_ -m dependencies=ON
-
Specify dependencies mode, ON by default.
- --mode compile=PARSE _OR_ -m compile=PARSE
- --mode compile=GENERATE _OR_ -m compile=GENERATE
- --mode compile=SUBCOMPILE _OR_ -m compile=SUBCOMPILE
-
Specify compile mode, SUBCOMPILE by default.
- --mode execute=OFF _OR_ -m execute=OFF
- --mode execute=ON _OR_ -m execute=ON
-
Specify execute mode, ON by default.
- --mode label=OFF _OR_ -m label=OFF
- --mode label=ON _OR_ -m label=ON
-
Specify source section label mode, ON by default.
- --compile _OR_ -c
- --nocompile _OR_ -noc
-
Generate & subcompile C++ source code, or not. Enabled by default, equivalent to '--mode compile=SUBCOMPILE' option.
- --execute _OR_ -e
- --noexecute _OR_ -noe
-
Run input code after optional compile, or not. Enabled by default for *.pl program input files, always disabled for *.pm module input files or multiple input files. Equivalent to '--mode execute=ON' option.
- --Verbose _OR_ -V
- --noVerbose _OR_ -noV
-
Include additional user information in output, or not. Disabled by default, equivalent to `export RPERL_VERBOSE=1` shell command. Uppercase 'V' not to be confused with lowercase 'v' in 'version' option above.
- --Debug _OR_ -D
- --noDebug _OR_ -noD
-
Include system diagnostic information in output, or not. Disabled by default, equivalent to `export RPERL_DEBUG=1` shell command. Uppercase 'D' not to be confused with lowercase 'd' in 'dependencies' option above.
- --Warnings _OR_ -W
- --noWarnings _OR_ -noW
-
Include system warnings in output, or not. Enabled by default, equivalent to `export RPERL_WARNINGS=0` shell command.
- --test _OR_ -t
-
Test mode: Perl ops, Perl types, Parse & Generate (no Save or Compile) Disabled by default, equivalent to '--mode ops=PERL --mode types=PERL --mode compile=GENERATE' options.
DESCRIPTION
RPerl is a compiler. For more info:
https://github.com/wbraswell/rperl/blob/master/README.md
SEE ALSO
AUTHOR
William N. Braswell, Jr.