From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 0OJCI3EN4WH/XQAAgWs5BA (envelope-from ) for ; Fri, 14 Jan 2022 06:43:13 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id ILcCHHEN4WHSRQEAG6o9tA (envelope-from ) for ; Fri, 14 Jan 2022 06:43:13 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 0835B2B172 for ; Fri, 14 Jan 2022 06:43:13 +0100 (CET) Received: from localhost ([::1]:59442 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n8FMm-0005Xe-7v for larch@yhetil.org; Fri, 14 Jan 2022 00:43:12 -0500 Received: from eggs.gnu.org ([209.51.188.92]:42330) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n8FMc-0005XH-7l for bug-guix@gnu.org; Fri, 14 Jan 2022 00:43:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:42354) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n8FMb-000655-Tw for bug-guix@gnu.org; Fri, 14 Jan 2022 00:43:01 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n8FMb-0005p8-Sy for bug-guix@gnu.org; Fri, 14 Jan 2022 00:43:01 -0500 X-Loop: help-debbugs@gnu.org Subject: bug#52909: Some man pages are not built correctly Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Fri, 14 Jan 2022 05:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52909 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: Leo Famulari Received: via spool by 52909-submit@debbugs.gnu.org id=B52909.164213895522343 (code B ref 52909); Fri, 14 Jan 2022 05:43:01 +0000 Received: (at 52909) by debbugs.gnu.org; 14 Jan 2022 05:42:35 +0000 Received: from localhost ([127.0.0.1]:35257 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n8FMA-0005oI-VN for submit@debbugs.gnu.org; Fri, 14 Jan 2022 00:42:35 -0500 Received: from mail-io1-f52.google.com ([209.85.166.52]:34548) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n8FM9-0005o3-4T for 52909@debbugs.gnu.org; Fri, 14 Jan 2022 00:42:33 -0500 Received: by mail-io1-f52.google.com with SMTP id z19so5541123ioj.1 for <52909@debbugs.gnu.org>; Thu, 13 Jan 2022 21:42:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=RecIScPLoKByHZ4UlGM6hpao6SjkqTWdl3uxmV4RQ5o=; b=nNHxwfE2sJC02SV1eEHIf48w+v488ErkK3GsZVmU0skbIeqln19QO84hGzNiPjjeZ/ UbKAuwsOa8y1k/pIFwndQ3ZG3Jca4rLoxNzZ1RQNdjMjwaqmYAzETj1p2gBcg3u+i5Mb iFq3ont018nXMsEt9cNxAXqhkh0a6+zovqS/ZIOTrg94K7vp80irzrb2hlDhIFXk4OCb 8eLxt3KQnyVw1d0xmCd2j8Hwxb1m6HMTP06yU3hdInsF/zsGiNyZDBDtNy+pJ9A70TIV Jy+mMOXN12r4wyldjheM/1NSXIzSVUF+2CVowyf8zWyUAFMg2BXAIbMeEiiPf4D4Zji4 6LRA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=RecIScPLoKByHZ4UlGM6hpao6SjkqTWdl3uxmV4RQ5o=; b=LHFmX8h83akESZ4BETZinsN65L0iGI/j25vk5TF6TqGS4Slulwrvqqm5WC0QjLmHuA Br1Na8NxF24zKLLboFu9CQs0z4C6x7tSdETAFg7VRSJQ7AGoB1P419Gi7n7sKXKoryOh MMkAvJIEMzEDEMm7VQb7BOlPwB0SoY/TX+Wi/YRJ7uJ5FGsZA+WA8g78nvSRfdVAtuTY x784qoIv7+yAbf9bq9stue2S3tf46HsmpRoIEijFVI8hGk7aSbhLf0d+2FiWSeUfKzY+ zepgEEe7uThZtwwuiuUDE/Wyrdm7F1IYKnGOSaT1KkHuC1HgXTD0Cb71SGcjefd+Y5xF aiSg== X-Gm-Message-State: AOAM532WBI8FS4HN0Kf4GRmkIYwGLno1gUm6BYydruKW6nX6irHz9oL1 GKes6pgXLwO70M8JjMDEkYm9R/Iy0tjKGA== X-Google-Smtp-Source: ABdhPJzQyqh70cyjfA9HdOpjEi8cXNFRFfIHOHGADMVs/zpfXCTpiU3Hkvqp8sXylSSY9ARytnsiTg== X-Received: by 2002:a05:6638:613:: with SMTP id g19mr3387626jar.20.1642138947142; Thu, 13 Jan 2022 21:42:27 -0800 (PST) Received: from hurd (dsl-152-155.b2b2c.ca. [66.158.152.155]) by smtp.gmail.com with ESMTPSA id p16sm4690586iov.3.2022.01.13.21.42.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 13 Jan 2022 21:42:26 -0800 (PST) From: Maxim Cournoyer References: Date: Fri, 14 Jan 2022 00:42:25 -0500 In-Reply-To: (Leo Famulari's message of "Thu, 30 Dec 2021 19:00:45 -0500") Message-ID: <87wnj2x48u.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: 52909@debbugs.gnu.org Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1642138993; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=RecIScPLoKByHZ4UlGM6hpao6SjkqTWdl3uxmV4RQ5o=; b=XCJbd4BmqkikSS1flWFPHDPnjMNLcxSBkCr28txhP6VaO0wDbKFyK8jeUgp5uWBIjCgi2X duVKMEuP0gfNh8GNgJrAj1Uqt7WgJF+aWrQZ2f3xY+6mqnggRiYnrg60c1bZAKxxm0ChNt 4Y6Aqu/69jRb5JcelmCOcbAP9nEEn4ZpN02YSO9lipqlWZljn0Orqaamp6s44UpHch6mIo rFfkE7RPmkoS66VklAa05cFPj5SnnQETMJVB+i3Mh5aG3QdXVTV8TH768DOukTMntVMvCq FCLcWCSvXOSo3lw9PiTFwblTRc3wcyT3PQeLn9aRHy68NdlPa7tw1pwcZuAmJg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1642138993; a=rsa-sha256; cv=none; b=PWr7s2mBLSHCiXBbMKW7XI2PrulEGAXQE82TdwKeR+Ii+351vUTt2YXUc3tHnwVAbWkUBc GXtppPX20BMFKTEYNYORCcYHdWm7meUaT0mkFJGHVcv0r49AHWEih+OMntMILjDgDCo2h1 K9WdxEmTp2PiLk3cNBq8o8Moq9NEFEXbLhTgrcvOwsf8j5tHrjJG+IrTZgnSpiCCzV1wt5 mRLBY6hhozOfJpJErm0ne1D+3pVvp/+dPWgrMJOm6y8KIFouPHLa0/SQgQM0Cup3ZzbCGm c9z97aPz8G4E5nFB5aJ67HjI1+Hk3Hb+yvLOTiY97hBm9G+U9GsuaGkxJQgslw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=nNHxwfE2; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.32 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=nNHxwfE2; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 0835B2B172 X-Spam-Score: -3.32 X-Migadu-Scanner: scn0.migadu.com X-TUID: KJh8ERdH1t+j Hi Leo, Leo Famulari writes: > On Guix Git commit c7d74a9bccfc1b1274fc8754a6e78bb6887c7fea, at least > some manpages are not being built correctly for packages such as elogind > and gnome-keyring-daemon. Are we seeing raw groff input? I'm not sure of > the technology used here. Thank you for reporting this. I've noticed them too, and somehow thought the technology was broken. The technology is docbook xml and xlstproc to transform the source into man pages (which are in the nroff format, I think). I've read the same kind of issue reported to the bind9 project and its resolution, which was very helpful: https://gitlab.isc.org/isc-projects/bind9/-/issues/2310. It seems it's a DocBook XSL stylesheet problem resolved in https://github.com/docbook/xslt10-stylesheets/pull/111 but not yet released... My first idea was to apply this patch, so I went ahead and made: --8<---------------cut here---------------start------------->8--- modified gnu/packages/docbook.scm @@ -229,6 +229,14 @@ (define name-version "This package provides XSL style sheets for DocBook.") (license (license:x11-style "" "See 'COPYING' file.")))) +(define-public docbook-xsl/fixed + (package/inherit docbook-xsl + (name "docbook-xsl-fixed") + (source (origin + (inherit (package-source docbook-xsl)) + (patches (search-patches + "docbook-xsl-allow-non-namespace-fix.patch")))))) + (define-public docbook-xsl-ns (package (name "docbook-xsl-ns") new file gnu/packages/patches/docbook-xsl-allow-non-namespace-fix.patch @@ -0,0 +1,60 @@ +Retrieved from https://github.com/docbook/xslt10-stylesheets/pull/111. + +diff --git a/common/common.xsl b/common/common.xsl +index 59f51dfd0..80742b6ce 100644 +--- a/common/common.xsl ++++ b/common/common.xsl +@@ -68,7 +68,6 @@ d:subjectset d:substeps d:synopfragment d:table d:tbody d:textobject d:tfoot d:t + d:thead d:tip d:toc d:tocchap d:toclevel1 d:toclevel2 d:toclevel3 d:toclevel4 + d:toclevel5 d:tocpart d:topic d:varargs d:variablelist d:varlistentry d:videodata + d:videoobject d:void d:warning d:subjectset +- + d:classsynopsis + d:constructorsynopsis + d:destructorsynopsis +@@ -81,6 +80,45 @@ d:oointerface + d:simplemsgentry + d:manvolnum + "/> ++ + + + --8<---------------cut here---------------end--------------->8--- Unfortunately the resulting docbook-xsl/fixed package doesn't seem to work. Based on this knowledge (from the same issue linked above): > When using version 1.79.1 or 1.79.2 of the XSL stylesheets, care must > be taken to ensure the namespaced stylesheets are used for generating > BIND documentation. --8<---------------cut here---------------start------------->8--- modified gnu/packages/samba.scm @@ -269,7 +269,7 @@ (define-public samba ("rpcsvc-proto" ,rpcsvc-proto) ; for 'rpcgen' ;; For generating man pages. ("docbook-xml" ,docbook-xml-4.2) - ("docbook-xsl" ,docbook-xsl) + ("docbook-xsl" ,docbook-xsl-ns) ("xsltproc" ,libxslt) ("libxml2" ,libxml2))) ;for XML_CATALOG_FILES (home-page "https://www.samba.org/") --8<---------------cut here---------------end--------------->8--- But that also doesn't work... Ahem... I guess we'll need to wait for Docbook to fix their things and issue a new release, else use one of their snapshots. On an unrelated (to the problem at hand note) I've also realized my confusion in adding a docbook-xsl-ns package. The legacy suffix (1.79.1 and older) )was inverted for 1.79.2 (-ns was removed, so the docbook-xsl *is* namespaced while -nons was added to denote the non-namespaced version). I should probably get rid of this docbook-xsl-ns package unless 1.79.1 is truly needed and replace it by docbook-xsl-nons. I tried to use this with samba but it also didn't work. That's frustrating! Good night, Maxim