Skip to contentSkip to conversation

fts.3, div_t.3type: ffix

PATCH In review G. Branden Robinson 2 participants 2 messages Jan 16, 2024 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/4 fts.3, div_t.3type: ffix

Break lines containing a parametric prefix to a man page name into two lines, using distinct font alternation macros and the \c escape sequence to "connect" the output. This prepares for adoption of the MR man(7) macro in groff 1.23.0.

The style seen here assumes that the typeface used for man page names is bold, which is ahistorical and which the MR feature makes configurable. It might be better to recast this shorthand into English.

---
 man3/fts.3           | 12 ++++++++----
 man3type/div_t.3type |  3 ++-
 2 files changed, 10 insertions(+), 5 deletions(-)
man3/fts.3 +8 -4
index ae2fdfcbc..d2c520450 100644
@@ -187,7 +187,8 @@ .SH DESCRIPTION
 .TP
 .B FTS_NS
 A file for which no
-.RB [ l ] stat (2)
+.RB [ l ]\c
+.BR stat (2)
 information was available.
 The contents of the
 .I fts_statp
@@ -198,7 +199,8 @@ .SH DESCRIPTION
 .TP
 .B FTS_NSOK
 A file for which no
-.RB [ l ] stat (2)
+.RB [ l ]\c
+.BR stat (2)
 information was requested.
 The contents of the
 .I fts_statp
@@ -329,7 +331,8 @@ .SH DESCRIPTION
 .TP
 .I fts_statp
 A pointer to
-.RB [ l ] stat (2)
+.RB [ l ]\c
+.BR stat (2)
 information for the file.
 .\" .El
 .P
@@ -754,7 +757,8 @@ .SH ERRORS
 .BR opendir (3),
 .BR readdir (3),
 and
-.RB [ l ] stat (2).
+.RB [ l ]\c
+.BR stat (2).
 .P
 In addition,
 .BR fts_children (),
man3type/div_t.3type +2 -1
index 857dae17e..7abbb7616 100644
@@ -40,7 +40,8 @@ .SH SYNOPSIS
 .SH DESCRIPTION
 .RI [[ l ] l ] div_t
 is the type of the value returned by the
-.RB [[ l ] l ] div (3)
+.RB [[ l ] l ]\c
+.BR div (3)
 function.
 .P
 .I imaxdiv_t
Signature · 1 line
2.30.2
#1 lore raw

Hi Branden,

Quoted 10 lines · G. Branden Robinson

Break lines containing a parametric prefix to a man page name into two lines, using distinct font alternation macros and the \c escape sequence to "connect" the output. This prepares for adoption of the MR man(7) macro in groff 1.23.0.

The style seen here assumes that the typeface used for man page names is bold, which is ahistorical and which the MR feature makes configurable. It might be better to recast this shorthand into English.

I've applied patches 1, 2, and 4 from this set.

Have a lovely day,
Alex

Quoted 66 lines
---
 man3/fts.3           | 12 ++++++++----
 man3type/div_t.3type |  3 ++-
 2 files changed, 10 insertions(+), 5 deletions(-)
man3/fts.3 +8 -4
index ae2fdfcbc..d2c520450 100644
@@ -187,7 +187,8 @@ .SH DESCRIPTION
 .TP
 .B FTS_NS
 A file for which no
-.RB [ l ] stat (2)
+.RB [ l ]\c
+.BR stat (2)
 information was available.
 The contents of the
 .I fts_statp
@@ -198,7 +199,8 @@ .SH DESCRIPTION
 .TP
 .B FTS_NSOK
 A file for which no
-.RB [ l ] stat (2)
+.RB [ l ]\c
+.BR stat (2)
 information was requested.
 The contents of the
 .I fts_statp
@@ -329,7 +331,8 @@ .SH DESCRIPTION
 .TP
 .I fts_statp
 A pointer to
-.RB [ l ] stat (2)
+.RB [ l ]\c
+.BR stat (2)
 information for the file.
 .\" .El
 .P
@@ -754,7 +757,8 @@ .SH ERRORS
 .BR opendir (3),
 .BR readdir (3),
 and
-.RB [ l ] stat (2).
+.RB [ l ]\c
+.BR stat (2).
 .P
 In addition,
 .BR fts_children (),
man3type/div_t.3type +2 -1
index 857dae17e..7abbb7616 100644
@@ -40,7 +40,8 @@ .SH SYNOPSIS
 .SH DESCRIPTION
 .RI [[ l ] l ] div_t
 is the type of the value returned by the
-.RB [[ l ] l ] div (3)
+.RB [[ l ] l ]\c
+.BR div (3)
 function.
 .P
 .I imaxdiv_t
Signature · 1 line
2.30.2
Signature · 2 lines
<https://www.alejandro-colomar.es/>
Looking for a remote C programming job at the moment.