aboutsummaryrefslogtreecommitdiffstats
path: root/ghw
diff options
context:
space:
mode:
authorumarcor <unai.martinezcorral@ehu.eus>2021-04-23 04:24:28 +0200
committertgingold <tgingold@users.noreply.github.com>2021-04-23 05:34:09 +0200
commit82cdb8faaedfaa0c7e860aa024e13bf25e0618b3 (patch)
treeb577fd3d38540146193c9316cdc2686f29b69d0e /ghw
parente8a44b3c366027f0199d1a6fde0b761a7b2b03c5 (diff)
downloadghdl-82cdb8faaedfaa0c7e860aa024e13bf25e0618b3.tar.gz
ghdl-82cdb8faaedfaa0c7e860aa024e13bf25e0618b3.tar.bz2
ghdl-82cdb8faaedfaa0c7e860aa024e13bf25e0618b3.zip
ghw: add README.md
Diffstat (limited to 'ghw')
-rw-r--r--ghw/README.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/ghw/README.md b/ghw/README.md
new file mode 100644
index 000000000..e64bbf769
--- /dev/null
+++ b/ghw/README.md
@@ -0,0 +1,9 @@
+# GHDL Wavefile helpers
+
+This subdir contains C helpers for managing GHDL Wavefiles (GHW).
+These sources are used in GTKWave for reading GHW waves (see [gtkwave/gtkwave/search?q=ghwlib](https://github.com/gtkwave/gtkwave/search?q=ghwlib)).
+
+- `ghwlib.c` and `ghwlib.h` provide the reader library.
+- `ghwdump.c` uses the library for dumping the content of GHW files in text, for debugging purposes. `ghwdump` is built and installed with GHDL by default, and it is used in the test suite.
+
+These helpers are independent from GHDL's codebase. However, the GHW format is not specified, so it might change as a result of internal tweaks in GHDL. Hence, it is strongly suggested to use the helpers provided in the GHDL installation.