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-2005 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>