From unknown Sat Jun 21 05:07:50 2025 X-Loop: help-debbugs@gnu.org Subject: 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 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 62853 X-GNU-PR-Package: automake X-GNU-PR-Keywords: To: 62853@debbugs.gnu.org X-Debbugs-Original-To: bug-automake@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.168153146825986 (code B ref -1); Sat, 15 Apr 2023 04:05:05 +0000 Received: (at submit) by debbugs.gnu.org; 15 Apr 2023 04:04:28 +0000 Received: from localhost ([127.0.0.1]:48024 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pnX9H-0006l2-Q1 for submit@debbugs.gnu.org; Sat, 15 Apr 2023 00:04:28 -0400 Received: from lists.gnu.org ([209.51.188.17]:39928) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pnLTp-0007GY-OQ for submit@debbugs.gnu.org; Fri, 14 Apr 2023 11:36:54 -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 1pnLTp-0003po-DR for bug-automake@gnu.org; Fri, 14 Apr 2023 11:36:53 -0400 Received: from mail-lf1-x142.google.com ([2a00:1450:4864:20::142]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pnLTn-0000qq-Jt for bug-automake@gnu.org; Fri, 14 Apr 2023 11:36:53 -0400 Received: by mail-lf1-x142.google.com with SMTP id x4so3996697lfr.8 for ; Fri, 14 Apr 2023 08:36:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1681486609; x=1684078609; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=kS6+hxt9/hC1wrKrXknsk0SdkRpjg6Bv6GAAzb1rjDI=; b=kqONfZtJ5LTNoQw5c+2hhk0876FIW2hF11i0uCsAl/dfTXB0tCZYbzav+ZeqsHgQgi wnTpX56B036qMb+mraBNlG3OUACVPhHdn4ilTFHptZF6B3CbdbQeDxSqWfnGE0s0SORG U/CJGEwO1xIeqkbFEScRhZ+tshGVp6nCz7erP2JDZh2oOEnChccSr6U0I8P1dTUm/GhE C5WWN2NmkeNUpDko8L6vJnl7egWI3cgX3odG/Tq14C4h/HaVQmQ03iP0OGS3dfgkGbsP 8Nl469bLJ5ra9/xGmGrsRfqkBbjZDffaL1VIuyX/3XfpO7iF0u0WZ6aqF85dxvw2rkRQ GhoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1681486609; x=1684078609; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=kS6+hxt9/hC1wrKrXknsk0SdkRpjg6Bv6GAAzb1rjDI=; b=bWddjmxV7/KEK+rUM+8EY2nq8t3B+rl98emjeKxUnt9T68n5x6M/T04Har3VAHY/Ei ga9YneUOyn3BZ43x/OvjVro6CLNJ9h44jh3toc6Ex6ihYJN2PKFJUyjJ0ug3eJOD1f36 SgxiaDB/89zHdqrb7puZv7S9RbaXOwDQiN1ArynFeVaInTFNWMFcQA+yYQTun+by7AGv fsBnBIBQ8YO1sUwgVWly2f9ZNuEHvkWYXgdPxOBo1p755bAaC5N8AK8piU5FJ543qbIo qhr9Z7X9c8aJqt+FbMYmlI9SdLw4mTdfxInHqMcuBZbjg4LUyCEKXyj9O45e5ahaO33r SLcQ== X-Gm-Message-State: AAQBX9dj8rZrZQ7VAOE2C2gyS0/W4f68yhZzQr903Od+Gctkch2HfEqp DgM1LUZ+qyWRKLGNrQ5tzCD1f+BtXiS8/OARngnX6MPJ2DymCw== X-Google-Smtp-Source: AKy350akaXk5VZZxfmrkMeRBLZssYxGa9Vd20cY7tEApjWte4/54rK9litUxeTRKqZ1BB26LY2JL7am2KXww/P+0isc= X-Received: by 2002:ac2:5de2:0:b0:4db:2425:5d11 with SMTP id z2-20020ac25de2000000b004db24255d11mr2060779lfq.5.1681486608604; Fri, 14 Apr 2023 08:36:48 -0700 (PDT) MIME-Version: 1.0 From: Sebastian Carlos Date: Fri, 14 Apr 2023 17:36:31 +0200 Message-ID: Content-Type: multipart/alternative; boundary="00000000000000208405f94d9c43" Received-SPF: pass client-ip=2a00:1450:4864:20::142; envelope-from=sebaaa1754@gmail.com; helo=mail-lf1-x142.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: -2.1 (--) --00000000000000208405f94d9c43 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hello, Currently, the "Name" section of the automake man page reads "automake - manual page for automake 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 automake does or how it can be used. I suggest that the =E2=80=9CName=E2=80=9D section should be changed to some= thing like =E2=80=9Cautomake - Generate Makefile.in files from Makefile.am files=E2=80= =9D. This would be more informative and compliant with the POSIX standard. POSIX specification for the man command: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html Thanks for your time. --00000000000000208405f94d9c43 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hello,

Currently, t= he "Name" section of the automake man page reads "automake -= manual page for automake 1.16.5." This is problematic for two reasons= :

- It is redundant, as there is no need to mentio= n that it is a manual page. Also, the version is already available in the f= ooter of the man page.
- More importantly, the text is non-confor= mant to the POSIX man specification because the "name" sections i= s 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 te= xt does not describe what automake does or how it can be used.
I suggest that the =E2=80=9CName=E2=80=9D section should be ch= anged to something like =E2=80=9Cautomake - Generate Makefile.in files from= Makefile.am files=E2=80=9D. This would be more informative and compliant w= ith the POSIX standard.

POSIX specification fo= r the man command:=C2=A0https://pubs.opengroup.org/onlinepubs/96999197= 99/utilities/man.html

Thanks for your time.
--00000000000000208405f94d9c43-- From unknown Sat Jun 21 05:07:50 2025 X-Loop: help-debbugs@gnu.org Subject: 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: Sun, 16 Apr 2023 21:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 62853 X-GNU-PR-Package: automake X-GNU-PR-Keywords: To: sebaaa1754@gmail.com Cc: 62853@debbugs.gnu.org Received: via spool by 62853-submit@debbugs.gnu.org id=B62853.168167933215625 (code B ref 62853); Sun, 16 Apr 2023 21:09:02 +0000 Received: (at 62853) by debbugs.gnu.org; 16 Apr 2023 21:08:52 +0000 Received: from localhost ([127.0.0.1]:52600 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1po9cB-00043w-Nz for submit@debbugs.gnu.org; Sun, 16 Apr 2023 17:08:51 -0400 Received: from frenzy.freefriends.org ([198.99.81.75]:44344 helo=freefriends.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1po9c9-00043o-8j for 62853@debbugs.gnu.org; Sun, 16 Apr 2023 17:08:49 -0400 X-Envelope-From: karl@freefriends.org Received: from freefriends.org (frenzy.freefriends.org [198.99.81.75]) by freefriends.org (8.14.7/8.14.7) with ESMTP id 33GL8lNu020443 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Sun, 16 Apr 2023 15:08:48 -0600 Received: (from apache@localhost) by freefriends.org (8.14.7/8.14.7/Submit) id 33GL8lZM020442; Sun, 16 Apr 2023 15:08:47 -0600 Date: Sun, 16 Apr 2023 15:08:47 -0600 Message-Id: <202304162108.33GL8lZM020442@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 (-) Currently, the "Name" section Thanks for the report on this and aclocal's man pages. Agreed they should be fixed. Hopefully we can do that for the next release. --best, karl. 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:07:50 2025 X-Loop: help-debbugs@gnu.org Subject: 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:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 62853 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 62853-submit@debbugs.gnu.org id=B62853.168540817125474 (code B ref 62853); Tue, 30 May 2023 00:57:01 +0000 Received: (at 62853) by debbugs.gnu.org; 30 May 2023 00:56:11 +0000 Received: from localhost ([127.0.0.1]:59480 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3nel-0006ci-1X for submit@debbugs.gnu.org; Mon, 29 May 2023 20:56:11 -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 From unknown Sat Jun 21 05:07:50 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Sebastian Carlos Subject: bug#62853: closed (Re: 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) Message-ID: References: <202305300056.34U0u5u4015303@freefriends.org> X-Gnu-PR-Message: they-closed 62853 X-Gnu-PR-Package: automake Reply-To: 62853@debbugs.gnu.org Date: Tue, 30 May 2023 00:57:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1685408222-25561-1" This is a multi-part message in MIME format... ------------=_1685408222-25561-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #62853: Man page =E2=80=9CName=E2=80=9D section should be revised to be con= formant to the POSIX man specification which was filed against the automake package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 62853@debbugs.gnu.org. --=20 62853: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D62853 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1685408222-25561-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 62853-done) by debbugs.gnu.org; 30 May 2023 00:56:12 +0000 Received: from localhost ([127.0.0.1]:59484 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3nel-0006cy-Pp for submit@debbugs.gnu.org; Mon, 29 May 2023 20:56:12 -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: 62853-done 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 ------------=_1685408222-25561-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 15 Apr 2023 04:04:28 +0000 Received: from localhost ([127.0.0.1]:48024 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pnX9H-0006l2-Q1 for submit@debbugs.gnu.org; Sat, 15 Apr 2023 00:04:28 -0400 Received: from lists.gnu.org ([209.51.188.17]:39928) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pnLTp-0007GY-OQ for submit@debbugs.gnu.org; Fri, 14 Apr 2023 11:36:54 -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 1pnLTp-0003po-DR for bug-automake@gnu.org; Fri, 14 Apr 2023 11:36:53 -0400 Received: from mail-lf1-x142.google.com ([2a00:1450:4864:20::142]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pnLTn-0000qq-Jt for bug-automake@gnu.org; Fri, 14 Apr 2023 11:36:53 -0400 Received: by mail-lf1-x142.google.com with SMTP id x4so3996697lfr.8 for ; Fri, 14 Apr 2023 08:36:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1681486609; x=1684078609; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=kS6+hxt9/hC1wrKrXknsk0SdkRpjg6Bv6GAAzb1rjDI=; b=kqONfZtJ5LTNoQw5c+2hhk0876FIW2hF11i0uCsAl/dfTXB0tCZYbzav+ZeqsHgQgi wnTpX56B036qMb+mraBNlG3OUACVPhHdn4ilTFHptZF6B3CbdbQeDxSqWfnGE0s0SORG U/CJGEwO1xIeqkbFEScRhZ+tshGVp6nCz7erP2JDZh2oOEnChccSr6U0I8P1dTUm/GhE C5WWN2NmkeNUpDko8L6vJnl7egWI3cgX3odG/Tq14C4h/HaVQmQ03iP0OGS3dfgkGbsP 8Nl469bLJ5ra9/xGmGrsRfqkBbjZDffaL1VIuyX/3XfpO7iF0u0WZ6aqF85dxvw2rkRQ GhoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1681486609; x=1684078609; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=kS6+hxt9/hC1wrKrXknsk0SdkRpjg6Bv6GAAzb1rjDI=; b=bWddjmxV7/KEK+rUM+8EY2nq8t3B+rl98emjeKxUnt9T68n5x6M/T04Har3VAHY/Ei ga9YneUOyn3BZ43x/OvjVro6CLNJ9h44jh3toc6Ex6ihYJN2PKFJUyjJ0ug3eJOD1f36 SgxiaDB/89zHdqrb7puZv7S9RbaXOwDQiN1ArynFeVaInTFNWMFcQA+yYQTun+by7AGv fsBnBIBQ8YO1sUwgVWly2f9ZNuEHvkWYXgdPxOBo1p755bAaC5N8AK8piU5FJ543qbIo qhr9Z7X9c8aJqt+FbMYmlI9SdLw4mTdfxInHqMcuBZbjg4LUyCEKXyj9O45e5ahaO33r SLcQ== X-Gm-Message-State: AAQBX9dj8rZrZQ7VAOE2C2gyS0/W4f68yhZzQr903Od+Gctkch2HfEqp DgM1LUZ+qyWRKLGNrQ5tzCD1f+BtXiS8/OARngnX6MPJ2DymCw== X-Google-Smtp-Source: AKy350akaXk5VZZxfmrkMeRBLZssYxGa9Vd20cY7tEApjWte4/54rK9litUxeTRKqZ1BB26LY2JL7am2KXww/P+0isc= X-Received: by 2002:ac2:5de2:0:b0:4db:2425:5d11 with SMTP id z2-20020ac25de2000000b004db24255d11mr2060779lfq.5.1681486608604; Fri, 14 Apr 2023 08:36:48 -0700 (PDT) MIME-Version: 1.0 From: Sebastian Carlos Date: Fri, 14 Apr 2023 17:36:31 +0200 Message-ID: Subject: =?UTF-8?Q?Man_page_=E2=80=9CName=E2=80=9D_section_should_be_revised_to_be_?= =?UTF-8?Q?conformant_to_the_POSIX_man_specification?= To: bug-automake@gnu.org Content-Type: multipart/alternative; boundary="00000000000000208405f94d9c43" Received-SPF: pass client-ip=2a00:1450:4864:20::142; envelope-from=sebaaa1754@gmail.com; helo=mail-lf1-x142.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: -2.1 (--) --00000000000000208405f94d9c43 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hello, Currently, the "Name" section of the automake man page reads "automake - manual page for automake 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 automake does or how it can be used. I suggest that the =E2=80=9CName=E2=80=9D section should be changed to some= thing like =E2=80=9Cautomake - Generate Makefile.in files from Makefile.am files=E2=80= =9D. This would be more informative and compliant with the POSIX standard. POSIX specification for the man command: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html Thanks for your time. --00000000000000208405f94d9c43 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hello,

Currently, t= he "Name" section of the automake man page reads "automake -= manual page for automake 1.16.5." This is problematic for two reasons= :

- It is redundant, as there is no need to mentio= n that it is a manual page. Also, the version is already available in the f= ooter of the man page.
- More importantly, the text is non-confor= mant to the POSIX man specification because the "name" sections i= s 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 te= xt does not describe what automake does or how it can be used.
I suggest that the =E2=80=9CName=E2=80=9D section should be ch= anged to something like =E2=80=9Cautomake - Generate Makefile.in files from= Makefile.am files=E2=80=9D. This would be more informative and compliant w= ith the POSIX standard.

POSIX specification fo= r the man command:=C2=A0https://pubs.opengroup.org/onlinepubs/96999197= 99/utilities/man.html

Thanks for your time.
--00000000000000208405f94d9c43-- ------------=_1685408222-25561-1-- From unknown Sat Jun 21 05:07:50 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Sebastian Carlos Subject: bug#62854: closed (Re: 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) Message-ID: References: <202305300056.34U0u5u4015303@freefriends.org> X-Gnu-PR-Message: they-closed 62854 X-Gnu-PR-Package: automake Reply-To: 62854@debbugs.gnu.org Date: Tue, 30 May 2023 00:57:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1685408223-25561-3" This is a multi-part message in MIME format... ------------=_1685408223-25561-3 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #62853: aclocal: Man page =E2=80=9CName=E2=80=9D section should be revised = to be conformant to the POSIX man specification which was filed against the automake package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 62854@debbugs.gnu.org. --=20 62853: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D62853 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1685408223-25561-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 62853-done) by debbugs.gnu.org; 30 May 2023 00:56:12 +0000 Received: from localhost ([127.0.0.1]:59484 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1q3nel-0006cy-Pp for submit@debbugs.gnu.org; Mon, 29 May 2023 20:56:12 -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: 62853-done 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 ------------=_1685408223-25561-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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-- ------------=_1685408223-25561-3--