NAME

vppp - Preprocess Verilog code using verilog-perl

SYNOPSIS

vppp --help
vppp [verilog_options] [-o filename] [verilog_files.v...]

DESCRIPTION

Vppp reads the verilog files passwd on the command line and outputs preprocessed output to standard out or the filename passewd with -p. preprocesses Verilog code (Verilog PreProcessor in Perl). It reads all of the files on the command line similar to verilog or vcs, and prints to standard out or the argument of -o the preprocessed code.

VERILOG ARGUMENTS

The following arguments are compatible with GCC, VCS and most Verilog programs.

+define+var+value =item -Dvar=value

Defines the given preprocessor symbol.

-f file

Read the specified file, and act as if all text inside it was specified as command line parameters.

+incdir+dir =item -Idir

Add the directory to the list of directories that should be searched for include directories or libraries.

+libext+ext+ext...

Specify the extensions that should be used for finding modules. If for example module x is referenced, look in x.ext.

-y dir

Add the directory to the list of directories that should be searched for include directories or libraries.

VPPP ARGUMENTS

--help

Displays this message and program version and exits.

--o file

Use the given filename for output instead of stdout.

--noblank

Removes empty lines from the output. Should be used with --noline, as if correct line numbers are needed, blank lines must be preserved for proper accounting by the program reading the output of vppp.

--nocomment

Remove comments.

--noline

Remove `line directives.

--pedantic

Rigorously obey the Verilog spec. This disables the `__FILE__ and `__LINE__ features, and may disable other features that are not specified in the language reference manual. Defaults false.

--simple

Requests simple output, an alias for --noline, --nocomment and --noblank.

LANGUAGE EXTENSIONS

Vppp supports the preprocessing constructs defined in the Verilog 2001 and SystemVerilog 3.1 standards.

The following additional constructs may be added to your Verilog code.

`__FILE__

The __FILE__ define expands to the current filename, like C++'s __FILE__.

`__LINE__

The __LINE__ define expands to the current line number, like C++'s __LINE__.

`error string

This will report an error when encountered, like C++'s #error.

SEE ALSO

Verilog::Getopt Verilog::Preproc

DISTRIBUTION

The latest version is available from CPAN http://www.perl.org/CPAN/ as part of Verilog-Perl or http://veripool.com/verilog-perl.html.

AUTHOR

Wilson Snyder <wsnyder@wsnyder.org>