From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id b9ec183c for ; Tue, 3 Mar 2020 21:57:31 -0500 (EST) Received: from hekate.asta.kit.edu ([141.3.145.153] helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (envelope-from ) id 1j9KDw-0003Hy-Vk; Wed, 04 Mar 2020 03:57:30 +0100 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 1j9KDv-0004m3-KA; Wed, 04 Mar 2020 03:57:27 +0100 Received: from athene.asta.kit.edu ([141.3.145.60] helo=athene.usta.de) by donnerwolke.usta.de with esmtp (Exim 4.84_2) (envelope-from ) id 1j9KDL-0007kw-Qr; Wed, 04 Mar 2020 03:57:27 +0100 Received: from localhost (athene.usta.de [local]) by athene.usta.de (OpenSMTPD) with ESMTPA id df39af70; Wed, 4 Mar 2020 03:56:51 +0100 (CET) Date: Wed, 4 Mar 2020 03:56:51 +0100 From: Ingo Schwarze To: Michael Forney Cc: tech@mandoc.bsd.lv Subject: Re: [PATCH] Add POSIX.1-2017 to St macro Message-ID: <20200304025651.GB50848@athene.usta.de> References: <20200304021644.3512-1-mforney@mforney.org> X-Mailinglist: mandoc-tech Reply-To: tech@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200304021644.3512-1-mforney@mforney.org> User-Agent: Mutt/1.12.2 (2019-09-21) Hi Michael, Michael Forney wrote on Tue, Mar 03, 2020 at 06:16:44PM -0800: > Index: st.c > =================================================================== > RCS file: /cvs/mandoc/st.c,v > retrieving revision 1.16 > diff -u -r1.16 st.c > --- st.c 14 Dec 2018 01:18:26 -0000 1.16 > +++ st.c 4 Mar 2020 01:56:06 -0000 > @@ -37,6 +37,7 @@ > LINE("-p1003.1-2001", "IEEE Std 1003.1-2001 (\\(lqPOSIX.1\\(rq)") > LINE("-p1003.1-2004", "IEEE Std 1003.1-2004 (\\(lqPOSIX.1\\(rq)") > LINE("-p1003.1-2008", "IEEE Std 1003.1-2008 (\\(lqPOSIX.1\\(rq)") > +LINE("-p1003.1-2017", "IEEE Std 1003.1-2017 (\\(lqPOSIX.1\\(rq)") > LINE("-p1003.1", "IEEE Std 1003.1 (\\(lqPOSIX.1\\(rq)") > LINE("-p1003.1b", "IEEE Std 1003.1b (\\(lqPOSIX.1b\\(rq)") > LINE("-p1003.1b-93", "IEEE Std 1003.1b-1993 (\\(lqPOSIX.1b\\(rq)") No, absolutely not. That is not a new version of POSIX, it is merely the incorporation of a technical corrigendum. Manual pages ought to continue referncing -p1003.1-2008. In those very rare cases where the TC might require code changes, those code changes can usually be considered bug fixes but do not change how the related features are supposed to work and how they need to be documented. Even if a handful of manual pages need to reference the TC, for example to make it explicit that the program in questions conforms to some changed behaviour required by the TC, that doesn't require a dedicated macro. Such an unusual case ought to be described more explicitly if it really matters and not only by changing a number that most readers will almost certainly overlook. And i haven't even seen a single example yet where discussing the TC in a manual page might be required... Besides, this has already been discussed repeatedly. Yours, Ingo -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv