From 4469fe176118607f1a1dbcbbe5de57f9156e293f Mon Sep 17 00:00:00 2001 From: Daniel Gustafsson Date: Fri, 13 Feb 2026 11:50:17 +0100 Subject: [PATCH] doc: Update docs images README with required ditaa version The URL for Ditaa linked to the old Sourceforge version which is too old for what we need, the fork over on Github is the correct version to use for re-generating the SVG files for the docs. The required Ditaa version is 0.11.0 as it when SVG support as added. Running the version found on Sourceforge produce the error below: $ ditaa -E -S --svg in.txt out.txt Unrecognized option: --svg usage: ditaa [OUTFILE] [-A] [-b ] [-d] [-E] [-e ] [-h] [--help] [-o] [-r] [-S] [-s ] [-T] [-t ] [-v] [-W] While there, also mention that meson rules exists for building images. Author: Nazir Bilal Yavuz Reviewed-by: Daniel Gustafsson Reviewed-by: Paul A Jungwirth Discussion: https://postgr.es/m/CAN55FZ2O-23xERF2NYcvv9DM_1c9T16y6mi3vyP=O1iuXS0ASA@mail.gmail.com --- doc/src/sgml/images/README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/src/sgml/images/README b/doc/src/sgml/images/README index 07c45802553..93b75485c44 100644 --- a/doc/src/sgml/images/README +++ b/doc/src/sgml/images/README @@ -13,14 +13,14 @@ involve diffable source files. These tools are acceptable: - Graphviz (https://graphviz.org/) -- Ditaa (http://ditaa.sourceforge.net/) +- Ditaa v0.11.0 or later (https://github.com/stathissideris/ditaa) We use SVG as the format for integrating the image into the ultimate output formats of the documentation, that is, HTML, PDF, and others. Therefore, any tool used needs to be able to produce SVG. -This directory contains makefile rules to build SVG from common input -formats, using some common styling. +This directory contains makefile and meson rules to build SVG from common +input formats, using some common styling. fixup-svg.xsl applies some postprocessing to the SVG files produced by those external tools to address assorted issues. See comments in -- 2.47.3