Getting cross compilation to work.

Per Buer per.buer at varnish-software.com
Mon Apr 20 13:53:50 UTC 2026


Hi,

On Mon, Apr 20, 2026 at 12:07 PM Dridi Boukelmoune <dridi at varni.sh> wrote:

> On Mon, Apr 20:
>


> I would really prefer not to author JSON by hand, and the same goes
> for YAML. The advantage of generating code from the documentation is
> that we can literally "just write" documentation. As of today with
> reasonable formatting constraints like "Readable from:" etc in the
> vcl-var manual. Adding an indirection would trade a low pain point for
> a high one.
>

Good point.

I think we should just rework *vsl2rst.c* into *vsl2rst.py* 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.

Is a PR implementing this welcome?


Per.

-- 
Per Buer
Varnish Software
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://vinyl-cache.org/lists/pipermail/vinyl-dev/attachments/20260420/a94849b6/attachment.html>


More information about the vinyl-dev mailing list