Compatibility Issue with `ldoc` Version 1.5.0-2 Breaking `awesome-git` Build
Title: Compatibility Issue with ldoc
Version 1.5.0-2 Breaking awesome-git
Build
Description:
The installation of awesome-git
via AUR fails due to an error related to the ldoc
package version 1.5.0-2
. The issue appears to stem from incorrect path configurations in the /usr/bin/ldoc
script introduced in the latest update.
Detailed Problem Description:
-
Error Message:
/usr/bin/lua5.4: cannot open /build/ldoc/pkg/ldoc/usr/lib/luarocks/rocks-5.4/ldoc/1.5.0-1/bin/ldoc: No such file or directory
-
Suspected Cause: The paths specified in the
/usr/bin/ldoc
script of version1.5.0-2
reflect build environment directories that do not exist on end-user systems.
Script Comparisons:
-
In ldoc-1.5.0-1:
#!/bin/sh LUAROCKS_SYSCONFDIR='/etc/luarocks' exec '/usr/bin/lua5.4' -e 'package.path=";"..package.path;package.cpath=";"..package.cpath;local k,l,_=pcall(require,"luarocks.loader") _=k and l.add_context("ldoc","1.5.0-1")' '/usr/lib/luarocks/rocks-5.4/ldoc/1.5.0-1/bin/ldoc' "$@"
-
In ldoc-1.5.0-2:
#!/bin/sh LUAROCKS_SYSCONFDIR='/etc/luarocks' exec '/usr/bin/lua5.4' -e 'package.path="/usr/share/lua/5.4/?.lua;/build/ldoc/pkg/ldoc/usr/share/lua/5.4/?/init.lua;/build/.luarocks/share/lua/5.4/?.lua;/build/.luarocks/share/lua/5.4/?/init.lua;/usr/share/lua/5.4/?.lua;/usr/share/lua/5.4/?/init.lua;"..package.path;package.cpath="/build/ldoc/pkg/ldoc/usr/lib/lua/5.4/?.so;/build/.luarocks/lib/lua/5.4/?.so;/usr/lib/lua/5.4/?.so;"..package.cpath;local k,l,_=pcall(require,"luarocks.loader") _=k and l.add_context("ldoc","1.5.0-1")' '/build/ldoc/pkg/ldoc/usr/lib/luarocks/rocks-5.4/ldoc/1.5.0-1/bin/ldoc' "$@"
Analysis:
The updated script for ldoc-1.5.0-2
includes paths such as /build/ldoc/pkg/ldoc/...
, which are specific to the package build environment and do not exist in a typical user installation. This misconfiguration results in the reported error during the build process of awesome-git
.
Steps to Reproduce:
- Attempt to install
awesome-git
from AUR usingyay -S awesome-git
. - Note the build failure at the stage where
ldoc
is invoked.
Expected Behavior:
The build process for awesome-git
should complete without errors, particularly those stemming from documentation generation tools like ldoc
.
Actual Behavior:
The awesome-git
build process is interrupted by an error due to misconfigured paths in the ldoc
script.
Temporary Workaround:
Downgrading to ldoc
version 1.4.6
allows the build to complete successfully. Alternatively, manually correcting the path in the ldoc
script of version 1.5.0-2
also resolves the issue.
Requested Action:
Please review and adjust the path configurations in the /usr/bin/ldoc
script for version 1.5.0-2
to align with standard user environment paths. This correction is crucial for ensuring the compatibility of ldoc
with packages that depend on it, such as awesome-git
.
Additional Notes: The issue has been reproduced and confirmed by multiple Arch users under similar conditions. The path error seems to be a result of improper isolation of build environment paths into the deployment package.