From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors Date: Thu, 1 Dec 2022 07:02:16 -0800 Message-ID: References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="000000000000d4dbab05eec5819e" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4429"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 59631@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Dec 01 16:03:15 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1p0l5n-0000sb-7z for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 01 Dec 2022 16:03:15 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p0l5f-0000fF-RJ; Thu, 01 Dec 2022 10:03:07 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p0l5c-0000ZA-EP for bug-gnu-emacs@gnu.org; Thu, 01 Dec 2022 10:03:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p0l5c-0004ij-5Q for bug-gnu-emacs@gnu.org; Thu, 01 Dec 2022 10:03:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p0l5b-0008Sm-0k for bug-gnu-emacs@gnu.org; Thu, 01 Dec 2022 10:03:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 01 Dec 2022 15:03:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59631 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 59631-submit@debbugs.gnu.org id=B59631.166990696232504 (code B ref 59631); Thu, 01 Dec 2022 15:03:02 +0000 Original-Received: (at 59631) by debbugs.gnu.org; 1 Dec 2022 15:02:42 +0000 Original-Received: from localhost ([127.0.0.1]:40163 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p0l51-0008SA-4h for submit@debbugs.gnu.org; Thu, 01 Dec 2022 10:02:42 -0500 Original-Received: from mail-ot1-f54.google.com ([209.85.210.54]:46718) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p0l4y-0008S3-5a for 59631@debbugs.gnu.org; Thu, 01 Dec 2022 10:02:25 -0500 Original-Received: by mail-ot1-f54.google.com with SMTP id m7-20020a9d6447000000b0066da0504b5eso1091283otl.13 for <59631@debbugs.gnu.org>; Thu, 01 Dec 2022 07:02:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=z5UNtCZJEajVzfGjZsPFxeDmfHgdEBt7qrZOLbovL4M=; b=FQNJ/rH+hA3FSrkbH0Dk3bLa4Xqpb6/zOdGgehdPTiBMnEYN4uivnpGPA6ppEv1RaO 93DZq2Yx+6qeYo3EINQ+XzqcwoO1WbGlleY/eg6TXu6eXZa9QGKIIZoFqc//r8U80IYc 3iCjUtRgo0X39jClUgO0t6ElNQSiyYdqsbq47Sg1yxxJdSaXud1DNrTgBbaZkLKTs3Ji ydnrCFauPIWsb0KSNJIyyTkYq6q9nES0KCTW61XfQuyhLGOzvVUrShiPOzqVegaO4mAk iC440pqkvaV/vVSjvwcOF2hB/I0ekG+5kwHpsDhOzDjPscV7eL6lNHdWooyJii5xgd+g H/7Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=z5UNtCZJEajVzfGjZsPFxeDmfHgdEBt7qrZOLbovL4M=; b=C7THMFp1jXHwN0qAmmQsl4szCHz36e0zLvvumvIHjnSjEEbB1bilq4GuT9SJm96+BV Hk8Z9aB2tNLmgkGT86D70EY4KGp6hfLNsVDvfBdtqc+soYHjdGFoG9Myf6fkyOFJui1m g97jA/dJop3X46i8jL67SGHXQa2j76mUbE2XHc5Q1KbQAdBDDuRDPkvo5m1iclhepYh4 SCWXPMCBLgZcaRoJHLFbx95ECw7sgllISI4Hfvint9ojwIEzhxr5//G7+hMi6G8ZYnOj GrOYjVES0gsAPgCM7M1ZS7b8qPGhMojk2fNfvpe1wKFKhdJ6kBX43kCHmORZFjRLzm7i 3MHA== X-Gm-Message-State: ANoB5plmDXSf3tQFXx8DDC1b2vHTq1X6JR5z4Agis/DrHusiWMZ1ADjc KVPY/RgdL/J0HGGRaLG7ciWC2uPYI2an/jF9oVk= X-Google-Smtp-Source: AA0mqf5jDE1t/c++NFsbnzmbt6tH9GJKbKyJ25FjLbiGjRSuhyJD9pxcVYdmbDnVy9M5tb/iGy9NkJXhSRDFj1XqZlw= X-Received: by 2002:a9d:5c81:0:b0:661:c48b:12db with SMTP id a1-20020a9d5c81000000b00661c48b12dbmr24067540oti.105.1669906937715; Thu, 01 Dec 2022 07:02:17 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 1 Dec 2022 07:02:16 -0800 In-Reply-To: <83zgcbnuom.fsf@gnu.org> X-Hashcash: 1:20:221201:eliz@gnu.org::yVAKHBxD84X6j6Gn:03+e X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:249635 Archived-At: --000000000000d4dbab05eec5819e Content-Type: text/plain; charset="UTF-8" Eli Zaretskii writes: > Can this be done by running Groff directly instead of via 'man'? If it's > possible, it's IMO better, since Groff installations are more widespread > than the particular variant of 'man' you used in the script. E.g., I think > the requirement for C.UTF-8 locale being available can be dropped in that > case. The version of man used is man-db, which AFAIK is used by all major GNU/Linux distributions. https://man-db.gitlab.io/man-db/ Looking into this with PIPELINE_DEBUG=1, the processing done is non-trivial, and depends on e.g. /usr/libexec/man-db/zsoelim from man-db. So I think trying to duplicate all of that for the purposes of this script might not be the best use of our time. For reference, I've attached the debug output from man. --000000000000d4dbab05eec5819e Content-Type: text/plain; charset="US-ASCII"; name="man-output.txt" Content-Disposition: attachment; filename="man-output.txt" Content-Transfer-Encoding: base64 X-Attachment-Id: 1bf81b3336056aad_0.1 JCBQSVBFTElORV9ERUJVRz0xIExDX0FMTD1DLlVURi04IE1BTlJPRkZTRVE9JycgTUFOV0lEVEg9 ODAgXAptYW4gLS13YXJuaW5ncz1hbGwsbWFjIC1FIFVURi04IC1sIC1UdXRmOCAtWiBkb2MvbWFu L2VtYWNzLjEgPi9kZXYvbnVsbCAgICAgICAgICAgICAgICAgIApTdGFydGluZyBwaXBlbGluZTog KGVjaG8gLm5oICYmIGVjaG8gLmRlIGh5ICYmIGVjaG8gLi4gJiYgZWNobyAubmEgJiYgZWNobyAu ZGUgYWQgJiYgZWNobyAuLiAmJiBjYXQpIFtpbnB1dDogezAsIGRvYy9tYW4vZW1hY3MuMX0sIG91 dHB1dDogey0xLCBOVUxMfV0KU3RhcnRlZCAiZGVjb21wcmVzc29yIiwgcGlkIDE2MzYxNjEKU3Rh cnRlZCAiZWNobyAubmggJiYgZWNobyAuZGUgaHkgJiYgZWNobyAuLiIsIHBpZCAxNjM2MTYyCiAg ImVjaG8gLm5oICYmIGVjaG8gLmRlIGh5ICYmIGVjaG8gLi4iICgxNjM2MTYyKSAtPiAwClN0YXJ0 ZWQgImVjaG8gLm5hICYmIGVjaG8gLmRlIGFkICYmIGVjaG8gLi4iLCBwaWQgMTYzNjE2MwogICJl Y2hvIC5uYSAmJiBlY2hvIC5kZSBhZCAmJiBlY2hvIC4uIiAoMTYzNjE2MykgLT4gMApTdGFydGVk ICJjYXQiLCBwaWQgMTYzNjE2NApTdGFydGluZyBwaXBlbGluZTogL3Vzci9saWJleGVjL21hbi1k Yi96c29lbGltIHwgcHJlY29udiAtZSBVVEYtOCB8IGdyb2ZmIC1tYW5kb2MgLVogLXdhbGwgLXdt YWMgLVR1dGY4ICAiY2F0IiAoMTYzNjE2NCkgLT4gMAogW2lucHV0OiB7LTEsIE5VTEx9LCBvdXRw dXQ6IHswLCBOVUxMfV0KU3RhcnRlZCAiL3Vzci9saWJleGVjL21hbi1kYi96c29lbGltIiwgcGlk IDE2MzYxNjUKU3RhcnRlZCAicHJlY29udiIsIHBpZCAxNjM2MTY2ClN0YXJ0ZWQgImdyb2ZmIiwg cGlkIDE2MzYxNjcKc291cmNlIHBpcGVsaW5lIDAgcmV0dXJuZWQgZXJyb3Igb3IgRU9GCldhaXRp bmcgZm9yIHBpcGVsaW5lOiAoZWNobyAubmggJiYgZWNobyAuZGUgaHkgJiYgZWNobyAuLiAmJiBl Y2hvIC5uYSAmJiBlY2hvIC5kZSBhZCAmJiBlY2hvIC4uICYmIGNhdCkgW2lucHV0OiB7MCwgZG9j L21hbi9lbWFjcy4xfSwgb3V0cHV0OiB7LTEsIE5VTEx9XQpBY3RpdmUgcHJvY2Vzc2VzICgxKToK ICAiZGVjb21wcmVzc29yIiAoMTYzNjE2MSkgLT4gMApXYWl0aW5nIGZvciBwaXBlbGluZTogL3Vz ci9saWJleGVjL21hbi1kYi96c29lbGltIHwgcHJlY29udiAtZSBVVEYtOCB8IGdyb2ZmIC1tYW5k b2MgLVogLXdhbGwgLXdtYWMgLVR1dGY4IFtpbnB1dDogey0xLCBOVUxMfSwgb3V0cHV0OiB7MCwg TlVMTH1dCkFjdGl2ZSBwcm9jZXNzZXMgKDMpOgogICIvdXNyL2xpYmV4ZWMvbWFuLWRiL3pzb2Vs aW0iICgxNjM2MTY1KSAtPiAtMQogICJwcmVjb252IiAoMTYzNjE2NikgLT4gLTEKICAiZ3JvZmYi ICgxNjM2MTY3KSAtPiAtMQpTdGFydGluZyBwaXBlbGluZTogemNhdCBbaW5wdXQ6IHszLCBOVUxM fSwgb3V0cHV0OiB7LTEsIE5VTEx9XQpTdGFydGVkICJ6Y2F0IiwgcGlkIDE2MzYxNjgKV2FpdGlu ZyBmb3IgcGlwZWxpbmU6IHpjYXQgW2lucHV0OiB7MywgTlVMTH0sIG91dHB1dDogey0xLCBOVUxM fV0KQWN0aXZlIHByb2Nlc3NlcyAoMSk6CiAgInpjYXQiICgxNjM2MTY4KSAtPiAtMQpBY3RpdmUg cHJvY2Vzc2VzICgxKToKICAiemNhdCIgKDE2MzYxNjgpIC0+IDAKQWN0aXZlIHByb2Nlc3NlcyAo Myk6CiAgIi91c3IvbGliZXhlYy9tYW4tZGIvenNvZWxpbSIgKDE2MzYxNjUpIC0+IDAKICAicHJl Y29udiIgKDE2MzYxNjYpIC0+IC0xCiAgImdyb2ZmIiAoMTYzNjE2NykgLT4gLTEKQWN0aXZlIHBy b2Nlc3NlcyAoMik6CiAgInByZWNvbnYiICgxNjM2MTY2KSAtPiAwCiAgImdyb2ZmIiAoMTYzNjE2 NykgLT4gLTEKdHJvZmY6IDxzdGFuZGFyZCBpbnB1dD46MTg6IHdhcm5pbmc6IG1hY3JvICdTSFgn IG5vdCBkZWZpbmVkIChwb3NzaWJseSBtaXNzaW5nIHNwYWNlIGFmdGVyICdTSCcpCkFjdGl2ZSBw cm9jZXNzZXMgKDEpOgogICJncm9mZiIgKDE2MzYxNjcpIC0+IDAK --000000000000d4dbab05eec5819e Content-Type: text/plain; charset="US-ASCII" Content-Disposition: attachment Content-Transfer-Encoding: base64 X-Attachment-Id: 1bf81b3336056aad_0.2 Cj4gQnV0IGlmIGRvaW5nIHNvIHJlcXVpcmVzIHRvbyBtdWNoIGVmZm9ydCBvciByZXNlYXJjaCwg ZmVlbCBmcmVlIHRvIGluc3RhbGwKPiB3aGF0IHlvdSBoYXZlLgoKSSdsbCBkbyB0aGF0LCB0aGFu a3MuCg== --000000000000d4dbab05eec5819e--