VREG(1) User Contributed Perl Documentation VREG(1)NAMEvreg - Register configuration utility
SYNOPSISvreg--help
vreg ...
DESCRIPTION
Vreg has two major uses. The first vreg converts a HTML document
(saved via Word, Framemaker, LyX, or Latex) to a vreg file. The second
generates standard headers from the .html or from a .vregs file.
HTML CONVERSION
When the --html switch is used, vreg generates a .vregs file from a
.html file. The file format is described in vregs_spec.doc or
vregs_spec.htm.
When saving HTML, be sure to change both the filename to .htm and the
file format to HTML. If inside Microsoft Word, exit.
HEADER CREATION
When the --header switch is used, vreg reads a .vregs file and creates
definition and class headers in the --output directory. Vreg can also
create LaTex tables based on the register layouts.
GENERAL ARGUMENTS--change-diff program
With --change-error, use this program to determine if the error
should be reported or not. The program should exit with non-zero
status to raise an error.
--change-error language
Report error if file of the given language would change. Use ALL
for all languages. This option may be given multiple times to
specify multiple languages.
--dry-run
Don't write any output files, mearly report which files would
change.
--help
Displays this message and program version and exits.
--headers
Creates the header files and other files after the hardware.vregs
file has changed.
--html html_filename
Reads the specified filename and creates a .vregs file from the
html.
--if-product product
Only include registers in output with a Product column matching
that specified. See the vregs_spec document for more information.
--library package
Specifies a package to be used to resolve subclasses. The library
package will only be read, not changed in any way.
--nocomments
Add minimal comment to the header files, to save disk space and
time. Users of the file will have to then look at the .vregs file
to determine what bits represent.
--output
Specifies the directory name to be used for all output files.
--package
Specifies the name of the package; used for creating all filenames.
--rebuild-comment
Specifies a comment to be placed into output files describing to
users how to rebuild the file.
--rm
When used with the --html switch, remove a directory named
html_name_files. (This generally contains images written by
Microsoft Word that are not needed.) Also, clean up the HTML file
to compress out useless style tags that make the file less humanly
readable.
--rules
Specify the name of the rules file. (See SystemC::Vregs::Rules.)
Defaults to the out_directory/package__rules.pl.
--v2k
Use Verilog-2001 constructs, such as localparam. Identical to the
v2k package attribute.
--version
Displays program version and exits.
--vregs
Specify vregs format file to be read or written. Defaults to be in
the directory specified by --output with the filename
package.vregs.
OUTPUT FILE TYPE ARGUMENTS--asm_h
Create an _asm.h file.
--class_cpp
Create a _class.cpp file.
--class_h
Create a _class.h C++ file.
--defs_h
Create a _defs.h file.
--defs_pm
Create a _defs.pl file.
--defs_v
Create a _defs.v file.
--filename-asm-h filename
Specify the output filename for the asm_h file. By default this is
{--output}{package_name}_asm.h.
Similar options exist for all of the other output files.
--files
Create all files. Equivalent to: --class_h --class_cpp --defs_h
--defs_pm --defs_v --info_cpp --hash_pm --params_v --struct_h
--hash_pm
Create a _hash.pm file.
--info_cpp
Create an _info.cpp file.
--latex
Creates latex tables from the vregs definition, suitable for
formatting into printable documentation.
--nofiles
Suppresses creating all files. Equivalent to: --noclass_h
--noclass_cpp --nodefs_h --nodefs_pm --nodefs_v --noinfo_cpp
--nohash_pm --noparams_v --nostruct_h
You can then use specific enables after the --nofiles to turn on
the desired files, for example: --nofiles --class_h --defs_h
--hash_pm
--params_v
Create a _defs.pm file.
--struct_h
Create a _struct.h C file.
DISTRIBUTION
Vregs is part of the <http://www.veripool.org/> free Verilog software
tool suite. The latest version is available from CPAN and from
<http://www.veripool.org/vregs>.
Copyright 2001-2009 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 Version 3 or the Perl Artistic
License Version 2.0.
AUTHORS
Wilson Snyder <wsnyder@wsnyder.org>
SEE ALSO
SystemC::Vregs, SystemC::Vregs::Rules
vregs_spec.htm from the SystemC::Vregs distribution.
perl v5.14.1 2009-05-19 VREG(1)