man-pages: 6.9.1 → 6.11; clean up & provide update script (#382390)

  lib,

  stdenv,

  fetchurl,

  directoryListingUpdater,

  man,

}:

stdenv.mkDerivation rec {

stdenv.mkDerivation (finalAttrs: {

  pname = "man-pages";

  version = "6.9.1";

  version = "6.11";

  src = fetchurl {

    url = "mirror://kernel/linux/docs/man-pages/${pname}-${version}.tar.xz";

    hash = "sha256-4jy6wp8RC6Vx8NqFI+edNzaRRm7X8qMTAXIYF9NFML0=";

    url = "mirror://kernel/linux/docs/man-pages/man-pages-${finalAttrs.version}.tar.xz";

    hash = "sha256-3aou2i6NKG++wiHRFfEtP/9dNsxQZs3+zI0koljVixk=";

  };

  nativeInstallCheckInputs = [ man ];

  dontBuild = true;

  enableParallelInstalling = true;

  doInstallCheck = true;

  makeFlags = [

    "-R"

    "VERSION=${finalAttrs.version}"

    "prefix=${placeholder "out"}"

  ];

  dontBuild = true;

  preConfigure = ''

    # If not provided externally, the makefile will attempt to determine the

    # date and time of the release from the Git repository log, which is not

    # available in the distributed tarball. We therefore supply it from

    # $SOURCE_DATE_EPOCH, which is based on the most recent modification time

    # of all source files. Cf.

    # nixpkgs/pkgs/build-support/setup-hooks/set-source-date-epoch-to-latest.sh

    export DISTDATE="$(date --utc --date="@$SOURCE_DATE_EPOCH")"

  '';

  outputDocdev = "out";

  installCheckPhase = ''

    runHook preInstallCheck

  enableParallelInstalling = true;

    # Check for a few well‐known man pages

    for page in ldd write printf null hosts random ld.so; do

      man -M "$out/share/man" -P cat "$page" >/dev/null

    done

  postInstall = ''

    # The manpath executable looks up manpages from PATH. And this package won't

    # appear in PATH unless it has a /bin folder. Without the change

    # 'nix-shell -p man-pages' does not pull in the search paths.

    # See 'man 5 manpath' for the lookup order.

    mkdir -p $out/bin

    runHook postInstallCheck

  '';

  meta = with lib; {

  passthru.updateScript = directoryListingUpdater {

    url = "https://www.kernel.org/pub/linux/docs/man-pages/";

  };

  meta = {

    description = "Linux development manual pages";

    homepage = "https://www.kernel.org/doc/man-pages/";

    license = licenses.gpl2Plus;

    platforms = with platforms; unix;

    license = lib.licenses.gpl2Plus;

    platforms = lib.platforms.unix;

    priority = 30; # if a package comes with its own man page, prefer it

  };

}

})