Skip to content

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 version 1.5.0-2 reflect build environment directories that do not exist on end-user systems.

Script Comparisons:

  1. 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' "$@"
  2. 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:

  1. Attempt to install awesome-git from AUR using yay -S awesome-git.
  2. 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.

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information