From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=none autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 10531 invoked from network); 3 Oct 2021 18:49:24 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 3 Oct 2021 18:49:23 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 57fca80b for ; Sun, 3 Oct 2021 13:49:22 -0500 (EST) Received: from scc-mailout-kit-01.scc.kit.edu (scc-mailout-kit-01.scc.kit.edu [129.13.231.81]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 91591a1e for ; Sun, 3 Oct 2021 13:49:21 -0500 (EST) Received: from hekate.asta.kit.edu ([141.3.145.153] helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (envelope-from ) id 1mX6Y3-0005wI-QG; Sun, 03 Oct 2021 20:49:20 +0200 Received: from donnerwolke.asta.kit.edu ([141.3.145.61] helo=donnerwolke.usta.de) by hekate.usta.de with esmtp (Exim 4.92.2) (envelope-from ) id 1mX6Y3-0001FZ-EJ; Sun, 03 Oct 2021 20:49:19 +0200 Received: from login-1.asta.kit.edu ([141.3.145.72]) by donnerwolke.usta.de with esmtp (Exim 4.84_2) (envelope-from ) id 1mX6Y3-00056C-9y; Sun, 03 Oct 2021 20:49:19 +0200 Received: from schwarze by login-1.asta.kit.edu with local (Exim 4.92) (envelope-from ) id 1mX6Y3-0004dM-9C; Sun, 03 Oct 2021 20:49:19 +0200 Date: Sun, 3 Oct 2021 20:49:19 +0200 From: Ingo Schwarze To: Cameron Katri Cc: discuss@mandoc.bsd.lv Subject: Re: Specify man section name at runtime Message-ID: References: <20211003174918.nn45mg6rmuaou2fa@FreeBSDY540> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20211003174918.nn45mg6rmuaou2fa@FreeBSDY540> Hi Cameron, Cameron Katri wrote on Sun, Oct 03, 2021 at 01:49:18PM -0400: > I want to add the ability to specify the man section name I suspect you are talking about the volume titles (for example, "General Commands Manual", "System Calls Manual", etc.), not about section names (for example, "SYNOPSIS", "DESCRIPTION", "SEE ALSO", etc.). > at runtime, instead of at compile time in msec.in. Why? What is the use case requiring that? > But I wanted to see how I should implement it. > I was thinking as a setting in man.conf, Hard to judge without knowing what it is needed for, but at first sight, it does not look like something that system administrators would need to configure on a machine-by-machine basis. > or as a command line argument, That does not sound very convincing either. Why would any user type in long titles on the command line? > or both. When it comes to new features, less is usually more. A new feature needs a very good justification. Perfection isn't when nothing more can be added, but when nothing unimportant can be taken away. > I wanted to know if this is something you would be interested in > actually incorporating So far, given the total lack of any justification, no, i am not (yet) interested. If you can explain a very convincing use case, the level of interest might grow. > and what it's interface should look like before I start working > on anything. Before it is possible to even start considering user interface design for *any* feature, the critical question to consider is: what is the purpose of the feature? What will it be used for, and by which kinds of users? Yours, Ingo -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv