mbox series

[0/6] Updates around the UNPACKDIR variable

Message ID 20250218-overview-figures-v1-0-75d23b5e7a88@bootlin.com
Headers show
Series Updates around the UNPACKDIR variable | expand

Message

Antonin Godard Feb. 18, 2025, 9:11 a.m. UTC 
In the overview manual, for images that should mention UNPACKDIR, update
them to SVGs. Using SVGs will allow maintainers to grep for variables
and find it in SVGs images, since they are text. It also renders them
much better in the doc.

Preview the files here:

https://lufi.bootlin.com/r/wRQmbAvsew#U/AfVq1d88D9hE7Dp2jPHoRzSY6NN5F/2ar+Bki5u3U=
https://lufi.bootlin.com/r/fG3m9UF9DH#6cs07TfeggRurNR/ohUd8y7hGQ3McD0rBV1ip13XWKI=
https://lufi.bootlin.com/r/MJzY5kNWA4#+tBsGlCLQpx9tFB33wJtCbdXjO06TTAzlIDM9OgLm+Y=
https://lufi.bootlin.com/r/xjExs3h2Ht#98BQnm2Tj0ZVoS9NZdCOGbV8KqdTNGt19QRcIZ+UVZU=

The last patches attempt at clarifying the purpose of the UNPACKDIR
variable. The overview manual being an overview, I've phrased the
paragraph to remain simple and straightforward.

The last patch modifies the reference manual so that:

1. It gives advice on how S and UNPACKDIR should be set.
2. Explain the directory move behavior when a subdirectory of S matched
   one in UNPACKDIR.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Antonin Godard (6):
      overview-manual: convert source-fetching.png to svg and fix UNPACKDIR
      overview-manual: convert patching.png to svg
      overview-manual: convert configuration-compile-autoreconf.png to svg
      overview-manual: convert analysis-for-package-splitting.png to svg
      overview-manual: add UNPACKDIR in the directory description
      ref-manual/variables: improve the UNPACKDIR documentation

 documentation/overview-manual/concepts.rst         |   24 +-
 .../figures/analysis-for-package-splitting.png     |  Bin 68434 -> 0 bytes
 .../figures/configuration-compile-autoreconf.png   |  Bin 70877 -> 0 bytes
 documentation/overview-manual/figures/patching.png |  Bin 57414 -> 0 bytes
 .../overview-manual/figures/source-fetching.png    |  Bin 46896 -> 0 bytes
 .../svg/analysis-for-package-splitting.svg         | 2111 ++++++++++++++++++++
 .../svg/configuration-compile-autoreconf.svg       | 1561 +++++++++++++++
 documentation/overview-manual/svg/patching.svg     | 1350 +++++++++++++
 .../overview-manual/svg/source-fetching.svg        | 1220 +++++++++++
 documentation/ref-manual/variables.rst             |   39 +-
 10 files changed, 6292 insertions(+), 13 deletions(-)
---
base-commit: 6eda443c7fcfeecebd6b44b96a1587c4bb093a34
change-id: 20250217-overview-figures-ead01baaeebf

Best regards,