git: 7e98eae74037 - main - c(7): Utilise proper macros to pass mandoc's linter

From: Brooks Davis <brooks_at_FreeBSD.org>
Date: Mon, 04 Nov 2024 17:03:07 UTC
The branch main has been updated by brooks:

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

commit 7e98eae74037aa7987ca30ea8b7b11bec7d9cc0c
Author:     Faraz Vahedi <kfv@kfv.io>
AuthorDate: 2024-11-03 09:01:23 +0000
Commit:     Brooks Davis <brooks@FreeBSD.org>
CommitDate: 2024-11-04 16:40:35 +0000

    c(7): Utilise proper macros to pass mandoc's linter
    
    Reviewed by:    Graham Percival <gperciva@tarsnap.com>
    Pull Request:   https://github.com/freebsd/freebsd-src/pull/1507
    Signed-off-by: Faraz Vahedi <kfv@kfv.io>
---
 share/man/man7/c.7 | 68 ++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 48 insertions(+), 20 deletions(-)

diff --git a/share/man/man7/c.7 b/share/man/man7/c.7
index 97869fe0f8f2..7c180797d296 100644
--- a/share/man/man7/c.7
+++ b/share/man/man7/c.7
@@ -112,9 +112,12 @@ development of the language did not stop.
 .Pp
 The ISO C standard was later extended with an amendment as
 ISO/IEC 9899/AMD1 in 1995.
-This contained, for example, the wide-character support in <wchar.h> and
-<wctype.h>, and also restricted character set support via diagraphs and
-<iso646.h>.
+This contained, for example, the wide-character support in
+.In wchar.h
+and
+.In wctype.h ,
+and also restricted character set support via diagraphs and
+.In iso646.h .
 This amendment is usually referred to as C95.
 Two technical corrigenda were also published: Technical Corrigendum 1 as
 ISO/IEC 9899/COR1 in 1994 and Technical Corrigendum 2 as ISO/IEC 9899/COR2
@@ -130,18 +133,23 @@ The improvements include (but are not limited to) the following:
 .Bl -bullet -offset indent
 .It
 digraphs, trigraphs, and alternative spellings for the operators that
-use non-ISO646 characters in <iso646.h>
+use non-ISO646 characters in
+.In iso646.h
 .It
-extended multibyte and wide character library support in <wchar.h> and
-<wctype.h>
+extended multibyte and wide character library support in
+.In wchar.h
+and
+.In wctype.h
 .It
 variable length arrays
 .It
 flexible array members
 .It
-complex (and imaginary) number arithmetic support in <complex.h>
+complex (and imaginary) number arithmetic support in
+.In complex.h
 .It
-type-generic math macros in <tgmath.h>
+type-generic math macros in
+.In tgmath.h
 .It
 the long long int type and library functions
 .It
@@ -157,15 +165,24 @@ BCPL style single-line comments
 .It
 allow mixed declarations and code
 .It
-the vscanf family of functions in <stdio.h> and <wchar.h>
+the
+.Fn vscanf
+family of functions in
+.In stdio.h
+and
+.In wchar.h
 .It
 allow trailing comma in enum declaration
 .It
 inline functions
 .It
-the snprintf family of functions in <stdio.h>
+the
+.Fn snprintf
+family of functions in
+.In stdio.h
 .It
-boolean type and macros in <stdbool.h>
+boolean type and macros in
+.In stdbool.h
 .It
 empty macro arguments
 .It
@@ -173,7 +190,8 @@ _Pragma preprocessing operator
 .It
 __func__ predefined identifier
 .It
-va_copy macro in <stdarg.h>
+va_copy macro in
+.In stdarg.h
 .It
 additional strftime conversion specifiers
 .El
@@ -185,24 +203,34 @@ and ISO/IEC 9899:1999/COR3:2007.
 The improvements include (but are not limited to) the following:
 .Bl -bullet -offset indent
 .It
-support for multiple threads of execution and atomic operations in <threads.h>
-and <stdatomic.h>
+support for multiple threads of execution and atomic operations in
+.In threads.h
+and
+.In stdatomic.h
 .It
-additional floating-point characteristic macros in <float.h>
+additional floating-point characteristic macros in
+.In float.h
 .It
-querying and specifying alignment of objects in <stdalign.h> and <stdlib.h>
+querying and specifying alignment of objects in
+.In stdalign.h
+and
+.In stdlib.h
 .It
-Unicode character types and functions in <uchar.h>
+Unicode character types and functions in
+.In uchar.h
 .It
 type-generic expressions
 .It
-static assertions in <assert.h>
+static assertions in
+.In assert.h
 .It
 anonymous structures and unions
 .It
-remove the gets function from <stdio.h>
+remove the gets function from
+.In stdio.h
 .It
-add the aligned_alloc, at_quick_exit, and quick_exit functions in <stdlib.h>
+add the aligned_alloc, at_quick_exit, and quick_exit functions in
+.In stdlib.h
 .El
 .Pp
 C11 was later superseded by ISO/IEC 9899:2018, also known as C17 which was