<div dir="ltr"><div>Hi,</div><br><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">On Mon, Apr 20, 2026 at 12:07 PM Dridi Boukelmoune <<a href="mailto:dridi@varni.sh">dridi@varni.sh</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Mon, Apr 20:<br></blockquote><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
I would really prefer not to author JSON by hand, and the same goes<br>
for YAML. The advantage of generating code from the documentation is<br>
that we can literally "just write" documentation. As of today with<br>
reasonable formatting constraints like "Readable from:" etc in the<br>
vcl-var manual. Adding an indirection would trade a low pain point for<br>
a high one.<br></blockquote><div><br>Good point. <br><br>I think we should just rework <i>vsl2rst.c</i> into <i>vsl2rst.py</i> and add a tbl_parse.py module that reads the X-macro files would solve the problem quite well. That would keep the C code as is, making it still the source of truth, but we'll avoid invoking just compiled binaries to generate the docs, as such skipping any cross-arch problems as python will do the same work on both host and target arch.<br><br>Is a PR implementing this welcome?<br><br><br>Per.</div></div><div><br></div><span class="gmail_signature_prefix">-- </span><br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div>Per Buer</div><div>Varnish Software</div></div></div></div>