Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 6 Jan 2025 23:46:37 GMT
From:      Warner Losh <imp@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: cfd8866818ab - main - cdefs.h: Add warning about defining __BSD_VISIBLE and friends
Message-ID:  <202501062346.506NkbV6045275@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=cfd8866818abb68fbfbffb925298c0b457cb32b5

commit cfd8866818abb68fbfbffb925298c0b457cb32b5
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2025-01-06 23:45:51 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2025-01-06 23:46:06 +0000

    cdefs.h: Add warning about defining __BSD_VISIBLE and friends
    
    Undefined things happen if users define these macros, be more explicit
    about documenting that.
    
    Sponsored by:           Netflix
---
 share/man/man9/cdefs.9 | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/share/man/man9/cdefs.9 b/share/man/man9/cdefs.9
index 2e6f1b440efb..4efce132d393 100644
--- a/share/man/man9/cdefs.9
+++ b/share/man/man9/cdefs.9
@@ -401,7 +401,8 @@ are also included.
 These macros are set by
 .Nm
 to control the visibility of different standards.
-Users should not use these, but they are documented here for developers.
+Users must not define these, and doing so will produced undefined results.
+They are documented here for developers working on system's header files.
 .Bl -column "---------------"
 .It Dv __XSI_VISIBLE Ta Restricts the visibility of XOPEN Single Unix Standard version.
 Possible values are 500, 600, 700 or 800, corresponding to Issue 5, 6, 7, or 8



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202501062346.506NkbV6045275>