From unknown Fri Jun 20 05:37:51 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#62854 <62854@debbugs.gnu.org> To: bug#62854 <62854@debbugs.gnu.org> Subject: Status: aclocal: Man page =?UTF-8?Q?=E2=80=9CName=E2=80=9D?= section should be revised to be conformant to the POSIX man specification Reply-To: bug#62854 <62854@debbugs.gnu.org> Date: Fri, 20 Jun 2025 12:37:51 +0000 retitle 62854 aclocal: Man page =E2=80=9CName=E2=80=9D section should be re= vised to be conformant to the POSIX man specification reassign 62854 automake submitter 62854 Sebastian Carlos severity 62854 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 15 00:04:39 2023 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: Subject: =?UTF-8?Q?aclocal=3A_Man_page_=E2=80=9CName=E2=80=9D_section_should_be_revis?= =?UTF-8?Q?ed_to_be_conformant_to_the_POSIX_man_specification?= To: bug-automake@gnu.org 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-Debbugs-Envelope-To: submit 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 debbugs-submit-bounces@debbugs.gnu.org Mon May 29 20:56:11 2023 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 To: sebaaa1754@gmail.com Subject: Re: bug#62853: Man page “Name” section should be revised to be conformant to the POSIX man specification In-Reply-To: X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 62854 Cc: 62853@debbugs.gnu.org, 62854@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 (-) 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 From unknown Fri Jun 20 05:37:51 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 27 Jun 2023 11:24:07 +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