Re: [PATCH v3 5/6] man2/chmod.2: add C digit separators to clarify POSIX feature release dates and long numeric digit strings

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 2023-02-18 10:42, Tom Schwindl wrote:
On Wed Feb 15, 2023 at 10:10 PM CET, Alejandro Colomar wrote:
On 2/15/23 21:17, Brian Inglis wrote:
---
  man2/chmod.2 | 30 +++++++++++++++---------------
  1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/man2/chmod.2 b/man2/chmod.2
index 8b5db74ed7e3..674b54368314 100644
--- a/man2/chmod.2
+++ b/man2/chmod.2
@@ -37,7 +37,7 @@ Feature Test Macro Requirements for glibc (see
  .nf
  .BR fchmod ():
      Since glibc 2.24:
-        _POSIX_C_SOURCE >= 199309L
+        _POSIX_C_SOURCE >= 1993\[aq]09L

Please keep all POSIX dates in a single separate patch
(unless there's another reason that I'm not seeing).

As long as I'm not completely lost, those values are often passed on the command
line via `-D`. Wouldn't a random \[aq] interfere with shell quoting and result in
hard to find bugs and unexpected bahavior? So is it really a good idea to present
those values in such a way in the manpage? Or am I simply underestimating the
intelligence of the readers? :-)

Hi Tom,

As \[aq] renders as aprostrophe/single-quote "'" the value can be "1993'09L" quoted if required.

I would expect these values to most often be set and tested in headers and sources, mainly from systems, compilers, or libraries, to indicate support of certain features or enable their interfaces to be defined.

I would expect these to be rarely set nowadays in hopes of enabling otherwise disabled features required to build a package or application, more likely to change or disable undesired interfaces, and instead expect them to be configured by compiler options e.g. -std=gnu23 and/or in library headers, and tested by application or package sources.

--
Take care. Thanks, Brian Inglis			Calgary, Alberta, Canada

La perfection est atteinte			Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter	not when there is no more to add
mais lorsqu'il n'y a plus rien à retirer	but when there is no more to cut
			-- Antoine de Saint-Exupéry



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux