From unknown Wed Sep 10 01:11:21 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#59631 <59631@debbugs.gnu.org> To: bug#59631 <59631@debbugs.gnu.org> Subject: Status: 29.0.50; [PATCH] New check-man target to check man pages for errors Reply-To: bug#59631 <59631@debbugs.gnu.org> Date: Wed, 10 Sep 2025 08:11:21 +0000 retitle 59631 29.0.50; [PATCH] New check-man target to check man pages for = errors reassign 59631 emacs submitter 59631 Stefan Kangas severity 59631 wishlist tag 59631 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 27 10:24:20 2022 Received: (at submit) by debbugs.gnu.org; 27 Nov 2022 15:24:20 +0000 Received: from localhost ([127.0.0.1]:42540 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozJW0-0005lq-77 for submit@debbugs.gnu.org; Sun, 27 Nov 2022 10:24:20 -0500 Received: from lists.gnu.org ([209.51.188.17]:53490) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozJVy-0005lk-7C for submit@debbugs.gnu.org; Sun, 27 Nov 2022 10:24:18 -0500 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 1ozJVx-0003Yh-JC for bug-gnu-emacs@gnu.org; Sun, 27 Nov 2022 10:24:17 -0500 Received: from mail-oa1-x30.google.com ([2001:4860:4864:20::30]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ozJVX-0004Xo-Ix for bug-gnu-emacs@gnu.org; Sun, 27 Nov 2022 10:24:14 -0500 Received: by mail-oa1-x30.google.com with SMTP id 586e51a60fabf-14263779059so10418198fac.1 for ; Sun, 27 Nov 2022 07:23:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:subject:message-id:date:mime-version:from:from:to:cc:subject :date:message-id:reply-to; bh=YDT6Pvp0st1z8LPQSVcCpxFt15kk0DWcPxmMqmX5vDM=; b=LqUrLqzx/uXf4TN58P22iv6fwRlHZUjlQBhVF1TeH7G05B6HPvHO8uqWMtUFN19e60 fjaniOagjc2CGd2+6YcPxOnT9xB5p7Q/SDFlB5mQK1PBpgjRhBhAZAxCbQJO9gNWsOen E5l2BhEeW/0M7QnlQGquxVTmzpXB+z3WogsWFDNNXxw4ckRYqHPpPtAU/olkTv0MdzGR XqPoCK5JJYoAJHaasamPcqEg7AcSb8gvug7ts28eWujz919UYQssX7f30ihSDUNw43Me zSnnim+370rhKd3642Nes+u5gKqi0U3o1bmtZYIVtehj4+GtgMx6SijhRf/nsWZ/R5/c arEQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:subject:message-id:date:mime-version:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=YDT6Pvp0st1z8LPQSVcCpxFt15kk0DWcPxmMqmX5vDM=; b=40a9pnnYS5R47lQUHteOoMRXgRDm6TN3n6B2xZUk9r77xqEXaLsud//yCf/f89EBkx TrRYdyAY2MKjDGo774YvdAEiTlYlKOJlSllav33qmGlu9sa1vlInfMy4k3JNu4wnV7Ju hEvbaRgdhVOhRgHg/edsko9VrkvBrn4+kbQFPofkgznLNEUgx7IEUJ8xnJian/OwZQ0S b6Jcl9eLkf8p+hAHpRg5KAd5Y4EVf9JGSFv6sHNFsf384LqdIAVUBygr0CpMVkcdUm+o o1QBwEhNW6nj1U88dwlP+YkQ3Nf+dcS3P4xjkKjbGKonymWpx8uN3ZyEzUzueeBy0cOI BHxQ== X-Gm-Message-State: ANoB5pn6Jjiml/i0Uvsu/k4Zj6enro8nPzo9cRT3psaAt0hO5FyG6FmO S5imwNxbzxEKsxvusUVjYvME/r/3PpE+hDMcLXcFz0kGQCM= X-Google-Smtp-Source: AA0mqf79hQcSLk5xpsB+rrKLiSzUZmUKAwcyrZnqQlru7BO4YExW0s/8Ztawr6yNq1yALKX8Ke2WjKrXwiV/bli1JD0= X-Received: by 2002:a05:6870:4995:b0:143:522a:ebcc with SMTP id ho21-20020a056870499500b00143522aebccmr9327903oab.199.1669562630302; Sun, 27 Nov 2022 07:23:50 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 27 Nov 2022 07:23:49 -0800 From: Stefan Kangas X-Hashcash: 1:20:221127:bug-gnu-emacs@gnu.org::iPkF/OspqBat5fqN:1kVx MIME-Version: 1.0 Date: Sun, 27 Nov 2022 07:23:49 -0800 Message-ID: Subject: 29.0.50; [PATCH] New check-man target to check man pages for errors To: bug-gnu-emacs@gnu.org Content-Type: multipart/mixed; boundary="00000000000082881405ee755793" Received-SPF: pass client-ip=2001:4860:4864:20::30; envelope-from=stefankangas@gmail.com; helo=mail-oa1-x30.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) --00000000000082881405ee755793 Content-Type: text/plain; charset="UTF-8" Severity: wishlist The attached patch adds a new check-man target to check our man pages for errors. I know we prefer info over man, but why not. It will catch mistakes, like using unknown macros, etc. To test this, change a macro like ".B" to ".BBB" in doc/man/emacs.1 and run "make check-man". --00000000000082881405ee755793 Content-Type: text/x-diff; charset="US-ASCII"; name="0001-Add-new-check-man-target.patch" Content-Disposition: attachment; filename="0001-Add-new-check-man-target.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: 18173ed26ebc5014_0.1 RnJvbSBjYzgzZTc1YWQwYmMwMmQwMDNiMTRhNzg5ZjE1ZGM5NGM2YWI3ODk5IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBTdW4sIDI3IE5vdiAyMDIyIDE2OjAzOjMxICswMTAwClN1YmplY3Q6IFtQQVRDSF0g QWRkIG5ldyBjaGVjay1tYW4gdGFyZ2V0CgoqIE1ha2VmaWxlLmluIChjaGVjay1tYW4pOiBOZXcg dGFyZ2V0IHRvIGNoZWNrIG1hbiBwYWdlcyBmb3IgZXJyb3JzLgotLS0KIE1ha2VmaWxlLmluIHwg MTMgKysrKysrKysrKysrKwogMSBmaWxlIGNoYW5nZWQsIDEzIGluc2VydGlvbnMoKykKCmRpZmYg LS1naXQgYS9NYWtlZmlsZS5pbiBiL01ha2VmaWxlLmluCmluZGV4IDkzNjA5YTRlMTYuLjJkODZk ZjA5YmIgMTAwNjQ0Ci0tLSBhL01ha2VmaWxlLmluCisrKyBiL01ha2VmaWxlLmluCkBAIC02OSw2 ICs2OSwxMCBAQAogIyAgICAgIGNoZWNrLWV4cGVuc2l2ZSBpbmNsdWRlcyBhZGRpdGlvbmFsIHRl c3RzIHRoYXQgY2FuIGJlIHNsb3cuCiAjICAgICAgY2hlY2stYWxsIHJ1bnMgYWxsIHRlc3RzLCBp bmNsdWRpbmcgb25lcyB0aGF0IGNhbiBiZSBzbG93LCBvcgogIyAgICAgICAgZmFpbCB1bnByZWRp Y3RhYmx5CisjCisjIG1ha2UgY2hlY2stbWFuCisjICAgICAgQ2hlY2sgbWFuIHBhZ2VzIGZvciBl cnJvcnMuCisjCiAKIFNIRUxMID0gQFNIRUxMQAogCkBAIC0xMzIyLDYgKzEzMjYsMTUgQEAgY2hl Y2stZGVjbGFyZToKIAkkKE1BS0UpIC1DIGxpc3AgJEAKIAkkKE1BS0UpIC1DIHRlc3QgJEAKIAor LlBIT05ZOiBjaGVjay1tYW4KKworY2hlY2stbWFuOgorCUBjZCAke21hbnNyY2Rpcn07IFwKKwlm b3IgcGFnZSBpbiAqLjE7IGRvIFwKKwkgIExDX0FMTD1DLlVURi04IE1BTlJPRkZTRVE9JycgTUFO V0lEVEg9ODAgXAorCSAgbWFuIC0td2FybmluZ3MgLUUgVVRGLTggLWwgLVR1dGY4IC1aICIkJHBh Z2UiID4vZGV2L251bGw7IFwKKwlkb25lCisKIC5QSE9OWTogZ2l0bWVyZ2UKIAogR0lUTUVSR0Vf RU1BQ1MgPSAuL3NyYy9lbWFjcyR7RVhFRVhUfQotLSAKMi4zNS4xCgo= --00000000000082881405ee755793-- From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 27 10:44:20 2022 Received: (at 59631) by debbugs.gnu.org; 27 Nov 2022 15:44:20 +0000 Received: from localhost ([127.0.0.1]:42737 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozJpL-00060j-Tf for submit@debbugs.gnu.org; Sun, 27 Nov 2022 10:44:20 -0500 Received: from eggs.gnu.org ([209.51.188.92]:50360) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozJpJ-00060Y-L2 for 59631@debbugs.gnu.org; Sun, 27 Nov 2022 10:44:17 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozJpE-00022C-E0; Sun, 27 Nov 2022 10:44:12 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=PwErUTcc7DC4z7G9SbVhGP7j5EGSFw0J75OsVxOzIhA=; b=eNyUQBpfHB9d pzr1GsahJl+1PhL/+623voKcuxmeRuaNICReX1QHI2bXbGkV39/sMIw6ecfqk2lqv5d16j59n8QF+ rtMGhizt/3XgSbZ9+IGi1H7dHkbv9Ko/qNf72Fu+5ZCkcjYoIH+hTgTmPsK/1Ne9udkC/9Qtc0ay2 bwlnUalxHxJYntIMXPEoUjxv6Wlu45mWnU7AY4p4hSK+XyqlgLGTQ11ZTVMdtf1oWiXw1BTG6l8ZH J92y6a2PdEbImSHpea1L3FIQACK7exc5nOmF20qA4/TU31Lh1RCD/KBhVmOMqU8purQC6uQUozCLl Jd4kYBIM/OzprJv50239HQ==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozJpD-0001e5-LL; Sun, 27 Nov 2022 10:44:11 -0500 Date: Sun, 27 Nov 2022 17:44:40 +0200 Message-Id: <83h6ykpfkn.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-Reply-To: (message from Stefan Kangas on Sun, 27 Nov 2022 07:23:49 -0800) Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > Date: Sun, 27 Nov 2022 07:23:49 -0800 > > The attached patch adds a new check-man target to check our man pages > for errors. I know we prefer info over man, but why not. It will catch > mistakes, like using unknown macros, etc. > > To test this, change a macro like ".B" to ".BBB" in doc/man/emacs.1 and > run "make check-man". Thanks, but I think it is better to have this as a script in admin/, not a rule in the top-level Makefile. Especially since it requires specialized tools and setups. From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 27 12:49:22 2022 Received: (at 59631) by debbugs.gnu.org; 27 Nov 2022 17:49:22 +0000 Received: from localhost ([127.0.0.1]:43331 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozLmL-0007Bv-NH for submit@debbugs.gnu.org; Sun, 27 Nov 2022 12:49:22 -0500 Received: from mail-ot1-f44.google.com ([209.85.210.44]:35449) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozLmK-0007Bp-Kg for 59631@debbugs.gnu.org; Sun, 27 Nov 2022 12:49:21 -0500 Received: by mail-ot1-f44.google.com with SMTP id cn2-20020a056830658200b0066c74617e3dso5642324otb.2 for <59631@debbugs.gnu.org>; Sun, 27 Nov 2022 09:49:20 -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=5v1slWTGDUPZcOQfLzXWqS7nLyOOq1uwLd0mA3JD1AY=; b=OdNZuoZlkugjxcDjdUOHeLbqwynwCHD8WYb9bkjPMI17Y2L/X6qVJqNrIFqpyftekb qhcO92qQktY5OG+F1gnjjEtHe8tK9davhRGD/6O3u4b5SNwipVmsJlNM4zwlSptOrKrQ CJxsrYOuFa1U76EgQqkDE8h2qXYEUsV3EXE+d+MarYcxexEaeuT1EQ461pMVD5fH71EZ dCDFWO2+iOdLvujPERtLsaj5g3gAtsDaCLa3mOXkNSElIqZECaIcqv6N+q6sHYum/75q N2D0Xj4jQhr7zDoVIS/1AS4sWj2zcpM5GTAw4v7yt8t1X/mqwzLjYZX0NQNqaHXMgNcH 753g== 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=5v1slWTGDUPZcOQfLzXWqS7nLyOOq1uwLd0mA3JD1AY=; b=NU1DTssuZBMeP9t0l60mxjgoi3rXhWyeZfnrPtCjQHVJXf3IrD4Tu5F5HQE5hq/x2i sgxsATrbh7IUApJa0X1rgZcQ7AlLA8XS336MzRcvqyxMh4ErZLj0ukCKh09i4MWvjvIU 1AsDnk1j4bQku+t4T7x3ePquUANr3SC5r+MCtUAc0k9wzzhGsTvclYBQ9wDWaY72SwhX 0z2IJQ+1h/gEFNKR2ovrhBYOs9o03geUWd23/tmW5KEv+QO5LfSpo0W29jlxfbJ1wGIH Ch92O0CnOeBVhUCJ/Nkudb7/cS4EsKoomIVlQoI86pN36g/cPx1Eeu49LRIMHX4Nszvp TLFA== X-Gm-Message-State: ANoB5pl4hdIBZbbfC2fZBfNUPuAGA05EUkQ4oieEV7tAPdrN+7OYMp29 +tA2wkWODhibcyPHLvgmyLcngFaOPoqK3CjCAP+NiNbAH+I= X-Google-Smtp-Source: AA0mqf5PriWQ/7t/mB7mgvFCyEAzMgSRXrmJZA5pCjTxl5pKaOF19IEJt+jH78kpBoIjrVJpFrsozSciHbCqGcidU5E= X-Received: by 2002:a9d:5c81:0:b0:661:c48b:12db with SMTP id a1-20020a9d5c81000000b00661c48b12dbmr14777248oti.105.1669571354987; Sun, 27 Nov 2022 09:49:14 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 27 Nov 2022 09:49:13 -0800 From: Stefan Kangas In-Reply-To: <83h6ykpfkn.fsf@gnu.org> References: <83h6ykpfkn.fsf@gnu.org> X-Hashcash: 1:20:221127:eliz@gnu.org::bEuiXMjGi97778Ei:1NsR MIME-Version: 1.0 Date: Sun, 27 Nov 2022 09:49:13 -0800 Message-ID: Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors To: Eli Zaretskii Content-Type: multipart/mixed; boundary="0000000000008ad1a205ee775f0e" X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --0000000000008ad1a205ee775f0e Content-Type: text/plain; charset="UTF-8" Eli Zaretskii writes: > Thanks, but I think it is better to have this as a script in admin/, not a > rule in the top-level Makefile. Especially since it requires specialized > tools and setups. OK, please find attached a new patch making this into a script instead. --0000000000008ad1a205ee775f0e Content-Type: text/x-diff; charset="US-ASCII"; name="0001-New-script-admin-check-man-pages.patch" Content-Disposition: attachment; filename="0001-New-script-admin-check-man-pages.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: 559a5501be3fca2a_0.1 RnJvbSA1NTliODhhZmMzZDU2ZWU5ZDUxMTY3NTRlMDEzMzgzOTIwMjkwZGVhIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBTdW4sIDI3IE5vdiAyMDIyIDE4OjM3OjM3ICswMTAwClN1YmplY3Q6IFtQQVRDSF0g TmV3IHNjcmlwdCBhZG1pbi9jaGVjay1tYW4tcGFnZXMKCiogYWRtaW4vY2hlY2stbWFuLXBhZ2Vz OiBOZXcgZmlsZSB3aXRoIHNjcmlwdCB1c2VkIHRvIGNoZWNrIG1hbiBwYWdlcwpmb3IgZXJyb3Jz LgotLS0KIGFkbWluL2NoZWNrLW1hbi1wYWdlcyB8IDQ0ICsrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCA0NCBpbnNlcnRpb25zKCspCiBj cmVhdGUgbW9kZSAxMDA3NTUgYWRtaW4vY2hlY2stbWFuLXBhZ2VzCgpkaWZmIC0tZ2l0IGEvYWRt aW4vY2hlY2stbWFuLXBhZ2VzIGIvYWRtaW4vY2hlY2stbWFuLXBhZ2VzCm5ldyBmaWxlIG1vZGUg MTAwNzU1CmluZGV4IDAwMDAwMDAwMDAuLjNmMzE5MGQ0OTUKLS0tIC9kZXYvbnVsbAorKysgYi9h ZG1pbi9jaGVjay1tYW4tcGFnZXMKQEAgLTAsMCArMSw0NCBAQAorIyEvYmluL2Jhc2gKKyMjIyBj aGVjay1tYW4tcGFnZXMgLSBjaGVjayBtYW4gcGFnZXMgZm9yIGVycm9ycworCisjIyBDb3B5cmln aHQgKEMpIDIwMjIgRnJlZSBTb2Z0d2FyZSBGb3VuZGF0aW9uLCBJbmMuCisKKyMjIFRoaXMgZmls ZSBpcyBwYXJ0IG9mIEdOVSBFbWFjcy4KKworIyMgR05VIEVtYWNzIGlzIGZyZWUgc29mdHdhcmU6 IHlvdSBjYW4gcmVkaXN0cmlidXRlIGl0IGFuZC9vciBtb2RpZnkKKyMjIGl0IHVuZGVyIHRoZSB0 ZXJtcyBvZiB0aGUgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UgYXMgcHVibGlzaGVkIGJ5Cisj IyB0aGUgRnJlZSBTb2Z0d2FyZSBGb3VuZGF0aW9uLCBlaXRoZXIgdmVyc2lvbiAzIG9mIHRoZSBM aWNlbnNlLCBvcgorIyMgKGF0IHlvdXIgb3B0aW9uKSBhbnkgbGF0ZXIgdmVyc2lvbi4KKworIyMg R05VIEVtYWNzIGlzIGRpc3RyaWJ1dGVkIGluIHRoZSBob3BlIHRoYXQgaXQgd2lsbCBiZSB1c2Vm dWwsCisjIyBidXQgV0lUSE9VVCBBTlkgV0FSUkFOVFk7IHdpdGhvdXQgZXZlbiB0aGUgaW1wbGll ZCB3YXJyYW50eSBvZgorIyMgTUVSQ0hBTlRBQklMSVRZIG9yIEZJVE5FU1MgRk9SIEEgUEFSVElD VUxBUiBQVVJQT1NFLiAgU2VlIHRoZQorIyMgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UgZm9y IG1vcmUgZGV0YWlscy4KKworIyMgWW91IHNob3VsZCBoYXZlIHJlY2VpdmVkIGEgY29weSBvZiB0 aGUgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UKKyMjIGFsb25nIHdpdGggR05VIEVtYWNzLiAg SWYgbm90LCBzZWUgPGh0dHBzOi8vd3d3LmdudS5vcmcvbGljZW5zZXMvPi4KKworIyMjIENvbW1l bnRhcnk6CisKKyMjIENoZWNrIG91ciBtYW4gcGFnZXMgZm9yIGVycm9ycyB1c2luZyBgbWFuJy4K KworIyMjIENvZGU6CisKK3NvdXJjZSAiJHswJS8qfS9lbWFjcy1zaGVsbC1saWIiCisKK2V4aXRf c3RhdHVzPTAKKworY2QgIiRQRCIvLi4vZG9jL21hbgorZm9yIHBhZ2UgaW4gKi4xOyBkbworICAg IGxvZz0kKGVtYWNzX21rdGVtcCkKKyAgICBMQ19BTEw9Qy5VVEYtOCBNQU5ST0ZGU0VRPScnIE1B TldJRFRIPTgwIFwKKyAgICAgICAgbWFuIC0td2FybmluZ3MgLUUgVVRGLTggLWwgLVR1dGY4IC1a ICIkcGFnZSIgPi9kZXYvbnVsbCAyPiAkbG9nCisgICAgbG9nX3NpemU9JChzdGF0IC0tZm9ybWF0 PSVzICIkbG9nIikKKyAgICBpZiBbICRsb2dfc2l6ZSAtbmUgMCBdOyB0aGVuCisgICAgICAgIGVj aG8gImRvYy9tYW4vJHBhZ2U6IgorICAgICAgICBjYXQgJGxvZworICAgICAgICBleGl0X3N0YXR1 cz0xCisgICAgZmkKK2RvbmUKKworZXhpdCAkZXhpdF9zdGF0dXMKLS0gCjIuMzUuMQoK --0000000000008ad1a205ee775f0e-- From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 27 13:15:13 2022 Received: (at 59631) by debbugs.gnu.org; 27 Nov 2022 18:15:13 +0000 Received: from localhost ([127.0.0.1]:43463 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozMBM-0007Sn-LV for submit@debbugs.gnu.org; Sun, 27 Nov 2022 13:15:12 -0500 Received: from eggs.gnu.org ([209.51.188.92]:59010) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozMBK-0007Sd-NY for 59631@debbugs.gnu.org; Sun, 27 Nov 2022 13:15:11 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozMBE-0008Nj-FB; Sun, 27 Nov 2022 13:15:04 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=OZK2UFYnyKB2nm/FfwNla2b8xpZ+O3l6qY6abYQRQzY=; b=JqIAFE/58Wy8 k44r8sCeLCmbUIqO/X0rm9+zXZ3U9/azwrXjqwugyGjr/o5C0fkwviIORJmqCwy1AKnPHGSJ7BJL+ EX87TCUzuJaBMGu3gx0oNjuBYBxQnlJK3sTMqfXvomSZrxDSplUqxVRd7KjegcirY1/7V61p0N8M0 bCccAXZ5K5B3IL+VGCfk6kzClHQfv44hvRprFkABWYPermwXrXow+zE4Urh5bpqbum0OnfQyauBZP isD3MZ/8vmwuCY9ccDROUgqaM2f0qYOy6vKMgc4CdXcV5y3izpVemVnp0lWSql+ULPMg5wJ09BuPf P99mgH8+KX2v5VGrnLpnmw==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozMBD-0005D0-Lp; Sun, 27 Nov 2022 13:15:04 -0500 Date: Sun, 27 Nov 2022 20:15:31 +0200 Message-Id: <83cz98p8l8.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-Reply-To: (message from Stefan Kangas on Sun, 27 Nov 2022 09:49:13 -0800) Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors References: <83h6ykpfkn.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > Date: Sun, 27 Nov 2022 09:49:13 -0800 > Cc: 59631@debbugs.gnu.org > > Eli Zaretskii writes: > > > Thanks, but I think it is better to have this as a script in admin/, not a > > rule in the top-level Makefile. Especially since it requires specialized > > tools and setups. > > OK, please find attached a new patch making this into a script instead. Thanks, LGTM. Maybe this should be mentioned in some notes, like make-tarball or something? When do we want to run this? From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 27 17:59:44 2022 Received: (at 59631) by debbugs.gnu.org; 27 Nov 2022 22:59:44 +0000 Received: from localhost ([127.0.0.1]:44689 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozQch-0001oi-J5 for submit@debbugs.gnu.org; Sun, 27 Nov 2022 17:59:43 -0500 Received: from mail-oi1-f179.google.com ([209.85.167.179]:34683) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozQcf-0001oc-9b for 59631@debbugs.gnu.org; Sun, 27 Nov 2022 17:59:41 -0500 Received: by mail-oi1-f179.google.com with SMTP id n205so9942286oib.1 for <59631@debbugs.gnu.org>; Sun, 27 Nov 2022 14:59:41 -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=SgJz0PfiTqffuedcJzlp9ZgwCrhkHvEEPWqPH3rlJL4=; b=a2L/LrdMVD12RJtboQZuSDkewkg77FKTpJw4PiYWPN2pw0mrfi4Sonjq4eqlWzb4mv R9YyzaQDrkLz4exDGtwDRS5Loakzl/hsAjRfYGPBg6znPcUJ84oWx9Ele2qmM1hnvs/V 0snEgOI8iv/1HteXjjP33I5T5P+TwsTxVvxo8xBbxYl8JvjES1Y2FEeA3JfVT2a6hpc3 YBy8WhbhyQaWzD/wS86at1dUbhx9AwxpYjZoMKpNa554mHf14tgrEUyjxP/JrfL1Ik0f pgh3pkxF+XyjmH5cV50/J6qGnksLF9528UI6n35VHExdYTBwZpjiqZhGRtUemXGYV35x iE7A== 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=SgJz0PfiTqffuedcJzlp9ZgwCrhkHvEEPWqPH3rlJL4=; b=ZmYqth6MwIRwl3DWknA1SlSG/Rs5MAXlgRLechBSz/xYse3E4X0YdUaPPK5s05S3nd 6p6iidlBcmriWz2S+P9afuaWID8cw99TZvev8bCtuYIH0ldqyYkiuHTkg9i2LUF8WaI7 2qpmsyZFsC9Why2MCj8/KflsOn2RgUB8z5oXESyn1qaFvPtDxRqlsIu2EZqFU0lhUoOX hqQhzfv3GZyJBKlrcuvv6pAXEgg/nvoVigIHyiPew7HU+hEHyxJbomXwLX7LLlVv4G/+ 6kRmIcZVFIvEQRkD+YJGLLLOQAksOABRDvqMMGkkzGbHWrenEs8nPnqKOjxqrKC2tURt Lieg== X-Gm-Message-State: ANoB5pkxsM/pvMcgW5cLerTk8KJhmxg5VhZ9U2ewATS0zrhMAdNfAd9a 10dE5zEK33MfZZp9VoFYqGFRolGV4qYLglnXdt4= X-Google-Smtp-Source: AA0mqf4yGpN0SjJK4T8Znob6N8NlhgHeb5ic0yhC4s+ua2P0r+YvHN24lhmPyQ/TeWdhgww++3l+WmrGP2lgd5SpSw4= X-Received: by 2002:a05:6808:1287:b0:359:dc32:4f9e with SMTP id a7-20020a056808128700b00359dc324f9emr14565672oiw.92.1669589975449; Sun, 27 Nov 2022 14:59:35 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 27 Nov 2022 14:59:34 -0800 From: Stefan Kangas In-Reply-To: <83cz98p8l8.fsf@gnu.org> References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> X-Hashcash: 1:20:221127:eliz@gnu.org::LcL1KWTlPBQeuhi6:Fxk8 MIME-Version: 1.0 Date: Sun, 27 Nov 2022 14:59:34 -0800 Message-ID: Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors To: Eli Zaretskii Content-Type: multipart/mixed; boundary="00000000000068589305ee7bb547" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --00000000000068589305ee7bb547 Content-Type: text/plain; charset="UTF-8" Eli Zaretskii writes: > Maybe this should be mentioned in some notes, like make-tarball or > something? When do we want to run this? I think adding it to make-tarball is a good idea. Perhaps we could do it in the same step as checking the refcards? I've attached a new patch with a suggested wording, please let me know what you think. I also enabled a few more groff warnings, and cleaned up the output to enable automatically jumping to errors from *compilation* buffers. --00000000000068589305ee7bb547 Content-Type: text/x-diff; charset="US-ASCII"; name="0001-New-script-admin-check-man-pages.patch" Content-Disposition: attachment; filename="0001-New-script-admin-check-man-pages.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: 45cf5b2f24541dad_0.1 RnJvbSBjM2JjZGJlN2E3MWU5NWU2MzQzZDZmY2ZjY2UxNzY3YWU0MzM3MzgxIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBTdW4sIDI3IE5vdiAyMDIyIDE4OjM3OjM3ICswMTAwClN1YmplY3Q6IFtQQVRDSF0g TmV3IHNjcmlwdCBhZG1pbi9jaGVjay1tYW4tcGFnZXMKCiogYWRtaW4vY2hlY2stbWFuLXBhZ2Vz OiBOZXcgZmlsZSB3aXRoIHNjcmlwdCB1c2VkIHRvIGNoZWNrIG1hbiBwYWdlcwpmb3IgZXJyb3Jz LgoqIGFkbWluL21ha2UtdGFyYmFsbC50eHQ6IERvY3VtZW50IHdoZW4gdG8gdXNlIHRoZSBhYm92 ZSBzY3JpcHQuCi0tLQogYWRtaW4vY2hlY2stbWFuLXBhZ2VzICB8IDQ3ICsrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKwogYWRtaW4vbWFrZS10YXJiYWxsLnR4dCB8ICA2 ICsrKysrKwogMiBmaWxlcyBjaGFuZ2VkLCA1MyBpbnNlcnRpb25zKCspCiBjcmVhdGUgbW9kZSAx MDA3NTUgYWRtaW4vY2hlY2stbWFuLXBhZ2VzCgpkaWZmIC0tZ2l0IGEvYWRtaW4vY2hlY2stbWFu LXBhZ2VzIGIvYWRtaW4vY2hlY2stbWFuLXBhZ2VzCm5ldyBmaWxlIG1vZGUgMTAwNzU1CmluZGV4 IDAwMDAwMDAwMDAuLjUyY2M3NzcyMDUKLS0tIC9kZXYvbnVsbAorKysgYi9hZG1pbi9jaGVjay1t YW4tcGFnZXMKQEAgLTAsMCArMSw0NyBAQAorIyEvYmluL2Jhc2gKKyMjIyBjaGVjay1tYW4tcGFn ZXMgLSBjaGVjayBtYW4gcGFnZXMgZm9yIGVycm9ycworCisjIyBDb3B5cmlnaHQgKEMpIDIwMjIg RnJlZSBTb2Z0d2FyZSBGb3VuZGF0aW9uLCBJbmMuCisKKyMjIFRoaXMgZmlsZSBpcyBwYXJ0IG9m IEdOVSBFbWFjcy4KKworIyMgR05VIEVtYWNzIGlzIGZyZWUgc29mdHdhcmU6IHlvdSBjYW4gcmVk aXN0cmlidXRlIGl0IGFuZC9vciBtb2RpZnkKKyMjIGl0IHVuZGVyIHRoZSB0ZXJtcyBvZiB0aGUg R05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UgYXMgcHVibGlzaGVkIGJ5CisjIyB0aGUgRnJlZSBT b2Z0d2FyZSBGb3VuZGF0aW9uLCBlaXRoZXIgdmVyc2lvbiAzIG9mIHRoZSBMaWNlbnNlLCBvcgor IyMgKGF0IHlvdXIgb3B0aW9uKSBhbnkgbGF0ZXIgdmVyc2lvbi4KKworIyMgR05VIEVtYWNzIGlz IGRpc3RyaWJ1dGVkIGluIHRoZSBob3BlIHRoYXQgaXQgd2lsbCBiZSB1c2VmdWwsCisjIyBidXQg V0lUSE9VVCBBTlkgV0FSUkFOVFk7IHdpdGhvdXQgZXZlbiB0aGUgaW1wbGllZCB3YXJyYW50eSBv ZgorIyMgTUVSQ0hBTlRBQklMSVRZIG9yIEZJVE5FU1MgRk9SIEEgUEFSVElDVUxBUiBQVVJQT1NF LiAgU2VlIHRoZQorIyMgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UgZm9yIG1vcmUgZGV0YWls cy4KKworIyMgWW91IHNob3VsZCBoYXZlIHJlY2VpdmVkIGEgY29weSBvZiB0aGUgR05VIEdlbmVy YWwgUHVibGljIExpY2Vuc2UKKyMjIGFsb25nIHdpdGggR05VIEVtYWNzLiAgSWYgbm90LCBzZWUg PGh0dHBzOi8vd3d3LmdudS5vcmcvbGljZW5zZXMvPi4KKworIyMjIENvbW1lbnRhcnk6CisKKyMj IENoZWNrIG91ciBtYW4gcGFnZXMgZm9yIGVycm9ycyB1c2luZyBgbWFuJy4KKworIyMjIENvZGU6 CisKK3NvdXJjZSAiJHswJS8qfS9lbWFjcy1zaGVsbC1saWIiCisKK2V4aXRfc3RhdHVzPTAKKwor Y2QgIiRQRCIvLi4vZG9jL21hbgorZm9yIHBhZ2UgaW4gKi4xOyBkbworICAgIGxvZz0kKGVtYWNz X21rdGVtcCkKKyAgICBMQ19BTEw9Qy5VVEYtOCBNQU5ST0ZGU0VRPScnIE1BTldJRFRIPTgwIFwK KyAgICAgICAgbWFuIC0td2FybmluZ3M9YWxsLG1hYyAtRSBVVEYtOCAtbCAtVHV0ZjggLVogIiRw YWdlIiA+L2Rldi9udWxsIDI+ICIkbG9nIgorICAgIGxvZ19zaXplPSQoc3RhdCAtLWZvcm1hdD0l cyAiJGxvZyIpCisgICAgaWYgWyAiJGxvZ19zaXplIiAtbmUgMCBdOyB0aGVuCisgICAgICAgIGVj aG8gImRvYy9tYW4vJHBhZ2U6IgorICAgICAgICAjIFBvaW50IHRvIHRoZSBjb3JyZWN0IGZpbGUg Zm9yICpjb21waWxhdGlvbiogYnVmZmVycy4KKyAgICAgICAgY2F0ICIkbG9nIiBcCisgICAgICAg ICAgICB8IHNlZCAncy90cm9mZjogbWFuMVwvXChbXiBdXCtcKVwuMS90cm9mZjogZG9jXC9tYW5c L1wxLjEvJyBcCisgICAgICAgICAgICB8IHNlZCAicy88c3RhbmRhcmQgaW5wdXQ+L2RvY1wvbWFu XC8kcGFnZS8iCisgICAgICAgIGV4aXRfc3RhdHVzPTEKKyAgICBmaQorZG9uZQorCitleGl0ICRl eGl0X3N0YXR1cwpkaWZmIC0tZ2l0IGEvYWRtaW4vbWFrZS10YXJiYWxsLnR4dCBiL2FkbWluL21h a2UtdGFyYmFsbC50eHQKaW5kZXggZDg4MWI4MTYxMi4uZmY2Zjg4NDViNSAxMDA2NDQKLS0tIGEv YWRtaW4vbWFrZS10YXJiYWxsLnR4dAorKysgYi9hZG1pbi9tYWtlLXRhcmJhbGwudHh0CkBAIC0x NTAsNiArMTUwLDEyIEBAIEdlbmVyYWwgc3RlcHMgKGZvciBlYWNoIHN0ZXAsIGNoZWNrIGZvciBw b3NzaWJsZSBlcnJvcnMpOgogNC4gICAgYXV0b3JlY29uZiAtaSAtSSBtNCAtLWZvcmNlCiAgICAg ICBtYWtlIGJvb3RzdHJhcAogCisgICAgICAuL2FkbWluL2NoZWNrLW1hbi1wYWdlcworCisgICAg VGhlIGFib3ZlIHNjcmlwdCBjaGVja3MgZm9yIGFueSBtaXN0YWtlcyBpbiB0aGUgc291cmNlIHRl eHQgb2YKKyAgICBtYW51YWwgcGFnZXMuICBGaXggYW55IGVycm9ycywgYW5kIHRoZW4gcmUtcnVu IHRoZSBjaGVjay1tYW4tcGFnZXMKKyAgICBzY3JpcHQgdG8gdmVyaWZ5LiAgVGhlbiBkbyB0aGlz OgorCiAgICAgICBtYWtlIC1DIGV0Yy9yZWZjYXJkcwogICAgICAgbWFrZSAtQyBldGMvcmVmY2Fy ZHMgY2xlYW4KIAotLSAKMi4zNS4xCgo= --00000000000068589305ee7bb547-- From debbugs-submit-bounces@debbugs.gnu.org Mon Nov 28 07:13:07 2022 Received: (at 59631) by debbugs.gnu.org; 28 Nov 2022 12:13:07 +0000 Received: from localhost ([127.0.0.1]:48213 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozd0U-0001MQ-Qn for submit@debbugs.gnu.org; Mon, 28 Nov 2022 07:13:07 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45142) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozd0S-0001M2-IM for 59631@debbugs.gnu.org; Mon, 28 Nov 2022 07:13:04 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozd0N-0007ab-BX; Mon, 28 Nov 2022 07:12:59 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=m0HJN9JAF6DNyasRjsuDM6QIFAgAf5wI6jIqtKYlDkU=; b=UuwHlpF01g8I bijj964uDZkOqqtSIP8GtMQmIDa2tGzRRdEFho/smElyOqzqSAtw+TdN7e0Qbxj9wGLokeeaECr6T 4u0J6wJaK5XUF1z1prxzt1gkSRbGr6BQc/iNB3BwLP0+EkAVEkiy9j1WXfHYFdOkO0dlp/416Pw31 g8FsVQqLX3s4ndhaB8yL+V9UBUwsOT3+PEtlE2kZuqRPsuh3JX47S8wVCW2+cHFs6gIr32SBor1+7 1kSH8Tpe+A4u5Xbrh9g9Vef4cSEIjVHOR+R9QfXIF3yL++L+T8z+4GoXZZ1PGz8dHSF6U28/+S1Pt XtiJpehpPKHOKi9IuX8a1w==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozd0M-0004Nm-LC; Mon, 28 Nov 2022 07:12:58 -0500 Date: Mon, 28 Nov 2022 14:13:29 +0200 Message-Id: <83zgcbnuom.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-Reply-To: (message from Stefan Kangas on Sun, 27 Nov 2022 14:59:34 -0800) Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > Date: Sun, 27 Nov 2022 14:59:34 -0800 > Cc: 59631@debbugs.gnu.org > > I think adding it to make-tarball is a good idea. Perhaps we could do > it in the same step as checking the refcards? I've attached a new patch > with a suggested wording, please let me know what you think. SGTM. > I also enabled a few more groff warnings, and cleaned up the output to > enable automatically jumping to errors from *compilation* buffers. 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. But if doing so requires too much effort or research, feel free to install what you have. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Thu Dec 01 10:02:42 2022 Received: (at 59631) by debbugs.gnu.org; 1 Dec 2022 15:02:42 +0000 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 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 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) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 1 Dec 2022 07:02:16 -0800 From: Stefan Kangas In-Reply-To: <83zgcbnuom.fsf@gnu.org> References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> X-Hashcash: 1:20:221201:eliz@gnu.org::yVAKHBxD84X6j6Gn:03+e MIME-Version: 1.0 Date: Thu, 1 Dec 2022 07:02:16 -0800 Message-ID: Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors To: Eli Zaretskii Content-Type: multipart/mixed; boundary="000000000000d4dbab05eec5819e" X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --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-- From debbugs-submit-bounces@debbugs.gnu.org Thu Dec 01 11:02:05 2022 Received: (at 59631) by debbugs.gnu.org; 1 Dec 2022 16:02:05 +0000 Received: from localhost ([127.0.0.1]:40507 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p0m0i-0000eg-VC for submit@debbugs.gnu.org; Thu, 01 Dec 2022 11:02:05 -0500 Received: from eggs.gnu.org ([209.51.188.92]:58102) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p0m0h-0000eJ-2c for 59631@debbugs.gnu.org; Thu, 01 Dec 2022 11:02:03 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p0m0b-0005Gj-SX; Thu, 01 Dec 2022 11:01:57 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=ZUzCSszfLbhBC2wt+MS7aNSYxXhHe0YLdu9kW7HJMUc=; b=jpx8lG0cw2yh uBPaSmhbimcBzmkKpgzsaX7N4amYSZN3i7UAG+tQ4R0VnqbVWIaTsNgCcandQiHUxQSm3bILJyOLe WtpOMUza0gUcEFvs3cvJbToQ7QzFIGpvsNHRI11opvAN7a8fPQA1Nb39IZXKEO8/cjl+gYwpvJH2c pIr1800d1vKW+wg808UONKFu2mEu9VHjkx0s7HUbQxbmvFwuFquesZT5VIPtD9B9ELFOHjbYPUqte Nr9kfXKY2Z1xYLoN3bGoWLZsX98cGkoqZq7TlaCx5IjZzLAl/FrL8z+zRpTJh3M8ZAd/C9OwzYvSD RPO8wTXi5SiiEPnmetQSIA==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p0m0b-0000kM-BK; Thu, 01 Dec 2022 11:01:57 -0500 Date: Thu, 01 Dec 2022 18:01:30 +0200 Message-Id: <83v8mvglk5.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-Reply-To: (message from Stefan Kangas on Thu, 1 Dec 2022 07:02:16 -0800) Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > Date: Thu, 1 Dec 2022 07:02:16 -0800 > Cc: 59631@debbugs.gnu.org > > 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. Exactly. So anyone who doesn't have man-db or isn't on GNU/Linux is toast. Groff is another matter: there's even a Windows port. > 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. Fine with me, but just so you know: zsoelim is just a variant of soelim which comes with Groff; it differs from soelim in that it knows about compressed man pages (which are not the issue here). AFAICT, the pipeline is simple: soelim FILE | preconv -e UTF-8 | groff -mandoc -Z -wall -wmac -Tutf8 > /dev/null From debbugs-submit-bounces@debbugs.gnu.org Fri Dec 02 17:50:15 2022 Received: (at 59631) by debbugs.gnu.org; 2 Dec 2022 22:50:15 +0000 Received: from localhost ([127.0.0.1]:49320 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1ErH-0002Km-02 for submit@debbugs.gnu.org; Fri, 02 Dec 2022 17:50:15 -0500 Received: from eggs.gnu.org ([209.51.188.92]:41232) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1ErE-0002Kc-OZ for 59631@debbugs.gnu.org; Fri, 02 Dec 2022 17:50:13 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p1Er8-0007Yr-FU; Fri, 02 Dec 2022 17:50:07 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=Yj0fxMjN8R52vz502JUzGLCLJhvV1XCkh8OQTa/bnxc=; b=N7Fko27oglGK 3JO0i/xCACWvqTwFrug0uAvWSPQ8aAxgMi1/fOL2c5pyD8EgswdJMyIdJmfhHi81q948Yj0mleeK0 kHmagR3voMp7hfCIbEoKgAlp11vdn06r2rL4NQMO/kiklmEIK4UuxqRui613GAEiub7k4zlkSgPWp wxbLchf4e1GL5VNAXAOOuZCFLYRIuHFRtp4QoJRUHcAeVBQS8FlLC54VWYXu0x7QADlEE54ZgEbQc VzwdZD1UxS6Mu32JKCqe9H6taiO5+8FuiEO36Xu6/DXY59R5pfmzDd+E1oiH0kr2DEeR+NqXWGqoD +lVL+fdSp8HBIM6HruzXsg==; Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1p1Er7-0001oV-L1; Fri, 02 Dec 2022 17:50:06 -0500 Content-Type: text/plain; charset=Utf-8 From: Richard Stallman To: Eli Zaretskii In-Reply-To: <83v8mvglk5.fsf@gnu.org> (message from Eli Zaretskii on Thu, 01 Dec 2022 18:01:30 +0200) Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> <83v8mvglk5.fsf@gnu.org> Message-Id: Date: Fri, 02 Dec 2022 17:50:05 -0500 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org, stefankangas@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: rms@gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > The version of man used is man-db, which AFAIK is used by all major > > GNU/Linux distributions. > Exactly. So anyone who doesn't have man-db or isn't on GNU/Linux is toast. Saying a user "is toast" means that the user is dead. Even if that is taken as a metaphor, it is a bit exaggeration. A feature limited to GNU-Like systems is not a horrible thing. Our policy is that support for non-GNU-like systems is at best a secondary goal -- something users can implement if they wish, but we don't consider the lack of that support as a problem. It's fine to make this call Groff directly, if it has no major drawbacks. But please don't imply that the absence of that support would be horrible. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 03 02:07:13 2022 Received: (at 59631) by debbugs.gnu.org; 3 Dec 2022 07:07:13 +0000 Received: from localhost ([127.0.0.1]:51300 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1McD-0005i8-Do for submit@debbugs.gnu.org; Sat, 03 Dec 2022 02:07:13 -0500 Received: from eggs.gnu.org ([209.51.188.92]:39588) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1Mc8-0005hz-SO for 59631@debbugs.gnu.org; Sat, 03 Dec 2022 02:07:12 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p1Mc3-0005ZN-Lt; Sat, 03 Dec 2022 02:07:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=+DEVb8ouo58IH0J0l40cMfgoRaqDFXFimGN3S3GY1Vw=; b=jpA8TAl/W+IB n8GMuRHGqBTbNfgFaZkuCsZTzEK9gjhRmlAygI8BNtuz55LgdmbwVMjagMHz+8CZDHy2MVPKTQYGl rpJGJkJ8n7Bg+kBU/1geSVZabyrVamGJ/UTXxT4Ai6lHPBbxGbDsbFiryRArCMwFUB3CIzcazQ1Z9 Ui9dQkAtKwNxFaF/WUd0VJ7Q2/IoJfWoAvb1uxWUZpNiuLymTi/OZj7Wf7Jkt4NRiDd46phJoLYz8 sl57E6w/0b8flY+EMdG2rBo4zZvm2G9kwtRUq1/7T1L1O5idaF9te3oo5u/1nVAAQUWn5x3XyB+dw LFCyj7CLQjBuLpgftgIJ5g==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p1Mbx-0000gc-Ax; Sat, 03 Dec 2022 02:06:57 -0500 Date: Sat, 03 Dec 2022 09:06:35 +0200 Message-Id: <83mt85dkzo.fsf@gnu.org> From: Eli Zaretskii To: rms@gnu.org In-Reply-To: (message from Richard Stallman on Fri, 02 Dec 2022 17:50:05 -0500) Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> <83v8mvglk5.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org, stefankangas@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Richard Stallman > Cc: stefankangas@gmail.com, 59631@debbugs.gnu.org > Date: Fri, 02 Dec 2022 17:50:05 -0500 > > A feature limited to GNU-Like systems is not a horrible thing. Our > policy is that support for non-GNU-like systems is at best a secondary > goal -- something users can implement if they wish, but we don't > consider the lack of that support as a problem. > > It's fine to make this call Groff directly, if it has no major > drawbacks. But please don't imply that the absence of that support > would be horrible. This is not a user-level feature. This is a feature for Emacs developers, and only for those of them who routinely work on producing the release tarballs. From my POV, it is important to make this kind of features to work on as many systems as possible, if only to allow me to do these jobs from my local system. The feature is implemented in Groff, btw, the man page of 'man' says that explicitly. And I didn't say the inability to use Groff directly would be "horrible", quite the contrary. Quote: > 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. > > But if doing so requires too much effort or research, feel free to install > what you have. Note the last paragraph. So I consider your reprimand gratuitous and even mildly insulting. It sounds like you reacted to a single sentence, taken out of context, and either didn't read or forgot the other messages I wrote in this thread. From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 03 09:20:58 2022 Received: (at 59631) by debbugs.gnu.org; 3 Dec 2022 14:20:58 +0000 Received: from localhost ([127.0.0.1]:51723 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1TNy-0003nw-30 for submit@debbugs.gnu.org; Sat, 03 Dec 2022 09:20:58 -0500 Received: from mail-oa1-f41.google.com ([209.85.160.41]:34359) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1TNw-0003np-1q for 59631@debbugs.gnu.org; Sat, 03 Dec 2022 09:20:56 -0500 Received: by mail-oa1-f41.google.com with SMTP id 586e51a60fabf-1445ca00781so1982167fac.1 for <59631@debbugs.gnu.org>; Sat, 03 Dec 2022 06:20:56 -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=Yz+BdZiAZfSsX3P+iyjJ82cxVpsIfjT5Gtkwahd11tg=; b=BaPI0QrIO8BpGAMPt4N2Jhjni79nYzwaIWPqqK424DviPZxYouKJoiFTLyRUn4jhyu roTL7wMJHiicJkr9EMQV74jfPNOXu6piy+qCpHWkbQ7zRPD15byDUX6at4963OGhE5BD EQup6te0RF018ki3/a2+RMuCfBZfnbrE3ODULRUHe//PsUEXWTnH3c0o38YuCpQATXnX lgyPE1b0twr6Ci7u+hyDVlhvsRNizeA76h0HdoyCy37QZ4UOWo9WbxKKjRn5ul66LPsE +7im6G6i4auAR0HboRKYrGgdj5lRDj0sDsq0VtAD58OUONTvC8EIXE27A3FPTBuhpcai ycOg== 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=Yz+BdZiAZfSsX3P+iyjJ82cxVpsIfjT5Gtkwahd11tg=; b=QscVZ/ucDKo9xTo3AlE5mPGhLVbdvZsD0TZuQRWmZSoLtCpTGCaZhj1RPLJKXdvCW9 SBzFVchl+glsevPa/lDCtQj5+lmn5ImJh8UZ2NfWsuo9gl4FQeL2a5Z7pB6pKlz2oMSB +0TngdE2gvDy1T5ioszmsT1/NP0AZtVntZnHD/iwZWIWhfca8nQjQ77CbyieMVIdoA7j 1vpfVYINC2aB9ptNDaS26TESN6TnfRk7sA5yWhcXa4nlWN2ux20nHUIqXZZRdZHQJ1+T gAwO9MCw7xajkhPkqch1kVSL65BuNPczrkddBlI+yFpKU+8Lecks39q61ttrdLcRg21w 1xyw== X-Gm-Message-State: ANoB5pm3EjQmQst2SppxcgZX21eWa4O59d3rhRb6aDTS7dHUpinmmeWb bZKO6RGfLztBs0aV5PtKanFFxyqKXdH6HezLA/E= X-Google-Smtp-Source: AA0mqf4A00J8v+1slVq8FGUGK8G9gLUwLo+2gxQI9T0fu64rvAaGqxPrzLBirfOgLyzlqXm5dj4HBBxSfbs9DA1ySn4= X-Received: by 2002:a05:6870:4995:b0:143:522a:ebcc with SMTP id ho21-20020a056870499500b00143522aebccmr25668213oab.199.1670077250462; Sat, 03 Dec 2022 06:20:50 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 3 Dec 2022 06:20:50 -0800 From: Stefan Kangas In-Reply-To: <83v8mvglk5.fsf@gnu.org> References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> <83v8mvglk5.fsf@gnu.org> X-Hashcash: 1:20:221203:59631@debbugs.gnu.org::inW4bILDzMEnUn4J:4LXJ MIME-Version: 1.0 Date: Sat, 3 Dec 2022 06:20:50 -0800 Message-ID: Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors To: Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Eli Zaretskii writes: > AFAICT, the pipeline is simple: > > soelim FILE | preconv -e UTF-8 | groff -mandoc -Z -wall -wmac -Tutf8 > /dev/null My concern is that the command is more brittle in the face of changes, and also all the extra "echo" stuff that man-db is doing (probably because I don't understand what it's doing). I'm thinking that we could provide the above in case man-db isn't available. Is there any way to auto-detect that? If not, how about putting this behind a flag? From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 03 09:39:14 2022 Received: (at 59631) by debbugs.gnu.org; 3 Dec 2022 14:39:14 +0000 Received: from localhost ([127.0.0.1]:51731 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1Tfd-0003vl-Pe for submit@debbugs.gnu.org; Sat, 03 Dec 2022 09:39:14 -0500 Received: from eggs.gnu.org ([209.51.188.92]:37780) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p1Tfb-0003vf-5o for 59631@debbugs.gnu.org; Sat, 03 Dec 2022 09:39:11 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p1TfV-0000e7-TF; Sat, 03 Dec 2022 09:39:05 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:References:In-Reply-To:Subject:To:From: Date; bh=fE4ACuVKfWKR33QMWJVM3wuuDDSDttSrcGwqT8/EujY=; b=YTCSBQrNfZhhpCl4QASK H7dl+8Gzti6vYxArk6104WDO28V/MZ6uymr58ixG/zD1bnNv8YJ7V0twr/gquZt/GFB7ajRn6Bsvv eNG9iLyfH0JK87C/F0xBIocWbISZBmwz3gkYrQQTGicqnHZcgH0I7v5B0oqgoouFXlwkGo8K0G5HD egPahDu1X0q1wSeUJuRDxHTsQvNOqiXUI4VEc8Xt8BeMyGMdpQwhkW8pW+YHXTTi12QxZCsDWrGB2 gDEQ17LtI5XB9ydEjLzQtwm+IdhXXx8D/u/uPpOb2NzZszAenvxRxCTUgHzphbxkfds/uFy3sp2SF KFK+W3jFrV8SvQ==; Received: from [2a0d:6fc2:4de0:4000:d0d7:f3d8:ae2c:a0f4] (helo=[IPv6:::1]) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p1TfV-0008DX-6Z; Sat, 03 Dec 2022 09:39:05 -0500 Date: Sat, 03 Dec 2022 16:39:02 +0200 From: Eli Zaretskii To: Stefan Kangas Subject: =?US-ASCII?Q?Re=3A_bug=2359631=3A_29=2E0=2E50=3B_=5BPATCH=5D_New_check?= =?US-ASCII?Q?-man_target_to_check_man_pages_for_errors?= User-Agent: K-9 Mail for Android In-Reply-To: References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> <83v8mvglk5.fsf@gnu.org> Message-ID: <5D781E9D-7C4E-45A9-A289-F8DBF7782034@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Autocrypt: addr=eliz@gnu.org; keydata= mQENBF+pf4UBCAC6vjkWLSAsQpe8YIGKLQzNOJx/IjGtCdFF8uzmO5jmME+SD8ROuJN+t5KXVw58 uzu75EFD0vHTY9e+udJ2gkpuy0NnzkFcbumdLLo2ERKCoSctZZRhzKXI5z5cHxCqW0B2ygHRrRLt oNlGID7bAgcgSViT1ptGqTXO7zGVu4Airok7dNzcPtHgns8GlR5YAFX0TvE6oGd0l2VPghNeVJKJ OjrbfhoDxl3ucFpqbqMH8z9HTLDOFpz8UaYYUdJMi3xX6vwTZxI2sM2RRVLUpZyllAkSMI4lln1O OgazM/62DJUs/rKIHKBnF6h3/qsJUjUYXaAHbrXY26mWllAd536lABEBAAG0I0VsaSBaYXJldHNr aWkgKGVsaXopIDxlbGl6QGdudS5vcmc+iQE4BBMBAgAiBQJfqX+FAhsDBgsJCAcDAgYVCAIJCgsE FgIDAQIeAQIXgAAKCRCRwSYvAeuNOYUQB/4/iIKKOG45ijNaRoTvmJJZMvj1S07WQxEm7c5SHEeE QbLOAxB9vESOV7sLueuN3oqEndtzyYt4x1WTSBmHFF7h5fcCMjBs41siOIp5Sj/xD0Bvaa0IKGCR SZ7PAo8Mq3wgajXpTpn9vxE2PmtzA8KdEE0K1+f9pVAfOpUIcCl44rIxLUW352XG0y7iz6c/O6LB 1deOKMiKFctKO7pBti1dJEm1ImewLH3H8uTbwspLOs3EB8xhsESxmTidnze68HX2jt+2EeMgCdki NU+LWbexQZPfIS7+ZmE06ll0v6+Jy7ZdTkCCRypKWTnW7pIFsq/p4kybV8O/kHSV6B4vvQBfuQEN BF+pf4UBCACvFrdx/m22lgObypSmSS4TNlNvQnMUorrMmp0U32hv5adt6CKXeMjk05F+GcIfVMrp xqMBn4sEUIXWhhogQJa9ZbWEP/HbS8XjMMbz0Q0Siaty9+DSspK/9u2GWKsz3uQzLCexIJtzmXvj AVmvoMCAU/F2t038ggygjYLRgyLRNLgbbartu2dMkvrfxRjheip60S4S3utOcwUf/qdoa1grNann CFluHr/ftXCeeuGB4H8iO0BXWNby6NZPizxJttx9gdcH8/OmDOJkXyRMTT/3sSem76CSOjfXcz7s aJlg680NQhG5TmuYERjJD4+U02K5RuqTsEnOuWeFy4p+/mslABEBAAGJATYEGAECAAkFAl+pf4UC GwwAIQkQkcEmLwHrjTkWIQTmyQKcNjrUHXh6jruRwSYvAeuNOejsB/9rVegsfEBSRLjeeYXyJrOf dme7BYpYsQCw2vGTnrJTGFQ9HM2zT9+wAENBHWjQPJOptJwo5w4xIbZgwJy0uIN3sV18xbCRSxX0 ZSk8GJG0PrQTCaf2xs0kqsShnkvqyo5QSyUlFUAG7m1o7NUhF95Q89oxGO8JyvR356kqNbzUn0Cq PxKyS42QfC8dyFNgVhVPbZp6aONnUwY5SbtCLJtZCBgvppI9XaBH41BDukSE4GgSLoYsSIGShg4h e+bGypAsGtQ9uwmryUi1gRrDgca3wFo/G0rbJn2ZKoLbGFZivWPVgAgd9/O5sLSPFznOdcRGxEA2 gk7A1ReaJ10PtQz0 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59631 Cc: 59631@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) On December 3, 2022 4:20:50 PM GMT+02:00, Stefan Kangas wrote: > Eli Zaretskii writes: >=20 > > AFAICT, the pipeline is simple: > > > > soelim FILE | preconv -e UTF-8 | groff -mandoc -Z -wall -wmac -Tutf8 = > /dev/null >=20 > My concern is that the command is more brittle in the face of changes, > and also all the extra "echo" stuff that man-db is doing (probably > because I don't understand what it's doing)=2E >=20 > I'm thinking that we could provide the above in case man-db isn't > available=2E Is there any way to auto-detect that? If not, how about > putting this behind a flag? >=20 Nah, just install your variant=2E It isn't worth the hassle to do anythin= g more complex=2E I have the command in my notes and will use it if and wh= en required=2E From debbugs-submit-bounces@debbugs.gnu.org Fri Dec 09 05:25:51 2022 Received: (at 59631-done) by debbugs.gnu.org; 9 Dec 2022 10:25:51 +0000 Received: from localhost ([127.0.0.1]:35128 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p3aZi-0005kD-TA for submit@debbugs.gnu.org; Fri, 09 Dec 2022 05:25:51 -0500 Received: from mail-oi1-f179.google.com ([209.85.167.179]:34651) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p3aZh-0005k7-4S for 59631-done@debbugs.gnu.org; Fri, 09 Dec 2022 05:25:49 -0500 Received: by mail-oi1-f179.google.com with SMTP id n205so4129467oib.1 for <59631-done@debbugs.gnu.org>; Fri, 09 Dec 2022 02:25:49 -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=WsDBg0CSUW6F96sU9Z2AOFxVCPTlPmmW6G9yuM/JlMk=; b=cj5TZk/hF/ZIoHqpoyRuI41J+k0dzEpyY8wi9YrJZQkg2KQ3Hp3LpB/pHIuyqmuJeE VjyVJb5t+7v6c27I4/6wJVwfQHQwCDTZ2tm0dIM8K7yiX2pSplH4xULTZbFeuBgcxWaC W6Dm5PbRxSLOik+hD/d9M3qlFDIhVUP0QJ5tJZlhLheWSkA74Vn+kxJTb0UY51Wtf+LO S2DTiV6UQgovhhBS16VRzzkFunDRIp6qInnuzZvHNFrXIwaTU0hr4pLiMY+cG9TQ2iGC pIjVCNs91/2uAfBKlsechc8gUB+8BuacsOt46zQcV+o6HoIcrYeRnVTOR3NeiVXkfwDH +R9w== 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=WsDBg0CSUW6F96sU9Z2AOFxVCPTlPmmW6G9yuM/JlMk=; b=NHs4fVqPgyxJFNRcEhKfCe1VMJ73940puvoaIuX4QLPqKZdTD5ij5/Q3VMum0kdVUl ILE4kqEPENcEbe4AIYzX61SWd2QU1Quu6LOODAXtZ9y7dzFz7mmB8MMmdzIGgv1ri9gZ fjjpNuBl19ykglwIl/0CSCE+s7CI/POIX0OUrLZpJ+2eBdXsHFYGyzCfyuD1pdVfO5jt OpKmRFEWCYdLaJ0lvZd116s8H5Z9uIgJXrnkp7aXsOsXR01Z0LiPapfaHIsAeEzTfH0q 5NB0hj56lwe8FrGa/ouGIV1YFRqgSPqSgGiMVO9WEOuhFS5VeZl0LM6UHnaSbxR0/MSx oMqA== X-Gm-Message-State: ANoB5pkYzQoRaRtOzPMJuWjYawxjD+vVH+fBoZ25LosDG+uFcQ5WcUVm nWEq14xqZ2xoD4viwNMu5tbIEpYACyMdS+qbHzQljsAG X-Google-Smtp-Source: AA0mqf4H8Zdg36taWnKX4D/58izKhQQWJ8j7N4UY7w5SwgXIB3H/AQ7JMYlAKgECVqP1JDL/1Z9cZRufB3IlFPuWyes= X-Received: by 2002:a05:6808:989:b0:35e:373e:226a with SMTP id a9-20020a056808098900b0035e373e226amr2790516oic.199.1670581543377; Fri, 09 Dec 2022 02:25:43 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Fri, 9 Dec 2022 02:25:43 -0800 From: Stefan Kangas In-Reply-To: <5D781E9D-7C4E-45A9-A289-F8DBF7782034@gnu.org> (Eli Zaretskii's message of "Sat, 03 Dec 2022 16:39:02 +0200") References: <83h6ykpfkn.fsf@gnu.org> <83cz98p8l8.fsf@gnu.org> <83zgcbnuom.fsf@gnu.org> <83v8mvglk5.fsf@gnu.org> <5D781E9D-7C4E-45A9-A289-F8DBF7782034@gnu.org> X-Hashcash: 1:20:221209:59631-done@debbugs.gnu.org::3/efDdIjmH14v7/M:0hL9 MIME-Version: 1.0 Date: Fri, 9 Dec 2022 02:25:43 -0800 Message-ID: Subject: Re: bug#59631: 29.0.50; [PATCH] New check-man target to check man pages for errors To: Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 59631-done Cc: 59631-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Eli Zaretskii writes: > Nah, just install your variant. It isn't worth the hassle to do > anything more complex. I have the command in my notes and will use it > if and when required. Thanks, pushed to emacs-29 (commit d3d9676bf8). Closing. From unknown Wed Sep 10 01:11:21 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 06 Jan 2023 12:24:08 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator