FreeHDL-V2CC(1)

💅 FreeHDL-V2CC — like, the VHDL-to-C++ glow-up machine ✨

okay bestie, so this is the FreeHDL-V2CC(1) manual page, straight from the User Commands corner of the universe, and I'm gonna walk you through it like we're gossiping at lunch 🫶

🌸 NAME 🌸

FreeHDL-V2CC — literally a VHDL to C++ converter. that's the whole vibe. it takes your VHDL and gives you C++, no cap 💖

✨ SYNOPSIS ✨

freehdl-v2cc [OPTION] ... [FILE] ...

so like, options first, files after, both can repeat, that's the whole thing 🎀

🦋 DESCRIPTION 🦋

okay so FreeHDL is a whole parser/compiler/simulator suite for VHDL — the hardware description language, yk? and it supports both VHDL'93 and VHDL'87 files. vintage and modern, we love range 👑

and FreeHDL-V2CC specifically? it translates the original VHDL source FILEs into C++. that's its whole main character job. slay 🔥

💅 OPTIONS 💅

• -o FILE — writes the generated C++ code out to FILE. your output, your rules ✨
• -n — dry run. like window shopping for compilations, nothing actually happens 💀
• -R — emit register code. registers get their moment 🎀
• -v — enable verbosity. she talks more. we listen 🫶
• -g — emit debugging code. for when you need to see what's going on under the hood 🔍
• -D — emit CDFG code. yes bestie, CDFG 💜
• -l LIBNAME — use LIBNAME as the WORK library. default is the "." library directory. so like, current dir is the default home base 🏠
• --relaxed-component-visibility — allows invisible default bindings from WORK. chill mode for visibility, iykyk 🙈
• --depend FILE — write dependency information to FILE. receipts, basically 🧾
• -m FILE — emit the main() file C++ code to FILE. the main character gets her own file 👑
• -L VHDLLIB — path to the VHDL library root directory. within this directory the compiler searches for a file named v2cc.libs, and that mapping file translates library unit names to directories. note: more than one VHDLLIB may be provided — the more the merrier, fr fr 🌈

🌸 ENVIRONMENT VARIABLES 🌸

V2CC_LIBRARY_PATH

so this variable consists of ":" separated filenames. in addition to the environment variable, you can use the -L libdir command line option with v2cc. the directories specified with -L are added in front of the ones specified by V2CC_LIBRARY_PATH, and in the final library path they appear in the same order as on the command line. order matters, bestie, don't @ me 💅

🦋 SEE ALSO 🦋

• gvhdl(1)
• freehdl-config(1)
• v2cc.libs(5)

go read those too, they're the supporting cast 🫶

✨ AVAILABILITY ✨

the latest version of FreeHDL can always be obtained from www.freehdl.seul.org. go get your update, queen 🎀

💀 REPORTING BUGS 💀

known bugs are documented within the BUGS file. so check there first, bestie, it's literally right there 😭

now, if your report addresses a parser related topic, contact Marius Vollmer <mvo@zagadka.ping.de>. if it's related to the code generator or compiler, send an email to Edwin Naroska <edwin@ds.e-technik.uni-dortmund.de>. and if you're not sure? send it to Edwin. he will take care of forwarding your report to the appropriate recipient. king behaviour, honestly 👑🫶

🌈 COPYRIGHT 🌈

Edwin Naroska © 1999, 2000, 2001, 2002, 2003, 2004, 2005 <edwin@ds.e-technik.uni-dortmund.de>

this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like, zero warranty, none, nada, don't come for her 💀

⭐ AUTHORS ⭐

written by Marius Vollmer <mvo@zagadka.ping.de> and Edwin Naroska <edwin@ds.e-technik.uni-dortmund.de>. icons, both of them 💖

---

and that's the whole page, bestie 🎀 this edition is the Debian/GNU Linux one from December 2005 — vintage but still iconic, periodt ✨🦋💜