The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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 passed on the command line and outputs preprocessed output to standard out or the filename passed with -p.

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.

DISTRIBUTION

The latest version is available from CPAN and from http://www.veripool.com/verilog-perl.html.

Copyright 2000-2006 by Wilson Snyder. This package is free software; you can redistribute it and/or modify it under the terms of either the GNU Lesser General Public License or the Perl Artistic License.

AUTHORS

Wilson Snyder <wsnyder@wsnyder.org>

SEE ALSO

Verilog::Getopt, Verilog::Preproc