Mathieu Benoit
a8eef0e460
libevent: mv: cannot stat '<pkgdir>/usr/share/doc': No such file or directory pam: rm: cannot remove '.../Linux-PAM/*.pdf': No such file or directory Both are hooks I wrote in this session, and both stopped a build in exactly the way this port has documented eight times: the documentation build was disabled and its install was left in place. Turning EVENT__DOXYGEN off does not stop package() moving usr/share/doc into the libevent-doc split; -Ddocs=disabled does not stop pam deleting PDFs it no longer produces. fakeroot was the first one I made myself. This makes three, so the rule is worth stating instead of rediscovering: after disabling documentation anywhere, search package() for share/doc, man, and the split arrays before believing the hook is finished. pam's rm becomes tolerant rather than deleted -- on a machine with the DocBook stack the PDFs are real, and the comment above the line says why they must go: they are not reproducible. --- FR --- libevent: mv: cannot stat '<pkgdir>/usr/share/doc': No such file or directory pam: rm: cannot remove '.../Linux-PAM/*.pdf': No such file or directory Deux hooks que j'ai écrits dans cette session, et deux arrêts de construction de la façon exacte que ce portage a documentée huit fois : la construction de la documentation désactivée, son installation laissée en place. Éteindre EVENT__DOXYGEN n'empêche pas package() de déplacer usr/share/doc vers le sous-paquet libevent-doc ; -Ddocs=disabled n'empêche pas pam de supprimer des PDF qu'il ne produit plus. fakeroot fut le premier de ma main. Cela en fait trois : la règle mérite d'être énoncée plutôt que redécouverte — après avoir désactivé une documentation, chercher dans package() share/doc, man, et les tableaux de sous-paquets avant de croire le hook terminé. Le rm de pam devient tolérant plutôt que supprimé : sur une machine dotée de la pile DocBook les PDF existent, et le commentaire au-dessus dit pourquoi ils doivent partir — ils ne sont pas reproductibles. Assisted-by: Claude Opus 5
52 lines
2.4 KiB
Bash
Executable file
52 lines
2.4 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# pam: no XML documentation.
|
|
#
|
|
# meson.build:42:2: ERROR: Command `/usr/bin/xmllint --nonet --noout ...`
|
|
#
|
|
# xmllint EXISTS here -- it comes from our libxml2 -- and that is what makes this
|
|
# one different from the other documentation failures. It fails because pam
|
|
# validates its DocBook sources against DTDs that are not installed, and
|
|
# --nonet forbids fetching them. Shipping the DocBook XML data would be a
|
|
# package; disabling the documentation is a flag.
|
|
set -euo pipefail
|
|
python3 - <<'ZZPY'
|
|
import io, re
|
|
lines = io.open("PKGBUILD", encoding="utf-8").read().split("\n")
|
|
hit = [i for i, l in enumerate(lines) if re.search(r"^[ \t]*-Dselinux=disabled", l)]
|
|
assert len(hit) == 1, "pam: expected one -Dselinux option line, got %d" % len(hit)
|
|
i = hit[0]
|
|
ind = re.match(r"^[ \t]*", lines[i]).group(0)
|
|
assert lines[i].rstrip().endswith("\\"), "pam: the option list does not continue"
|
|
lines.insert(i + 1, ind + "-Ddocs=disabled \\")
|
|
io.open("PKGBUILD", "w", encoding="utf-8").write("\n".join(lines))
|
|
ZZPY
|
|
grep -q -- "-Ddocs=disabled" PKGBUILD || { echo "pam: docs not disabled" >&2; exit 1; }
|
|
echo "pam: DocBook documentation disabled"
|
|
|
|
# --- and the PDFs it no longer produces ---------------------------------------
|
|
#
|
|
# rm: cannot remove '<pkgdir>/usr/share/doc/Linux-PAM/*.pdf': No such file
|
|
#
|
|
# The line above it says why it exists:
|
|
#
|
|
# # remove unreproducible pdf files
|
|
#
|
|
# pam builds PDFs whose bytes differ between runs, so the PKGBUILD deletes them
|
|
# to keep the package reproducible. With -Ddocs=disabled they are never built,
|
|
# and a cleanup step that finds nothing to clean is fatal under set -e.
|
|
#
|
|
# The rm becomes tolerant rather than being deleted: on a machine that does have
|
|
# the DocBook stack, the PDFs WILL be there and they still have to go.
|
|
python3 - <<'ZZPY'
|
|
import io, re
|
|
lines = io.open("PKGBUILD", encoding="utf-8").read().split("\n")
|
|
hit = [i for i, l in enumerate(lines) if re.search(r"\*\.pdf", l) and l.lstrip().startswith("rm ")]
|
|
assert len(hit) == 1, "pam: expected one pdf removal, got %d" % len(hit)
|
|
i = hit[0]
|
|
ind = re.match(r"^[ \t]*", lines[i]).group(0)
|
|
lines[i] = ind + "rm -f " + lines[i].lstrip()[3:].lstrip()
|
|
io.open("PKGBUILD", "w", encoding="utf-8").write("\n".join(lines))
|
|
ZZPY
|
|
grep -qE "^[[:space:]]*rm -f .*\*\.pdf" PKGBUILD || {
|
|
echo "pam: the pdf removal was not made tolerant" >&2; exit 1; }
|
|
echo "pam: PDF cleanup tolerates their absence"
|