From unknown Sat Jun 21 05:16:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#62854: aclocal: Man page =?UTF-8?Q?=E2=80=9CName=E2=80=9D?= section should be revised to be conformant to the POSIX man specification Resent-From: Sebastian Carlos Original-Sender: "Debbugs-submit" Resent-CC: bug-automake@gnu.org Resent-Date: Sat, 15 Apr 2023 04:05:05 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 62854 X-GNU-PR-Package: automake X-GNU-PR-Keywords: To: 62854@debbugs.gnu.org X-Debbugs-Original-To: bug-automake@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.168153147926007 (code B ref -1); Sat, 15 Apr 2023 04:05:05 +0000 Received: (at submit) by debbugs.gnu.org; 15 Apr 2023 04:04:39 +0000 Received: from localhost ([127.0.0.1]:48026 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pnX9I-0006l5-GQ for submit@debbugs.gnu.org; Sat, 15 Apr 2023 00:04:38 -0400 Received: from lists.gnu.org ([209.51.188.17]:39926) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pnLah-0007Sg-20 for submit@debbugs.gnu.org; Fri, 14 Apr 2023 11:43:59 -0400 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 1pnLag-00052q-JJ for bug-automake@gnu.org; Fri, 14 Apr 2023 11:43:58 -0400 Received: from mail-lj1-x241.google.com ([2a00:1450:4864:20::241]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pnLae-0002NV-Nl for bug-automake@gnu.org; Fri, 14 Apr 2023 11:43:58 -0400 Received: by mail-lj1-x241.google.com with SMTP id a29so20100676ljq.0 for ; Fri, 14 Apr 2023 08:43:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1681487034; x=1684079034; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=ysp+T8vhWU0eOoKK3xITg+bDSItz/MgzXnE/JGyAaxE=; b=LP2XygnJcLhbGRf2oSVoU48Z5VPE0Zw39kjICevNzJIDAk+qnpdpRWxKLNUqMSKi4G l+HRwqo+7NbH1YL/06EKAaZH944qWpCjg5oWNEJxV4n5+nVkWj8l82jRb85wnEXG5aO0 YA10zgd1cDyBZh7XhkiLplTzJLYkblRmHl+4c/+IgDwVtaEmRs4qECZ5EaF5lBqk5qzD vAeOuYfSljGlNSinshD0ETfFDZPMkFF7XH3m5Z1PkwfQlgCuvLPZ+zRzmLD4uhxHIo9L m/uWHLFoFbUza7lR1yOYTx37gNCmHSA5TUJM8AKN+5IRHwmPfKxv1KJVtcDJKCVUCUqV QwXA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1681487034; x=1684079034; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=ysp+T8vhWU0eOoKK3xITg+bDSItz/MgzXnE/JGyAaxE=; b=Mk2KPF9Wnrwo1hyezDby2HcESS3/caqEwRh5qiJHDpnwxSDylmtSdBT8XY08DCrWjs DXfl+xpj73i/nSrlcJouKAUdUkyFsYCadO2cHdCvT30WU6N0j44oUmiJZP/faSiNqNI1 BPlve/xfWSG1r94DBxZk+F8m+qU19Qbi4jeGlekWreQmPfJ3+ZNZ2OAGv+/32tm6/xRe a4EtW4vPDOqlE9SJTA64wYRTWQuwBBU5avDIWDXyFYsgavRMdk/GY2lIQbsh9EFOtPXE D2jVwAl6XhV5fvfOmMt4qJGmFpRzHE0SakCgZX3yDfKllWwZ3LE8Hk9wPUEdkktVKnBf DP7w== X-Gm-Message-State: AAQBX9cqngAuw7K3GlFjJpBHQP3UUV4ksQyd9p2MyWfTe4jEWXRj6GLT KlyMwrivn1s56FLJqzCNydZxO5QW64YLsiIO3Nvrqx/zNF16Ag== X-Google-Smtp-Source: AKy350abuHtYQzO5QY+caWh/5b9Kzj5k2rs+5oNmxg+b3im7xCx7IsEYKaHcV5I6AEwoVIqT+SIJ4Q3u3+Eu9vEI4JM= X-Received: by 2002:a2e:9788:0:b0:2a7:b154:7ace with SMTP id y8-20020a2e9788000000b002a7b1547acemr1908678lji.5.1681487034339; Fri, 14 Apr 2023 08:43:54 -0700 (PDT) MIME-Version: 1.0 From: Sebastian Carlos Date: Fri, 14 Apr 2023 17:43:37 +0200 Message-ID: Content-Type: multipart/alternative; boundary="0000000000006057d905f94db57f" Received-SPF: pass client-ip=2a00:1450:4864:20::241; envelope-from=sebaaa1754@gmail.com; helo=mail-lj1-x241.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.1 (-) X-Mailman-Approved-At: Sat, 15 Apr 2023 00:04:26 -0400 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: 0.2 (/) --0000000000006057d905f94db57f Content-Type: text/plain; charset="UTF-8" Hello, Currently, the "Name" section of the aclocal man page reads "aclocal - manual page for aclocal 1.16.5" This is problematic for two reasons: - It is redundant, as there is no need to mention that it is a manual page. Also, the version is already available in the footer of the man page. - More importantly, the text is non-conformant to the POSIX man specification because the "name" sections is used to generate the "utilities summary database" (used for the "man -k" or the "apropos" command), which should be a "terse description of the purpose of the utility". The current text does not describe what aclocal does or how it can be used. POSIX specification for the man command: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html Thanks for your time. --0000000000006057d905f94db57f Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hello,

Currently, t= he "Name" section of the aclocal man page reads "aclocal - m= anual page for aclocal 1.16.5" This is problematic for two reasons:

- It is redundant, as there is no need to mention th= at it is a manual page. Also, the version is already available in the foote= r of the man page.
- More importantly, the text is non-conformant= to the POSIX man specification because the "name" sections is us= ed to generate the "utilities summary database" (used for the &qu= ot;man -k" or the "apropos" command), which should be a &quo= t;terse description of the purpose of the utility". The current text d= oes not describe what aclocal does or how it can be used.

POSIX specification for the man command:=C2=A0https://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html

Thanks for your time.
--0000000000006057d905f94db57f-- From debbugs-submit-bounces@debbugs.gnu.org Mon May 29 12:06:03 2023 Received: (at control) by debbugs.gnu.org; 29 May 2023 16:06:03 +0000 Received: from localhost ([127.0.0.1]:58937 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3fNi-00067V-Sw for submit@debbugs.gnu.org; Mon, 29 May 2023 12:06:03 -0400 Received: from frenzy.freefriends.org ([198.99.81.75]:38464 helo=freefriends.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3fNg-000675-3k for control@debbugs.gnu.org; Mon, 29 May 2023 12:06:01 -0400 X-Envelope-From: karl@freefriends.org X-Envelope-To: Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.7/8.14.7) with ESMTP id 34TG5xEY029992 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Mon, 29 May 2023 10:05:59 -0600 Received: (from apache@localhost) by freefriends.org (8.14.7/8.14.7/Submit) id 34TG5xEF029991; Mon, 29 May 2023 10:05:59 -0600 Date: Mon, 29 May 2023 10:05:59 -0600 Message-Id: <202305291605.34TG5xEF029991@freefriends.org> From: Karl Berry To: control@debbugs.gnu.org Subject: X-Spam-Score: 2.0 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: merge 62853 62854 Content analysis details: (2.0 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_HELO_PASS SPF: HELO matches SPF record -0.0 SPF_PASS SPF: sender matches SPF record 2.0 BLANK_SUBJECT Subject is present but empty X-Debbugs-Envelope-To: control 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 (+) merge 62853 62854 From unknown Sat Jun 21 05:16:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#62854: bug#62853: Man page =?UTF-8?Q?=E2=80=9CName=E2=80=9D?= section should be revised to be conformant to the POSIX man specification References: Resent-From: Karl Berry Original-Sender: "Debbugs-submit" Resent-CC: bug-automake@gnu.org Resent-Date: Tue, 30 May 2023 00:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 62854 X-GNU-PR-Package: automake X-GNU-PR-Keywords: To: sebaaa1754@gmail.com Cc: 62853@debbugs.gnu.org, 62854@debbugs.gnu.org Received: via spool by 62854-submit@debbugs.gnu.org id=B62854.168540817125467 (code B ref 62854); Tue, 30 May 2023 00:57:02 +0000 Received: (at 62854) by debbugs.gnu.org; 30 May 2023 00:56:11 +0000 Received: from localhost ([127.0.0.1]:59478 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3nek-0006cg-NE for submit@debbugs.gnu.org; Mon, 29 May 2023 20:56:10 -0400 Received: from frenzy.freefriends.org ([198.99.81.75]:47502 helo=freefriends.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3neg-0006cM-PV; Mon, 29 May 2023 20:56:09 -0400 X-Envelope-From: karl@freefriends.org Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.7/8.14.7) with ESMTP id 34U0u5TS015304 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 29 May 2023 18:56:05 -0600 Received: (from apache@localhost) by freefriends.org (8.14.7/8.14.7/Submit) id 34U0u5u4015303; Mon, 29 May 2023 18:56:05 -0600 Date: Mon, 29 May 2023 18:56:05 -0600 Message-Id: <202305300056.34U0u5u4015303@freefriends.org> From: Karl Berry In-Reply-To: X-Spam-Score: -0.0 (/) 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 (-) Hi Sebastian, Currently, the "Name" section of the automake man I just committed a change to set the Name section, as you suggested. We'll now have (based on the --help message): aclocal - Generate aclocal.m4 by scanning configure.ac automake - Generate Makefile.in files for configure from Makefile.am Thanks again for the report, Karl