[FIX] four more packages that build without their documentation
git, xz, meson and pam. Each uses the project's own switch where one exists.
git is the one worth reading: `man` appears as a make target twice and
`install-man` twice, once each for git proper and once for contrib/subtree.
Removing the build targets and leaving the install targets gives "No rule to
make target 'install-man'", which reads like a broken Makefile. Four places,
again.
pam is different in kind from the others: xmllint EXISTS here, from our own
libxml2. 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.
--- FR ---
git, xz, meson et pam. Chacun par l'interrupteur du projet lui-même, quand il
existe.
git mérite lecture : `man` figure deux fois comme cible make et `install-man`
deux fois, une paire pour git et une pour contrib/subtree. Retirer les cibles de
construction en laissant celles d'installation donne « No rule to make target
'install-man' », ce qui se lit comme un Makefile cassé. Quatre endroits, encore.
pam diffère en nature : xmllint EXISTE ici, il vient de notre libxml2. Il échoue
parce que pam valide ses sources DocBook contre des DTD non installées, et que
--nonet interdit de les chercher. Livrer les données DocBook serait un paquet ;
désactiver la documentation est un drapeau.
Assisted-by: Claude Opus 5
2026-08-22 00:07:14 -04:00
|
|
|
#!/usr/bin/env bash
|
|
|
|
|
# xz: autogen.sh without po4a.
|
|
|
|
|
#
|
|
|
|
|
# po4a/update-po: Translated man pages were not generated.
|
|
|
|
|
# ==> ERROR: A failure occurred in prepare().
|
|
|
|
|
#
|
|
|
|
|
# prepare() runs only `./autogen.sh`, and that script regenerates the translated
|
|
|
|
|
# man pages with po4a -- a Perl toolchain this port declined along with the rest
|
|
|
|
|
# of the documentation stack. xz's autogen.sh takes --no-po4a for exactly this,
|
|
|
|
|
# so the switch is upstream's, not ours.
|
|
|
|
|
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.match(r"^[ \t]*\./autogen\.sh[ \t]*$", l)]
|
|
|
|
|
assert len(hit) == 1, "xz: expected one bare ./autogen.sh, got %d" % len(hit)
|
|
|
|
|
lines[hit[0]] = lines[hit[0]].rstrip() + " --no-po4a"
|
|
|
|
|
io.open("PKGBUILD", "w", encoding="utf-8").write("\n".join(lines))
|
|
|
|
|
ZZPY
|
|
|
|
|
grep -q -- "autogen.sh --no-po4a" PKGBUILD || {
|
|
|
|
|
echo "xz: --no-po4a was not added" >&2; exit 1; }
|
|
|
|
|
echo "xz: translated man pages skipped"
|
[FIX] xz has two doc toolchains, and libpsl needs data not a tool
xz got past po4a and stopped on
../../../doxygen/update-doxygen: doxygen command not found
Two documentation toolchains in one package: po4a for the translated man pages,
doxygen for the liblzma API reference. --disable-doc is xz own switch, checked
present in configure before use.
libpsl stopped on
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list is DATA. libpsl compiles the Public Suffix List into a lookup
table, so the list is an input to the build -- the first entry in this port whose
absence is neither a program nor a library, and it reads exactly like a broken
Makefile.
--- FR ---
xz a passe po4a et s est arrete sur
../../../doxygen/update-doxygen: doxygen command not found
Deux chaines de documentation dans un seul paquet : po4a pour les pages de manuel
traduites, doxygen pour la reference d API de liblzma. --disable-doc est son
propre interrupteur, verifie present dans configure avant usage.
libpsl s est arrete sur
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list est une DONNEE. libpsl compile la Public Suffix List en table
de correspondance : la liste est une entree de la construction — premiere entree
de ce portage dont l absence n est ni un programme ni une bibliotheque, et elle se
lit exactement comme un Makefile casse.
Assisted-by: Claude Opus 5
2026-08-23 20:19:45 -04:00
|
|
|
|
|
|
|
|
# --- and no doxygen API reference ---------------------------------------------
|
|
|
|
|
#
|
[FIX] xz: the flag was already there, and lost to position
--disable-doxygen was added and doxygen still ran. config.log recorded why:
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
The PKGBUILD passes --enable-doxygen further along the same line, and autoconf
takes the LAST occurrence. The first version of this section inserted its flag
right after ./configure, where it could only lose.
This port had already learned the rule from the other side: the arch-meson
wrapper APPENDS --auto-features auto precisely so it wins. Here the same fact was
applied backwards, and the symptom was indistinguishable from a flag that does
not exist -- which is what sent the search through configure's own logic first,
where the default turned out to be `no` all along.
The existing option is flipped in place rather than a second one added. One
statement per decision: two contradictory flags on one command line is how the
next reader spends an hour in config.log.
--- FR ---
--disable-doxygen avait été ajouté et doxygen tournait encore. config.log en
donnait la raison :
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
Le PKGBUILD passe --enable-doxygen plus loin sur la même ligne, et autoconf retient
la DERNIÈRE occurrence. La première version de cette section insérait son drapeau
juste après ./configure, là où il ne pouvait que perdre.
Ce portage avait déjà appris la règle par l'autre bout : l'enveloppe arch-meson
AJOUTE --auto-features auto à la fin précisément pour gagner. Ici le même fait a
été appliqué à l'envers, et le symptôme était indiscernable d'un drapeau
inexistant — ce qui a d'abord envoyé la recherche dans la logique de configure, où
le défaut s'est avéré être « no » depuis le début.
L'option existante est retournée sur place plutôt qu'une seconde ajoutée. Une
décision, une ligne : deux drapeaux contradictoires sur une même commande, c'est
une heure de config.log pour le prochain lecteur.
Assisted-by: Claude Opus 5
2026-08-23 23:44:36 -04:00
|
|
|
# Two documentation toolchains in one package: po4a above for the translated man
|
|
|
|
|
# pages, doxygen for the liblzma API reference.
|
[FIX] xz has two doc toolchains, and libpsl needs data not a tool
xz got past po4a and stopped on
../../../doxygen/update-doxygen: doxygen command not found
Two documentation toolchains in one package: po4a for the translated man pages,
doxygen for the liblzma API reference. --disable-doc is xz own switch, checked
present in configure before use.
libpsl stopped on
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list is DATA. libpsl compiles the Public Suffix List into a lookup
table, so the list is an input to the build -- the first entry in this port whose
absence is neither a program nor a library, and it reads exactly like a broken
Makefile.
--- FR ---
xz a passe po4a et s est arrete sur
../../../doxygen/update-doxygen: doxygen command not found
Deux chaines de documentation dans un seul paquet : po4a pour les pages de manuel
traduites, doxygen pour la reference d API de liblzma. --disable-doc est son
propre interrupteur, verifie present dans configure avant usage.
libpsl s est arrete sur
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list est une DONNEE. libpsl compile la Public Suffix List en table
de correspondance : la liste est une entree de la construction — premiere entree
de ce portage dont l absence n est ni un programme ni une bibliotheque, et elle se
lit exactement comme un Makefile casse.
Assisted-by: Claude Opus 5
2026-08-23 20:19:45 -04:00
|
|
|
#
|
|
|
|
|
# ../../../doxygen/update-doxygen: 'doxygen' command not found
|
|
|
|
|
# make[4]: *** [Makefile:642: ../../../doc/api/index.html] Error 1
|
|
|
|
|
#
|
[FIX] xz: the flag was already there, and lost to position
--disable-doxygen was added and doxygen still ran. config.log recorded why:
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
The PKGBUILD passes --enable-doxygen further along the same line, and autoconf
takes the LAST occurrence. The first version of this section inserted its flag
right after ./configure, where it could only lose.
This port had already learned the rule from the other side: the arch-meson
wrapper APPENDS --auto-features auto precisely so it wins. Here the same fact was
applied backwards, and the symptom was indistinguishable from a flag that does
not exist -- which is what sent the search through configure's own logic first,
where the default turned out to be `no` all along.
The existing option is flipped in place rather than a second one added. One
statement per decision: two contradictory flags on one command line is how the
next reader spends an hour in config.log.
--- FR ---
--disable-doxygen avait été ajouté et doxygen tournait encore. config.log en
donnait la raison :
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
Le PKGBUILD passe --enable-doxygen plus loin sur la même ligne, et autoconf retient
la DERNIÈRE occurrence. La première version de cette section insérait son drapeau
juste après ./configure, là où il ne pouvait que perdre.
Ce portage avait déjà appris la règle par l'autre bout : l'enveloppe arch-meson
AJOUTE --auto-features auto à la fin précisément pour gagner. Ici le même fait a
été appliqué à l'envers, et le symptôme était indiscernable d'un drapeau
inexistant — ce qui a d'abord envoyé la recherche dans la logique de configure, où
le défaut s'est avéré être « no » depuis le début.
L'option existante est retournée sur place plutôt qu'une seconde ajoutée. Une
décision, une ligne : deux drapeaux contradictoires sur une même commande, c'est
une heure de config.log pour le prochain lecteur.
Assisted-by: Claude Opus 5
2026-08-23 23:44:36 -04:00
|
|
|
# THE FLAG WAS ALREADY THERE, AND LOST. The first version of this section
|
|
|
|
|
# inserted --disable-doxygen right after ./configure, and config.log recorded what
|
|
|
|
|
# actually happened:
|
|
|
|
|
#
|
|
|
|
|
# $ ./configure --disable-doc --disable-doxygen --prefix=/usr \
|
|
|
|
|
# --disable-rpath --enable-doxygen --enable-werror
|
|
|
|
|
#
|
|
|
|
|
# The PKGBUILD passes --enable-doxygen further along the same line, and autoconf
|
|
|
|
|
# takes the LAST occurrence. The port had already learned this from the other
|
|
|
|
|
# side -- the arch-meson wrapper APPENDS --auto-features auto precisely so it
|
|
|
|
|
# wins -- and this got it backwards.
|
|
|
|
|
#
|
|
|
|
|
# The existing option is flipped in place rather than a second one added. One
|
|
|
|
|
# statement per decision: two contradictory flags on one command line is how the
|
|
|
|
|
# next reader spends an hour in config.log.
|
|
|
|
|
#
|
|
|
|
|
# Note for later: --enable-werror is on that same line. It has not bitten yet.
|
[FIX] xz has two doc toolchains, and libpsl needs data not a tool
xz got past po4a and stopped on
../../../doxygen/update-doxygen: doxygen command not found
Two documentation toolchains in one package: po4a for the translated man pages,
doxygen for the liblzma API reference. --disable-doc is xz own switch, checked
present in configure before use.
libpsl stopped on
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list is DATA. libpsl compiles the Public Suffix List into a lookup
table, so the list is an input to the build -- the first entry in this port whose
absence is neither a program nor a library, and it reads exactly like a broken
Makefile.
--- FR ---
xz a passe po4a et s est arrete sur
../../../doxygen/update-doxygen: doxygen command not found
Deux chaines de documentation dans un seul paquet : po4a pour les pages de manuel
traduites, doxygen pour la reference d API de liblzma. --disable-doc est son
propre interrupteur, verifie present dans configure avant usage.
libpsl s est arrete sur
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list est une DONNEE. libpsl compile la Public Suffix List en table
de correspondance : la liste est une entree de la construction — premiere entree
de ce portage dont l absence n est ni un programme ni une bibliotheque, et elle se
lit exactement comme un Makefile casse.
Assisted-by: Claude Opus 5
2026-08-23 20:19:45 -04:00
|
|
|
set -euo pipefail
|
|
|
|
|
python3 - <<'ZZPY'
|
|
|
|
|
import io, re
|
|
|
|
|
lines = io.open("PKGBUILD", encoding="utf-8").read().split("\n")
|
[FIX] xz: the flag was already there, and lost to position
--disable-doxygen was added and doxygen still ran. config.log recorded why:
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
The PKGBUILD passes --enable-doxygen further along the same line, and autoconf
takes the LAST occurrence. The first version of this section inserted its flag
right after ./configure, where it could only lose.
This port had already learned the rule from the other side: the arch-meson
wrapper APPENDS --auto-features auto precisely so it wins. Here the same fact was
applied backwards, and the symptom was indistinguishable from a flag that does
not exist -- which is what sent the search through configure's own logic first,
where the default turned out to be `no` all along.
The existing option is flipped in place rather than a second one added. One
statement per decision: two contradictory flags on one command line is how the
next reader spends an hour in config.log.
--- FR ---
--disable-doxygen avait été ajouté et doxygen tournait encore. config.log en
donnait la raison :
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
Le PKGBUILD passe --enable-doxygen plus loin sur la même ligne, et autoconf retient
la DERNIÈRE occurrence. La première version de cette section insérait son drapeau
juste après ./configure, là où il ne pouvait que perdre.
Ce portage avait déjà appris la règle par l'autre bout : l'enveloppe arch-meson
AJOUTE --auto-features auto à la fin précisément pour gagner. Ici le même fait a
été appliqué à l'envers, et le symptôme était indiscernable d'un drapeau
inexistant — ce qui a d'abord envoyé la recherche dans la logique de configure, où
le défaut s'est avéré être « no » depuis le début.
L'option existante est retournée sur place plutôt qu'une seconde ajoutée. Une
décision, une ligne : deux drapeaux contradictoires sur une même commande, c'est
une heure de config.log pour le prochain lecteur.
Assisted-by: Claude Opus 5
2026-08-23 23:44:36 -04:00
|
|
|
hit = [i for i, l in enumerate(lines) if re.search(r"--enable-doxygen\b", l)]
|
|
|
|
|
assert len(hit) == 1, "xz: expected one --enable-doxygen, got %d" % len(hit)
|
|
|
|
|
lines[hit[0]] = lines[hit[0]].replace("--enable-doxygen", "--disable-doxygen")
|
[FIX] xz has two doc toolchains, and libpsl needs data not a tool
xz got past po4a and stopped on
../../../doxygen/update-doxygen: doxygen command not found
Two documentation toolchains in one package: po4a for the translated man pages,
doxygen for the liblzma API reference. --disable-doc is xz own switch, checked
present in configure before use.
libpsl stopped on
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list is DATA. libpsl compiles the Public Suffix List into a lookup
table, so the list is an input to the build -- the first entry in this port whose
absence is neither a program nor a library, and it reads exactly like a broken
Makefile.
--- FR ---
xz a passe po4a et s est arrete sur
../../../doxygen/update-doxygen: doxygen command not found
Deux chaines de documentation dans un seul paquet : po4a pour les pages de manuel
traduites, doxygen pour la reference d API de liblzma. --disable-doc est son
propre interrupteur, verifie present dans configure avant usage.
libpsl s est arrete sur
make: *** No rule to make target
/usr/share/publicsuffix/effective_tld_names.dat, needed by ...
publicsuffix-list est une DONNEE. libpsl compile la Public Suffix List en table
de correspondance : la liste est une entree de la construction — premiere entree
de ce portage dont l absence n est ni un programme ni une bibliotheque, et elle se
lit exactement comme un Makefile casse.
Assisted-by: Claude Opus 5
2026-08-23 20:19:45 -04:00
|
|
|
io.open("PKGBUILD", "w", encoding="utf-8").write("\n".join(lines))
|
|
|
|
|
ZZPY
|
[FIX] xz: the flag was already there, and lost to position
--disable-doxygen was added and doxygen still ran. config.log recorded why:
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
The PKGBUILD passes --enable-doxygen further along the same line, and autoconf
takes the LAST occurrence. The first version of this section inserted its flag
right after ./configure, where it could only lose.
This port had already learned the rule from the other side: the arch-meson
wrapper APPENDS --auto-features auto precisely so it wins. Here the same fact was
applied backwards, and the symptom was indistinguishable from a flag that does
not exist -- which is what sent the search through configure's own logic first,
where the default turned out to be `no` all along.
The existing option is flipped in place rather than a second one added. One
statement per decision: two contradictory flags on one command line is how the
next reader spends an hour in config.log.
--- FR ---
--disable-doxygen avait été ajouté et doxygen tournait encore. config.log en
donnait la raison :
$ ./configure --disable-doc --disable-doxygen --prefix=/usr \
--disable-rpath --enable-doxygen --enable-werror
Le PKGBUILD passe --enable-doxygen plus loin sur la même ligne, et autoconf retient
la DERNIÈRE occurrence. La première version de cette section insérait son drapeau
juste après ./configure, là où il ne pouvait que perdre.
Ce portage avait déjà appris la règle par l'autre bout : l'enveloppe arch-meson
AJOUTE --auto-features auto à la fin précisément pour gagner. Ici le même fait a
été appliqué à l'envers, et le symptôme était indiscernable d'un drapeau
inexistant — ce qui a d'abord envoyé la recherche dans la logique de configure, où
le défaut s'est avéré être « no » depuis le début.
L'option existante est retournée sur place plutôt qu'une seconde ajoutée. Une
décision, une ligne : deux drapeaux contradictoires sur une même commande, c'est
une heure de config.log pour le prochain lecteur.
Assisted-by: Claude Opus 5
2026-08-23 23:44:36 -04:00
|
|
|
grep -q -- "--enable-doxygen" PKGBUILD && { echo "xz: --enable-doxygen survived" >&2; exit 1; }
|
|
|
|
|
grep -q -- "--disable-doxygen" PKGBUILD || { echo "xz: doxygen not disabled" >&2; exit 1; }
|
|
|
|
|
# One occurrence only: a line carrying both would be decided by position.
|
|
|
|
|
n=$(grep -c -- "--disable-doxygen" PKGBUILD)
|
|
|
|
|
[ "$n" = 1 ] || { echo "xz: expected 1 --disable-doxygen, found $n" >&2; exit 1; }
|
|
|
|
|
echo "xz: doxygen disabled by flipping the flag the PKGBUILD already passes"
|