iverilog/Documentation
William P. Moore 8428032d83 tgt-flow: compact byte-offset positions and source spans
Report every source position as the compact string "start:begin:end" of
byte offsets (begin/end empty when not applicable): a port/signal is
"start::", a module "start::end" (module .. endmodule), an instance
"start::end" (.. ';'), and an always/initial block or generate frame
"start:begin:end".  This replaces the {"off":0,"line":N,"col":0} object
whose off/col were always zero, and matches the GHDL --flow exporter's
format so one consumer works across both tools.

The ivl_target API exposes only line numbers, so the byte offsets and
begin/end spans are recovered by a small comment/string-aware scanner
that reads the source files (cached, with a per-file line table).

Bump the schema to flowtracer1.verilog.v0 (companion to GHDL's
flowtracer1.vhdl.v0).  flow_reg.py checks the new schema and that every
pos/inst_pos is well formed; tgt-flow.rst documents the position format.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 14:24:51 -06:00
..
developer Update documentation to clarify that 'version.exe' is no longer used 2026-04-30 09:11:21 +02:00
releases Add V13 release notes 2026-02-27 21:17:43 -08:00
targets tgt-flow: compact byte-offset positions and source spans 2026-06-19 14:24:51 -06:00
usage Add 2017 and 2023 language flag support 2026-05-16 15:40:37 -07:00
.gitignore Action to deploy documentation to gh-pages 2022-04-15 20:49:13 -07:00
Makefile Action to deploy documentation to gh-pages 2022-04-15 20:49:13 -07:00
conf.py docs: add edit this page to sidebar 2026-05-13 22:12:30 +08:00
favicon.ico Add favicon 2023-06-09 14:07:28 +02:00
index.rst Add V13 release notes 2026-02-27 21:17:43 -08:00
make.bat Start Icarus Verilog Documentation using Sphinx 2022-04-10 19:24:08 -07:00
requirements.txt docs: switch docs to shibuya theme and install via venv 2026-05-11 20:48:58 +08:00